AWS への Docker Compose のインストール

1. AWS アカウントがあることを確認してください。

2. AWS マネジメントコンソールで AWS CloudFormation(英語) サービスを開きます。

3. スタックの作成をクリックします。

4. テンプレートを準備するでは、テンプレートの準備ができましたを選択します。

5. テンプレートソースで Amazon S3 URL を選択し、URL を指定します: https://on-premises-assets-eu-west-1.s3.eu-west-1.amazonaws.com/2024.2.1/aws-cfn-template.json

6. 「次へ」をクリックし、スタック名とその他のパラメーターを指定します。

   スタック名	(必須) Space インスタンスのスタックの名前。
   AdminEmail	(必須) Space 管理者のメールアドレス。
   AdminUsername	(必須) 管理者のユーザー名。
   AdminPassword	(必須) 管理者のパスワード。
   HostedZoneName	Space インスタンスをホストする既存の Amazon Route 53 ホストゾーンの DNS 名 (例: mycompany.com) ホストゾーンがない場合は、次のことができます。 このパラメーターは空のままにしておきます。この場合、テンプレートは nip.io(英語) サービスを使用して Space インスタンスの URL を自動的に生成します。HTTPS は自動生成された URL では使用できないことに注意してください。 Amazon ルート 53(英語) サービスに新しいドメイン名を登録します。デフォルトでは、ドメインを作成するときに、AWS はそれに対応するホストゾーンを作成します。ホストゾーン名はドメイン名と同じです。
   サイズ	(オプション) 提供されたリソースのサイズ。可能な値は次のとおりです。 小 : (デフォルト) メインアプリケーションの t4g.xlarge インスタンスとデータベースの db.t4g.medium インスタンス。データベース用に 50GB のストレージが割り当てられます。 中 : メインアプリケーションの t4g.xlarge インスタンスとデータベースの db.t4g.large インスタンス。データベース用に 100GB の割り当てられたストレージ。 大 : メインアプリケーションの t4g.2xlarge インスタンスとデータベースの db.t4g.large インスタンス。データベース用に 200 GB の割り当てられたストレージ。 T4g インスタンスの詳細については、AWS の公式ドキュメント(英語)を参照してください。

7. 次へをクリックします。

8. 後続のすべてのページで他のオプションを変更せず、次へをクリックしてスキップしてください。

9. サブミットをクリックする前に、必ず AWS CloudFormation が IAM リソースを作成する可能性があることを認めますを選択してください。これは、テンプレートが Space インスタンスの IAM ロールを作成するときに必要です。

10. AWS CloudFormation は、Space On-Premises を使用してスタックの作成を開始します。これは時間がかかる場合があります。スタックが作成されると、スタックの出力タブに Space URL が表示されます。

11. インストール後の管理アクティビティを実行します。

    • Space オンプレミスインスタンスをアクティブ化します。

    • モバイルクライアントで Space を使用する場合は、プッシュ通知を構成します。

    • Space でメール通知を有効にする場合は、メールサーバーを構成します。Space インスタンスにはメールサーバーが付属していないことに注意してください。既存のメールサーバーがない場合は、Amazon かんたんメールサービス(英語)を使用して作成できます。

    • Space オートメーション (CI/CD) を使用する場合は、セルフホスト型オートメーションワーカーを構成します。現在、Space On-Premises はクラウドオートメーションワーカーをサポートしていません。

1. AWS マネジメントコンソールで AWS CloudFormation(英語) サービスを開きます。

2. Space On-Premises でスタックを開きます。

3. 更新をクリックし、必要なパラメーターを変更します。

   スタックの作成後は、AdminEmail、AdminUsername、AdminPassword パラメーターを変更できないことに注意してください。該当する値を更新しても反映されません。

4. 他のオプションは変更せず、「次へ」をクリックします。

5. サブミットをクリックします。

Space オンプレミスインスタンスをバックアップするには

1. Space データのバックアップを作成します。

   1. ブラウザーで Space On-Premises インスタンスを開きます。

   2. メインメニューで、 管理をクリックし、データベースのバックアップを選択します。

   3. バックアップを作成するをクリックします。

2. AWS CloudFormation スタックのバックアップを作成します。

   AWS では、オンデマンドバックアップを作成したり、バックアップをスケジュールしたりできます。Amazon の公式推奨事項(英語)に従ってください。

   その結果、次の内容で構成される複合バックアップが取得されます。

   • スタック構成のバックアップ。

   • ステップ 1 で作成した Space データのバックアップを保存する S3 バケットのバックアップ。

Space オンプレミスインスタンスを復元するには

1. AWS アカウントを開きます。

2. AWS バックアップコンソールを開き、次に保護されたリソースを開きます。

3. リカバリポイントで、複合バックアップを見つけて展開します。

4. CloudFormation 構成のバックアップを選択します。このバックアップは、リソースタイプ列の CloudFormation 値で見つけることができます。

5. 復元をクリックします。復元中に、インストール時に指定したのと同じ設定を指定するように求められます。復元が完了すると、クリーンな Space On-Premises インスタンスを含む新しいスタックが取得されます。

6. 保護されたリソースページに戻り、Space データベースを含むバックアップを選択します。このバックアップは、ID 内の spacebucket という単語 ( my-onprem-instance-spacebucket-1bdai-29239793114334-a04ca4e3 など) で見つけることができます。

7. 復元をクリックします。復元中に、次の設定を指定します。

   • 復元タイプでは、バケット全体を復元するを選択します。

   • 復元先では、既存のバケットを使用するを選択します。

   • バケット名で、復元された Space On-Premises インスタンス用に作成されたバケットを選択します。バケットの ID には spacebucket という単語が含まれています (例: my-restored-instance-spacebucket-n0ulpds2xcks)。

   復元が完了するまで待ちます。

8. 保護されたリソースページに戻り、前と同じ方法で他のすべてのバックアップを復元します。

   • Space パッケージのバックアップ: ID に packagesbucket という単語が含まれています。

   • VCS バックアップ: ID に vcssbucket という単語が含まれています。

   • 自動バックアップ: ID に automation という単語が含まれます。

9. ブラウザーで、復元された Space On-Premises インスタンスのデータベースのバックアップページ (例: https://my-instance.url/manage/db-backups) を開きます。

   重要: インスタンスのインデックスページを開くと、Space ライセンスキーの入力を求められます。こんなことしないで ! ライセンスキーはデータベースのバックアップにすでに保存されています。

10. データベースのバックアップページで、使用可能なバックアップの横にある復元をクリックします。