コードのデプロイメント code-deployment

コードをデプロイする方法と、デプロイ時に Cloud Manager で何が行われるかを説明します。

Cloud Manager でのコードのデプロイ deploying-code-with-cloud-manager

必要なリポジトリと環境を含む実稼動パイプラインを設定すると、コードをデプロイする準備が整います。

ビルドプロセスは、次のステップを含むコードデプロイメントプロセスを開始します。

テスト条件のログを表示したり結果を確認したりすることで、様々なデプロイメントプロセスのステップを確認できます。

デプロイメント手順 deployment-steps

デプロイメントの各ステップでは、多数のアクションが実行されます。この節では、これらについて説明します。コード自体の内部的なデプロイ方法に関する技術的な詳細については、デプロイメントプロセスの詳細を参照してください。

ステージデプロイメント手順 stage-deployment

ステージデプロイメント ​ステップには、次のアクションが含まれます。

ステージテスト手順 stage-testing

ステージテスト ​ステップには、次のアクションが含まれます。

実稼動デプロイメント手順 production-deployment

実稼動デプロイメント ​ステップには、次のアクションが含まれます。

デプロイメントが完了すると、コードはターゲット環境に配置され、ログを確認できます。

タイムアウト timeouts

ユーザーのフィードバックを待機したままにすると、次の手順はタイムアウトします。

デプロイメントプロセスの詳細 deployment-process

Cloud Manager は、ビルドプロセスで生成されたすべての target/*.zip ファイルを保存場所にアップロードします。これらのアーティファクトは、パイプラインのデプロイフェーズで、この場所から取得されます。

Cloud Manager が実稼動以外のトポロジにデプロイされる場合、目的はできるだけ早くデプロイメントを完了することです。そのため、アーティファクトは、以下のようにすべてのノードに同時にデプロイされます。

実稼動フェーズへのデプロイメント deployment-production-phase

実稼動トポロジへのデプロイプロセスはわずかに異なり、AEM サイト訪問者への影響を最小限に抑えます。

実稼動のデプロイメントは、通常、上記と同じ手順に従いますが、周期的な方法で実行します。

このプロセスは、デプロイメントがトポロジのすべてのパブリッシャーおよび Dispatcher に到達するまで続行されます。

緊急パイプライン実行モード emergency-pipeline

重大な状況では、Adobe Managed Services をご利用のお客様は、コードの変更をステージング環境と実稼動環境に直ちにデプロイする必要がある場合があります。この機能により、Cloud Manager のテストサイクル全体を回避できます。

このような状況に対処するために、Cloud Manager の実稼動パイプラインは、緊急モードで実行することができます。このモードを使用すると、セキュリティテストのステップとパフォーマンステストのステップは実行されません。設定済みの承認ステップなどの他のステップはすべて、通常のパイプライン実行モードの場合と同様に実行されます。

緊急パイプライン実行モードの使用 using-emergency-pipeline

実稼動パイプラインの実行を開始する際に、ダイアログボックスから通常モードまたは緊急モードのいずれかを選択できます。このオプションは、プログラムに対して緊急パイプライン実行モード機能がアクティベートされている場合に使用できます。この選択は、機能を有効にすると使用できます。

緊急モードでの実行について、パイプライン実行の詳細ページを表示すると、画面の上部にあるパンくずリストに、パイプラインが緊急モードで実行中であることを示すインジケーターが表示されます。

緊急モードでのパイプライン実行は、Cloud Manager API または CLI を介して実行することもできます。緊急モードで実行を開始するには、クエリパラメーター ?pipelineExecutionMode=EMERGENCY を使用して、パイプラインの実行エンドポイントに PUT リクエストを送信します。また、CLI を使用する場合は、次のようにします。

$ aio cloudmanager:pipeline:create-execution PIPELINE_ID --emergency

実稼動デプロイメントの再実行 reexecute-deployment

まれに、一時的な理由で実稼動デプロイメントステップが失敗すること場合があります。このような場合、実稼動デプロイメントステップの成功、キャンセル、失敗に関係なく、完了していれば再実行できます。次の 3 つのステップで構成される同じパイプラインを使用することで、再実行がサポートされます。

再実行が可能な状況では、実稼動パイプラインステータスページには、通常の「ビルドログをダウンロード」オプションの横に「再実行」オプションが表示されます。

制限事項 limitations

API の再実行 reexecute-api

UI で使用できるだけでなく、Cloud Manager API を使用して再実行をトリガーしたり、再実行としてトリガーされた実行を識別したりすることもできます。

再実行のトリガー triggering

再実行をトリガーするには、実稼働デプロイメントステップの状態で HAL リンク（http://ns.adobe.com/adobecloud/rel/pipeline/reExecute）に対して PUT リクエストを行う必要があります。

このリンクは、実稼動デプロイメントステップでのみ使用できます。

 {
  "_links": {
    "http://ns.adobe.com/adobecloud/rel/pipeline/logs": {
      "href": "/api/program/4/pipeline/1/execution/953671/phase/1575676/step/2983530/logs",
      "templated": false
    },
    "http://ns.adobe.com/adobecloud/rel/pipeline/reExecute": {
      "href": "/api/program/4/pipeline/1/execution?stepId=2983530",
      "templated": false
    },
    "http://ns.adobe.com/adobecloud/rel/pipeline/metrics": {
      "href": "/api/program/4/pipeline/1/execution/953671/phase/1575676/step/2983530/metrics",
      "templated": false
    },
    "self": {
      "href": "/api/program/4/pipeline/1/execution/953671/phase/1575676/step/2983530",
      "templated": false
    }
  },
  "id": "6187842",
  "stepId": "2983530",
  "phaseId": "1575676",
  "action": "deploy",
  "environment": "weretail-global-b75-prod",
  "environmentType": "prod",
  "environmentId": "59254",
  "startedAt": "2022-01-20T14:47:41.247+0000",
  "finishedAt": "2022-01-20T15:06:19.885+0000",
  "updatedAt": "2022-01-20T15:06:20.803+0000",
  "details": {
  },
  "status": "FINISHED"

HAL リンクの href 値の構文は例にすぎません。実際の値は生成されるのではなく、常に HAL リンクから読み取られる必要があります。

このエンドポイントに PUT リクエストを送信すると、成功した場合は 201 応答が返されます。応答の本文には、新しい実行が表示されます。この機能は、API を使用して通常の実行を開始する場合と似ています。

再実行された実行の識別 identifying

再実行された実行は、トリガーフィールドの値 RE_EXECUTE によって識別されます。