展開の改訂 - AWS IoT Greengrass

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

展開の改訂

各ターゲットのモノまたはモノグループは、一度に 1 つのアクティブなデプロイを持つことができます。既にデプロイがあるターゲットのデプロイを作成するとき、新しいデプロイのソフトウェアコンポーネントが、以前のデプロイのソフトウェアコンポーネントを置き換えます。新しいデプロイが、以前のデプロイが定義するコンポーネントを定義しない場合、AWS IoT Greengrass Core ソフトウェアはターゲットコアデバイスからそのコンポーネントを削除します。既存のデプロイを改訂して、ターゲットに対する以前のデプロイのコアデバイスで実行されるコンポーネントを削除しないようにできます。

デプロイを改訂するには、以前のデプロイに存在する同じコンポーネントと設定から開始するデプロイを作成します。CreateDeployment オペレーションを使用します。これは、デプロイの作成に使用するのと同じオペレーションです。

デプロイ (AWS CLI) を改訂するには

  1. 次のコマンドを実行して、デプロイターゲットのデプロイを一覧表示します。targetArn をターゲット AWS IoT モノまたはモノグループの ARN に置き換えます。

    aws greengrassv2 list-deployments --target-arn targetArn

    レスポンスには、ターゲットの最新デプロイのリストが含まれています。deploymentId を次のステップで使用するレスポンスからコピーします。

    注記

    ターゲットの最新リビジョン以外のデプロイを修正することもできます。--history-filter ALL 引数を指定して、ターゲットのすべてのデプロイを一覧表示します。次に、修正するデプロイの ID をコピーします。

  2. 次のコマンドを実行して、デプロイの詳細を取得します。これらの詳細には、メタデータ、コンポーネント、ジョブ設定が含まれます。deploymentId を前のステップの ID に置き換えます。

    aws greengrassv2 get-deployment --deployment-id deploymentId

    レスポンスには、デプロイの詳細が含まれています。

  3. deployment.json という名前のファイルを作成し、前のコマンドのレスポンスをファイルにコピーします。

  4. deployment.json の JSON オブジェクトから次のキーと値のペアを削除します。

    • deploymentId

    • revisionId

    • iotJobId

    • iotJobArn

    • creationTimestamp

    • isLatestForTarget

    • deploymentStatus

    CreateDeployment オペレーションでは、次の構造のペイロードを想定しています。

    {
  "targetArn": "String",
  "components": Map of components,
  "deploymentPolicies": DeploymentPolicies,
  "iotJobConfiguration": DeploymentIoTJobConfiguration,
  "tags": Map of tags
}

  5. deployment.json で、次のいずれかを行ってください。

    • デプロイの名前 (deploymentName) を変更します。

    • デプロイのコンポーネント (components) を変更します。

    • デプロイのポリシー (deploymentPolicies) を変更します。

    • デプロイのジョブ設定 (iotJobConfiguration) を変更します。

    • デプロイのタグ (tags) を変更します。

    これらのデプロイを定義する方法の詳細については、「デプロイの作成」を参照してください。

  6. 以下のコマンドを実行して、deployment.json からデプロイを作成します。

    aws greengrassv2 create-deployment --cli-input-json file://deployment.json

    レスポンスには、このデプロイを識別する deploymentId が含まれます。デプロイ ID を使用して、デプロイのステータスを確認できます。詳細については、「デプロイのステータスを確認する」を参照してください。