コードのデプロイメント 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

重大な状況では、Managed ServicesのAdobeユーザーが、ステージング環境および実稼動環境に直ちにコード変更をデプロイする必要が生じる場合があります。 この機能を使用すると、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 によって特定されます。