構成のデプロイ

「機能フラグやフリーフォームの設定データを扱うために必要なアーティファクトを作成したら」、AWS Management Console または AWS CLI やSDK を使用して新しいデプロイを作成できます。AWS AppConfig でデプロイを開始すると、StartDeployment‬ APIオペレーションが呼び出されます。この呼び出しには、デプロイする AWS AppConfig アプリケーションの ID、環境、構成プロファイル、および構成データバージョン（オプショナル）が含まれます。この呼び出しには、使用するデプロイ戦略の ID も含まれます。ID は、構成データのデプロイ方法を決定します。

カスタマが管理するキーで暗号化された Amazon Simple Storage Service (Amazon S3) オブジェクトにAWS Secrets Manager格納されたシークレット、またはカスタマが管理するキーで暗号化された AWS Systems ManagerParameter Store に格納されたセキュアな文字列パラメータをデプロイする場合は、KmsKeyIdentifierパラメータに値を指定する必要があります。設定が暗号化されていない場合、または AWS マネージドキー暗号化を使用している場合は、、KmsKeyIdentifier パラメータの値を指定する必要はありません。

注記

KmsKeyIdentifier に指定する値は、カスタマーマネージド型キーである必要があります。これは設定の暗号化に使用したキーと同じである必要はありません。

KmsKeyIdentifier を使用してデプロイを開始する場合、AWS Identity and Access Management (IAM) プリンシパルにアタッチされているアクセス権限ポリシーでkms:GenerateDataKey 操作が許可されている必要があります。

AWS AppConfig はすべてのホストへの配布をモニタリングし、ステータスをレポートします。ディストリビューションが失敗した場合は、AWS AppConfig は構成をロールバックします。

注記

環境には、一度に 1 つの設定のみデプロイできます。ただし、1 つの設定をそれぞれ異なる環境に同時にデプロイすることができます。

設定をデプロイする (コンソール)

AWS Systems Manager コンソールを使用して AWS AppConfig 設定をデプロイするには、次の手順に従います。

コンソールを使用して設定をデプロイするには

AWS Systems Manager コンソール (https://console.aws.amazon.com/systems-manager/appconfig/) を開きます。
ナビゲーションペインで、AWS AppConfig を選択します。
アプリケーション タブでアプリケーションを選択し、詳細の表示 を選択します。
環境タブで環境を選択し、詳細の表示 を選択します。
デプロイの開始 を選択します。
設定で、リストから設定を選択します。
設定のソースに応じて、ドキュメントのバージョン リストまたは パラメータのバージョン リストを使用して、デプロイするバージョンを選択します。
デプロイ戦略 で、リストから戦略を選択します。
デプロイの説明 に、説明を入力します。
タグセクションで、キーとオプションの値を入力します。1 つのリソースに対して最大 50 個のタグを指定できます。
デプロイの開始 を選択します。

設定をデプロイする (コマンドライン)

以下の手順では、AWS CLI (Linux または Windows の場合) または AWS Tools for PowerShell を使用して AWS AppConfig 設定をデプロイする方法について説明します。

設定をステップバイステップでデプロイする

AWS CLI を開きます。

次のコマンドを実行して、設定をデプロイします。

システムが以下のような情報を返します。

Linux

{   
   "ApplicationId": "The ID of the application that was deployed",
   "EnvironmentId" : "The ID of the environment",
   "DeploymentStrategyId": "The ID of the deployment strategy that was deployed",
   "ConfigurationProfileId": "The ID of the configuration profile that was deployed",
   "DeploymentNumber": The sequence number of the deployment,
   "ConfigurationName": "The name of the configuration",
   "ConfigurationLocationUri": "Information about the source location of the configuration",
   "ConfigurationVersion": "The configuration version that was deployed",
   "Description": "The description of the deployment",
   "DeploymentDurationInMinutes": Total amount of time the deployment lasted,
   "GrowthType": "The linear or exponential algorithm used to define how percentage grew over time",
   "GrowthFactor": The percentage of targets to receive a deployed configuration during each interval,
   "FinalBakeTimeInMinutes": Time AWS AppConfig monitored for alarms before considering the deployment to be complete,
   "State": "The state of the deployment",  

   "EventLog": [ 
      { 
         "Description": "A description of the deployment event",
         "EventType": "The type of deployment event",
         "OccurredAt": The date and time the event occurred,
         "TriggeredBy": "The entity that triggered the deployment event"
      }
   ],

   "PercentageComplete": The percentage of targets for which the deployment is available,
   "StartedAt": The time the deployment started,
   "CompletedAt": The time the deployment completed   
}

Windows

{
   "ApplicationId": "The ID of the application that was deployed",
   "EnvironmentId" : "The ID of the environment",
   "DeploymentStrategyId": "The ID of the deployment strategy that was deployed",
   "ConfigurationProfileId": "The ID of the configuration profile that was deployed",
   "DeploymentNumber": The sequence number of the deployment,
   "ConfigurationName": "The name of the configuration",
   "ConfigurationLocationUri": "Information about the source location of the configuration",
   "ConfigurationVersion": "The configuration version that was deployed",
   "Description": "The description of the deployment",
   "DeploymentDurationInMinutes": Total amount of time the deployment lasted,
   "GrowthType": "The linear or exponential algorithm used to define how percentage grew over time",
   "GrowthFactor": The percentage of targets to receive a deployed configuration during each interval,
   "FinalBakeTimeInMinutes": Time AWS AppConfig monitored for alarms before considering the deployment to be complete,
   "State": "The state of the deployment",  

   "EventLog": [ 
      { 
         "Description": "A description of the deployment event",
         "EventType": "The type of deployment event",
         "OccurredAt": The date and time the event occurred,
         "TriggeredBy": "The entity that triggered the deployment event"
      }
   ],

   "PercentageComplete": The percentage of targets for which the deployment is available,
   "StartedAt": The time the deployment started,
   "CompletedAt": The time the deployment completed 
}

PowerShell

ApplicationId               : The ID of the application that was deployed
CompletedAt                 : The time the deployment completed
ConfigurationLocationUri    : Information about the source location of the configuration
ConfigurationName           : The name of the configuration
ConfigurationProfileId      : The ID of the configuration profile that was deployed
ConfigurationVersion        : The configuration version that was deployed
ContentLength               : Runtime of the deployment 
DeploymentDurationInMinutes : Total amount of time the deployment lasted
DeploymentNumber            : The sequence number of the deployment
DeploymentStrategyId        : The ID of the deployment strategy that was deployed
Description                 : The description of the deployment
EnvironmentId               : The ID of the environment that was deployed
EventLog                    : {Description : A description of the deployment event, EventType : The type of deployment event, OccurredAt : The date and time the event occurred,
         TriggeredBy : The entity that triggered the deployment event}
FinalBakeTimeInMinutes      : Time AWS AppConfig monitored for alarms before considering the deployment to be complete
GrowthFactor                : The percentage of targets to receive a deployed configuration during each interval
GrowthType                  : The linear or exponential algorithm used to define how percentage grew over time
HttpStatusCode              : HTTP Status of the runtime
PercentageComplete          : The percentage of targets for which the deployment is available
ResponseMetadata            : Runtime Metadata
StartedAt                   : The time the deployment started
State                       : The state of the deployment

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

デプロイ戦略の使用

CodePipeline とのデプロイ統合