AMIを使用してONLYOFFICE Docsデベロッパー版をデプロイする
はじめに
今すぐ、ONLYOFFICE Docsのデベロッパー版インスタンスを、AWS Marketplaceで利用可能なONLYOFFICE Amazon Machine Imageを使用して、Amazon Web Servicesクラウドインフラストラクチャ上で簡単に起動できます。
Amazon Machine Image (AMI)は、AWSプライベートクラウド内の仮想サーバーであるインスタンスを簡単に起動できるようにする、事前構成済みのテンプレートです。
ONLYOFFICE Docs デベロッパー版 AMIには、オペレーティングシステムとソフトウェア自体、さらにストレージボリュームを含むすべての必要なコンポーネントが含まれており、Linux（CentOS）上で動作する仮想サーバーにウェブオフィスを展開できます。
ONLYOFFICE Docsのデベロッパー版インスタンスを起動したら、ONLYOFFICE Docsを自社のSaaSまたはオンプレミスソリューションと統合できます。ライセンスにより、オンラインエディターを自社ブランドの一部としてエンドユーザーに提供することも可能です。
ステップ 1. 必要なONLYOFFICE AMIを選択し、ソリューションにサブスクライブする
既存のAWSアカウントにログインするか、新しいアカウントにサインアップして、AWS Marketplaceにアクセスします。
ONLYOFFICE Docs デベロッパー版ソリューションを見つけて、必要なインスタンスタイプ（250、500、または1000接続用）を選択します。接続数とは、同時に編集可能なドキュメントのブラウザタブの数を指します。1つのドキュメントが2人のユーザーによって開かれている場合、2つのタブで開かれているため、2つの同時接続となります。最大値に達すると、次のドキュメントは読み取り専用モードで開かれます。
製品概要ページでは、ソフトウェア機能の説明を読むことができます。
価格タブに切り替えて、インスタンスのパラメータに依存する価格の詳細を確認します：
- 必要に応じて、インスタンスを起動するリージョンを変更します。最寄りのリージョンを選択することをお勧めします。デフォルトでは米国東部（バージニア北部）が選択されています。
- 提供オプションメニューでは、64ビット（x86）Amazon Machine Image（AMI）オプションのみが利用可能です。
- ソフトウェア価格の詳細セクションでは、時間単位のサブスクリプションタイプが利用可能です。
総価格には、ONLYOFFICEソフトウェアと、このソフトウェアソリューションを展開するために使用されるAWSインフラストラクチャサービスの料金が含まれます。
注：有料AMIへのサブスクリプションやその他の価格の詳細については、AWSドキュメントを参照してください。
表に表示されているEC2インスタンスタイプ（例：t3.large）をクリックすると、インスタンスの詳細を確認できます。EC2インスタンスタイプは、ONLYOFFICEソリューションを展開するために使用される仮想サーバーのハードウェアを決定します。
利用可能なインスタンスタイプは、選択したONLYOFFICE Docsのデベロッパー版ソリューションのバリアント、つまり許可される接続数によって異なります。
t3.medium EC2インスタンスタイプは、ONLYOFFICE Docs デベロッパー版（250接続）に使用されます。以下のパラメータがあります：
- メモリ：4 GB
- CPU：2 仮想コア
- ストレージ：EBSのみ
- ネットワーク：最大5ギガビットイーサネット
t3.xlarge EC2インスタンスタイプは、ONLYOFFICE Docs デベロッパー版（500接続）に使用されます。以下のパラメータがあります：
- メモリ：16 GB
- CPU：4 仮想コア
- ストレージ：EBSのみ
- ネットワーク：最大5ギガビットイーサネット
t3.2xlarge EC2インスタンスタイプは、ONLYOFFICE Docs デベロッパー版（1000接続）に使用されます。以下のパラメータがあります：
- メモリ：32 GB
- CPU：8 仮想コア
- ストレージ：EBSのみ
- ネットワーク：最大5ギガビットイーサネット
使用タブに切り替えると、次の情報を確認できます：
- 提供オプションセクションでは、AMIの特性が表示されます。ONLYOFFICE AMIは64ビット（x86）アーキテクチャを持っています。
- テンプレートコンポーネントセクションでは、この製品に使用されるAWSサービスが表示されます。
- EC2サービスは、CentOS上で動作する仮想サーバーを展開し、その上にONLYOFFICEソフトウェアソリューションをインストールするために必要な環境を提供します。
- 使用手順には、インスタンス起動後の初期ONLYOFFICE設定を行うための簡単な推奨事項が含まれています。
- エンドユーザーライセンス契約は、ONLYOFFICE Docsのデベロッパー版ソリューションが提供される条件を規定しています。
右上のサブスクライブを続けるボタンをクリックします。このソフトウェアにサブスクライブするページが開きます：
AWSカスタマー契約を読み、条件を承諾するボタンをクリックします。サブスクリプションが処理されるのを待ちます。
発効日フィールドに「保留中」ではなく現在の日付が表示されたら、右上の設定を続けるボタンをクリックします。
ステップ 2. AWSクラウドでONLYOFFICEインスタンスを起動する
このソフトウェアを設定するページで、右上の起動を続けるボタンをクリックします。
このソフトウェアを起動するページが開きます。このページで設定の詳細を再確認できます。
アクションを選択セクションでは、インスタンスを起動する方法を選択できます。デフォルトではウェブサイトから起動オプションが選択されています。このウェブページにあるインスタンス起動ウィザードを使用してインスタンスをデプロイするために、そのままにしておきます。
EC2インスタンスタイプセクションでは、以前に選択したONLYOFFICE Docs デベロッパー版インスタンスタイプに応じた接続数が許可されたオプションのみが利用可能です。
VPC設定およびサブネット設定セクションでは、デフォルト設定のままにします。
次に、新しいセキュリティグループを作成し、キーペアを生成する必要があります。
新しいセキュリティグループを作成する
セキュリティグループは、既知のIPアドレスのみがインスタンスにアクセスできるようにアクセスを制限します。
セキュリティグループ設定セクションで、販売者設定に基づいて新規作成ボタンをクリックします。
セキュリティグループの名前（例：ONLYOFFICE）を入力し、その説明を追加します。
ソース（IPまたはグループ）リストを使用して、必要なルールを設定します。単一のIPアドレスまたはIPアドレス範囲を指定できます。例：10.040.196.230/32。
以下のポートに対してルールが指定されています：
- SSH - ポート22はSSHプロトコルを使用してSSHクライアントからサーバーにアクセスするために使用されます。
- HTTP - ポート80はHTTPプロトコルを使用してウェブブラウザからウェブオフィスにアクセスするために使用されます。
- HTTPS - ポート443は安全なHTTPSプロトコルを使用してウェブブラウザからウェブオフィスにアクセスするために使用されます。
準備ができたら、保存ボタンをクリックします。
キーペアを生成する
キーペアは、PuTTYやOpenSSHのようなSSHクライアントを使用してSSHプロトコルを介してインスタンスに安全に接続するために必要です。
キーペア設定セクションで、EC2でキーペアを作成リンクをクリックします。
AWS管理コンソールが新しいブラウザタブで開きます。
右上隅にあるキーペアを作成ボタンをクリックします。対応するフィールドにキーペア名（例：ONLYOFFICE）を入力し、インスタンスにリモートで接続するために使用したいソフトウェアに応じてファイル形式を選択します：
pemはOpenSSH用ppkはPuTTY用
下のキーペアを作成ボタンをクリックします。
公開鍵はAWS EC2に保存されます。あなたのプライベートキーを含む.pem/.ppkファイルはローカルマシンにダウンロードされ、デフォルトのダウンロードフォルダに保存されます。コピーして安全な場所に保管してください。
AWSマーケットプレイスに戻り、右のアイコンを使用してキーペアフィールドを更新し、作成したキーペアをリストから選択します。
その後、起動ボタンがアンロックされます。起動ボタンをクリックし、インスタンスがデプロイされるのを待ちます。準備が整うと、デプロイが成功したことを知らせるメッセージが表示されます。
このメッセージ内のEC2コンソールリンクをクリックして、AWS管理コンソールでインスタンスの詳細を開きます。
インスタンスが完全に機能するようになるまでには時間がかかることがあります。インスタンス状態列でインスタンスのステータスが'pending'から'running'に変わり、すべてのステータスチェックをパスしたことを確認してください。この情報はステータスチェック列に表示されます。
その後、SSHを介してインスタンスに接続し、テスト例を有効にして、ウェブブラウザを介してソリューションの機能を確認できます。
ステップ3. SSHでサーバーに接続する
インスタンスが稼働したら、centosというユーザー名とSSHプライベートキーを使用してSSH経由でアクセスできます。
SSHを介して仮想サーバーに接続するには、インスタンスのパブリックDNSまたはIPアドレスも使用する必要があります。
これらはAWS管理コンソールで確認できます。左のメニューでインスタンスセクションに切り替え、デフォルトで選択されているリージョン（US East (N. Virginia)）を選択し、リストからONLYOFFICEインスタンスを選択してインスタンスの詳細を開きます。
説明タブのパブリックDNS（IPv4）またはIPv4パブリックIPの左にある
アイコンをクリックして、必要な値をクリップボードにコピーします。
Windowsでは、PuTTYユーティリティを使用できます。
インスタンスをデプロイする際に生成されたAWSプライベートキー・ファイルは、パスワードの代わりに認証に使用されます。
PuTTYを起動します。左側のナビゲーションパネルで、Connection -> SSH -> Authセクションを開きます。Authentication parameters -> Private key file for authenticationセクションに進み、Browseボタンをクリックして、ローカルマシンに保存されている.ppkファイルのパスを見つけます。
左側のナビゲーションパネルでSessionセクションに戻ります。インスタンスのPublic DNSまたはIPアドレスをHost Name or IP addressフィールドに入力し、ポート22が指定されていることを確認し、SSH接続タイプを選択してOpenボタンをクリックします。
その後、PuTTY Security AlertウィンドウでYesをクリックします。ユーザー名centosを入力し、Enterを押します。
Linuxでは、OpenSSHのようなSSHクライアントを使用できます。
ローカルマシンに保存されているプライベートキーの.pemファイルのパス、centosユーザー名、およびインスタンスのIPアドレスまたはPublic DNSを指定する必要があります。
ターミナルで次のコマンドを入力し、.pemファイルパスとIPアドレスの実際の値を指定します：
ssh -i /path/onlyoffice.pem centos@your_instance_ipサーバーへの接続を続行するには、yesと入力します。詳細については、AWSのドキュメントを参照してください。
ソリューションの機能を探索するには、テスト例を有効にして、ローカルファイルをアップロードしてテストできるようにします。そのためには、次のコマンドを実行します：
sudo docker exec $(sudo docker ps -q) sudo supervisorctl start ds:example例を自動起動に追加します：
sudo docker exec $(sudo docker ps -q) sudo sed 's,autostart=false,autostart=true,' -i /etc/supervisor/conf.d/ds-example.conf
ステップ 4. Webブラウザを介してDocsデベロッパー版にアクセスする
例が開始されたら、http://<public IP address>/example/をWebブラウザのアドレスバーに入力し、<public IP address>をAmazonから提供されたパブリックIPアドレスまたはパブリックDNSに置き換えます。
ONLYOFFICE Docsのデベロッパー版の例ページが開きます。ここで以下のことができます：
- ファイルをアップロードオプションを使用して、PCに保存されているファイルをアップロードします。
- 新規作成 -> ドキュメント、スプレッドシート、プレゼンテーション、またはフォームテンプレートオプションを使用して、新しい空白のテキストドキュメント、スプレッドシート、プレゼンテーション、またはフォームテンプレートを作成します。サンプルコンテンツを含むファイルを作成したい場合は、最初にサンプルコンテンツを含むボックスをチェックします。
アップロードまたは作成されたファイルは、対応するONLYOFFICEオンラインエディターで新しいブラウザタブに開かれ、編集機能をテストできます。
ファイルはONLYOFFICE Docsのデベロッパー版の例ページのあなたのドキュメントリストにも表示されます。
共同編集機能を確認したい場合は、ユーザー名リストから別のテストユーザーを選択し、あなたのドキュメントリストで同じドキュメントをクリックして、新しいブラウザタブで開きます。
ONLYOFFICE Docsを独自のWebアプリケーションと統合するには、APIドキュメントを参照してください。