コードのデプロイ deploy-your-code

AEM as a Cloud Service の Cloud Manager パイプラインを使用して、コードを実稼動環境にデプロイする方法を説明します。

コードをステージング環境に、さらには実稼動環境にシームレスにデプロイするには、実稼動パイプラインを使用します。 実稼動パイプラインの実行は、次の 2 つの論理フェーズに分かれます。

コードスキャン、機能テスト、UI テスト、エクスペリエンス監査をサポートしているのは、フルスタックコードパイプラインタイプのみです。

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

Cloud Service のすべてのデプロイメントでは、ダウンタイムをなくすために、ローリングプロセスに従います。詳しくは、ローリングデプロイメントの仕組みを参照してください。

AEM as a Cloud ServiceのCloud Managerでコードをデプロイします deploying-code-with-cloud-manager

リポジトリー、環境およびテスト環境を含め、実稼動パイプラインを設定したら、コードをデプロイする準備が整います。

ビルドプロセスでは、次の 3 つの順序付けられたフェーズを通じてコードがデプロイされます。

ステージデプロイメントフェーズ stage-deployment

ステージデプロイメント フェーズには、次のステップが含まれます。

ステージテストフェーズ stage-testing

ステージテスト フェーズには、次のステップが含まれます。

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

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

実稼動デプロイメントは、通常、前述と同じステップに従いますが、周期的な方法で実行されます。 手順は次のとおりです。

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

デプロイメント中のタイムアウト timeouts

デプロイメント中にユーザーからのフィードバックを待ち続けると、次の手順はタイムアウトします。

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

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

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

制限事項 limitations

API の再実行 reexecute-API

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

再実行のトリガー reexecute-deployment-api

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

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

 {
  "_links": {
    "https://ns.adobe.com/adobecloud/rel/pipeline/logs": {
      "href": "/api/program/4/pipeline/1/execution/953671/phase/1575676/step/2983530/logs",
      "templated": false
    },
    "https://ns.adobe.com/adobecloud/rel/pipeline/reExecute": {
      "href": "/api/program/4/pipeline/1/execution?stepId=2983530",
      "templated": false
    },
    "https://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 を使用して通常の実行を開始する場合と似ています。

再実行の識別 identify-reexecution

システムは、trigger フィールドに値 RE_EXECUTE を設定することで再実行を識別します。