Copper PDF

Microsoft社のクラウド環境であるWindows AzureでCopper PDFを動作させる方法を解説します。

Azure環境での構成

Azureでは仮想環境上に「ロール」と呼ばれる複数のプログラム実行環境を配置することができます。ロールの種類にはASP.NET, PHP等、Internet Information Server (IIS)のウェブアプリケーション実行環境である「Webロール」、バックグラウンドの処理などを行う「Workerロール」、両方の用途に使える「VMロール」があり、Copper PDFはそのうちどのロールでも動かすことができます。

ここでは、WebロールでCopper PDFを動作させ、非クラウド環境と同様にlocalhostへのソケット通信によりウェブアプリケーションからCopper PDFの機能を呼び出す方法を解説します。

なお、Azure環境でサーブレット/JSPを動作させる場合は、Workerロールでアプリケーションサーバー(Tomcat, Jetty等)を起動する方法が一般的ですが、この場合はWebロールがWorkerロールに変わるだけで、やり方はほとんど同じです。

プロジェクトの準備

次のソフトウェアが必要になります。

• Copper PDF 3.0.0 以降 (ZIPアーカイブ)
• Windows用のJava実行環境(JRE,64ビット版を推奨)

また、Windows Azureの開発サイトから次のものを入手してください。

• Windows Azure のサブスクリプション
• Windows Azure SDKおよびWindows Azure Tooks for Microsoft Visual Studio

@REM unzip JRE
cscript /B /Nologo utilunzip.vbs copperjre6.zip .

@REM unzip CopperPDF
cscript /B /Nologo utilunzip.vbs coppercopper-pdf-3_0_1.zip .

cd CopperPDF
start ..jre6binjava.exe -Duser.home=. -Djava.util.logging.config.file=conf/logging.properties -Djp.cssj.boot.lib=lib:jetty/lib -Djp.cssj.plugin.lib=plugins -Djp.cssj.boot.main=jp.cssj.copper.Main -Djp.cssj.driver.default=conf/profiles/default.properties -Djp.cssj.copper.config=conf -cp lib/boot.jar jp.cssj.boot.Main -start

アプリケーションの実行

アプリケーションをクラウドに配備するために、Solution ExplorerのAzureCopperを右クリックしてメニューからPublish…を選択してください。最初は証明書(Credentials)の設定が必要です。メニューから<Add…>を選択してください。

表示されたダイアログの1.のメニューで<Create…>を選択し、証明書を追加してください。

WindowsAzure管理ポータル(windows.azure.com)にアクセスし、管理証明書を追加してください。証明書ファイルは上のダイアログ2.のCopy the full pathでクリップボードにコピーされるファイルパスにあるものを使います。上記ダイアログの3.には以下の画面で表示されるサブスクリプションIDをコピーしてください。

Publishを実行して、アプリケーションの配備が終わるまで３０～６０分ほどかかります。

以下の画面のDNS名のアドレスにブラウザでアクセスすると、サンプルアプリケーションが表示されます。

サンプルアプリケーションの解説

ServiceDefinition.csdefにはInterrole Communicationとスタートアップコマンドの設定がされています。

以下の設定は、スタートアップコマンドとしてstartup.cmdを実行するためのものです。

    <Startup>
      <Task commandLine="utilstartup.cmd" executionContext="elevated" taskType="simple">
      </Task>
    </Startup>

startup.cmdではZIPファイルを展開するためのスクリプト(unzip.vbs)を使用して、必要なソフトウェアを仮想環境上に展開します。最後に、展開されたJREを使ってCopper PDFを起動しています。

あとは http://localhost:8097/ で起動しているCopper PDFに HTTP/RESTインターフェースを利用してウェブアプリケーションからアクセスしています。

ライセンスについて

クラウド環境では実際に動作するサーバーの台数が不確定となるため、クラウド環境向けのライセンスをお求め下さい。詳しくはこちらのフォームからお問い合わせください。

WorkerロールでCopper PDFを動作させる構成（参考）

Copper PDFをWorkerロールで動作させ、WebRoleから呼び出す構成も可能です。この場合、異なるロール間での通信(Interrole Communication)を行うための設定の必要があります。

２つのロールを使う場合のサンプルプログラムはこちらからダウンロードしてください。

こちらのサンプルではServiceDefinition.csdefにInterrole Communicationの設定をしています。

以下は、8097ポートへTCPプロトコルをInterrole Communicationに使用するための設定です。8097ポートはCopper PDFのHTTP/RESTインターフェースのデフォルトのポートです。

    <Endpoints>
      <InternalEndpoint name="CopperPDF" protocol="tcp" port="8097"/>
    </Endpoints>

WebロールのDefault.aspxは、Copper PDFにアクセスするサンプルのサーバーページです。クラウド環境で実行する場合、Webロールから見たWorkerロール上のCopper PDFは一般的にlocalhostにはありません。Default.aspx.csの以下の関数はWorkerロールのアドレスを取得するためのものです。このアドレスが、Webロールから見たCopper PDFのアドレスとなります。

        public string getCopperPDF()
        {
            RoleInstanceEndpoint[] endpoints =
                RoleEnvironment.Roles["WorkerRole1"].Instances.Select(
                    i => i.InstanceEndpoints["CopperPDF"]).ToArray();
            Random r = new Random(DateTime.Now.Millisecond);
            RoleInstanceEndpoint ep = endpoints[r.Next(endpoints.Count() - 1)];
            return String.Format("http://{0}/transcode", ep.IPEndpoint);
        }