翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
ステップ 5: 設定のデプロイ
AWS AppConfigでデプロイを開始すると、StartDeployment API アクションが呼び出されます。この呼び出しには、デプロイする AWS AppConfig アプリケーションの ID、環境、設定プロファイル、および設定データバージョン (オプション) が含まれます。この呼び出しには、使用するデプロイ戦略の ID も含まれます。ID は、設定データのデプロイ方法を決定します。
AWS AppConfig はすべてのホストへの配布をモニタリングし、ステータスをレポートします。ディストリビューションが失敗した場合は、AWS AppConfig は設定をロールバックします。
環境には、一度に 1 つの設定のみデプロイできます。ただし、1 つの設定をそれぞれ異なる環境に同時にデプロイすることができます。
設定をデプロイする (コンソール)
AWS Systems Manager コンソールを使用して AWS AppConfig 設定をデプロイするには、次の手順に従います。
コンソールを使用して設定をデプロイするには
AWS Systems Manager コンソール (https://console.aws.amazon.com/systems-manager/appconfig/) を開きます。
-
ナビゲーションペインで、[AWS AppConfig] を選択します。
-
[Applications (アプリケーション)] タブでアプリケーションを選択し、[View details (詳細の表示)] を選択します。
-
[Environments (環境)] タブで環境を選択し、[View details (詳細の表示)] を選択します。
-
[Start deployment (デプロイの開始)] を選択します。
-
[Configuration (設定)] で、リストから設定を選択します。
-
設定のソースに応じて、[Document version (ドキュメントのバージョン)] リストまたは [Parameter version (パラメータのバージョン)] リストを使用して、デプロイするバージョンを選択します。
-
[Deployment strategy (デプロイ戦略)] で、リストから戦略を選択します。
-
[Deployment description (デプロイの説明)] に、説明を入力します。
-
[Tags (タグ)] セクションで、キーとオプションの値を入力します。1 つのリソースに対して最大 50 個のタグを指定できます。
-
[Start deployment (デプロイの開始)] を選択します。
設定をデプロイする (コマンドライン)
以下の手順では、AWS CLI (Linux または Windows の場合) または AWS Tools for PowerShell を使用して AWS AppConfig 設定をデプロイする方法について説明します。
設定をステップバイステップでデプロイする
AWS CLI をインストールして設定します。詳細については、「AWS コマンドラインツールをインストールまたはアップグレードする」を参照してください。
-
次のコマンドを実行して、設定をデプロイします。
- Linux
-
aws appconfig start-deployment \
--application-id The_application_ID
\
--environment-id The_environment_ID
\
--deployment-strategy-id The_deployment_strategy_ID
\
--configuration-profile-id The_configuration_profile_ID
\
--configuration-version The_configuration_version_to_deploy
\
--description A_description_of_the_deployment
\
--tags User_defined_key_value_pair_metadata_of_the_deployment
- Windows
-
aws appconfig start-deployment ^
--application-id The_application_ID
^
--environment-id The_environment_ID
^
--deployment-strategy-id The_deployment_strategy_ID
^
--configuration-profile-id The_configuration_profile_ID
^
--configuration-version The_configuration_version_to_deploy
^
--description A_description_of_the_deployment
^
--tags User_defined_key_value_pair_metadata_of_the_deployment
- PowerShell
-
Start-APPCDeployment `
-ApplicationId The_application_ID
`
-ConfigurationProfileId The_configuration_profile_ID
`
-ConfigurationVersion The_configuration_version_to_deploy
`
-DeploymentStrategyId The_deployment_strategy_ID
`
-Description A_description_of_the_deployment
`
-EnvironmentId The_environment_ID
`
-Tag Hashtable_type_user_defined_key_value_pair_metadata_of_the_deployment
システムが以下のような情報を返します。
- 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