AWS CLI를 사용한 AWS AppConfig 예제 - AWS Command Line Interface
작업

이 문서는 AWS CLI의 버전 1에만 해당합니다. AWS CLI의 버전 2와 관련된 문서는 버전 2 사용 설명서를 참조하세요.

AWS CLI를 사용한 AWS AppConfig 예제

다음 코드 예제에서는 AWS AppConfig에서 AWS Command Line Interface를 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여 줍니다.

작업은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접적으로 호출하는 방법을 보여주며 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.

각 예제에는 컨텍스트에서 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있는 전체 소스 코드에 대한 링크가 포함되어 있습니다.

주제

작업

다음 코드 예제에서는 create-application을 사용하는 방법을 보여 줍니다.

AWS CLI

애플리케이션을 생성하는 방법

다음 create-application 예제에서는 AWS AppConfig에서 애플리케이션을 생성합니다.

aws appconfig create-application \
    --name "example-application" \
    --description "An application used for creating an example."

출력:

{
    "Description": "An application used for creating an example.",
    "Id": "339ohji",
    "Name": "example-application"
}

자세한 내용은 AWS AppConfig 사용 설명서의 1단계: AWS AppConfig 애플리케이션 생성을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 CreateApplication을 참조하세요.

다음 코드 예제에서는 create-configuration-profile을 사용하는 방법을 보여 줍니다.

AWS CLI

구성 프로파일을 생성하는 방법

다음 create-configuration-profile 예제에서는 Systems Manager의 기능인 Parameter Store에 저장된 구성을 사용하여 구성 프로파일을 생성합니다.

aws appconfig create-configuration-profile \
    --application-id "339ohji" \
    --name "Example-Configuration-Profile" \
    --location-uri "ssm-parameter://Example-Parameter" \
    --retrieval-role-arn "arn:aws:iam::111122223333:role/Example-App-Config-Role"

출력:

{
    "ApplicationId": "339ohji",
    "Description": null,
    "Id": "ur8hx2f",
    "LocationUri": "ssm-parameter://Example-Parameter",
    "Name": "Example-Configuration-Profile",
    "RetrievalRoleArn": "arn:aws:iam::111122223333:role/Example-App-Config-Role",
    "Type": null,
    "Validators": null
}

자세한 내용은 AWS AppConfig 사용 설명서의 3단계: 구성 및 구성 프로파일 생성을 참조하세요.

다음 코드 예제에서는 create-environment을 사용하는 방법을 보여 줍니다.

AWS CLI

확장 연결을 생성하는 방법

다음 create-environment 예제에서는 create-application을 사용하여 생성한 애플리케이션을 사용해 Example-Environment라는 이름의 AWS AppConfig 환경을 생성합니다.

aws appconfig create-environment \
    --application-id "339ohji" \
    --name "Example-Environment"

출력:

{
    "ApplicationId": "339ohji",
    "Description": null,
    "Id": "54j1r29",
    "Monitors": null,
    "Name": "Example-Environment",
    "State": "ReadyForDeployment"
}

자세한 내용은 AWS AppConfig 사용 설명서의 2단계: 환경 생성을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 CreateEnvironment를 참조하세요.

다음 코드 예제에서는 create-extension-association을 사용하는 방법을 보여 줍니다.

AWS CLI

확장 연결을 생성하는 방법

다음 create-extension-association 예제에서는 AWS AppConfig에서 새 확장 연결을 생성합니다.

aws appconfig create-extension-association \
    --region us-west-2 \
    --extension-identifier S3-backup-extension \
    --resource-identifier "arn:aws:appconfig:us-west-2:123456789012:application/Finance" \
    --parameters S3bucket=FinanceConfigurationBackup

출력:

{
  "Id": "a1b2c3d4",
  "ExtensionArn": "arn:aws:appconfig:us-west-2:123456789012:extension/S3-backup-extension/1",
  "ResourceArn": "arn:aws:appconfig:us-west-2:123456789012:application/Finance",
  "Parameters": {
    "S3bucket": "FinanceConfigurationBackup"
  },
  "ExtensionVersionNumber": 1
}

자세한 내용은 AWS AppConfig 사용 설명서의 AWS AppConfig 확장 작업을 참조하세요.

다음 코드 예제에서는 create-extension을 사용하는 방법을 보여 줍니다.

AWS CLI

확장을 생성하는 방법

다음 create-extension 예제에서는 AWS AppConfig에서 새 확장을 생성합니다.

aws appconfig create-extension \
    --region us-west-2 \
    --name S3-backup-extension \
    --actions PRE_CREATE_HOSTED_CONFIGURATION_VERSION=[{Name=S3backup,Uri=arn:aws:lambda:us-west-2:123456789012:function:s3backupfunction,RoleArn=arn:aws:iam::123456789012:role/appconfigextensionrole}] \
    --parameters S3bucket={Required=true}

출력:

{
    "Id": "1A2B3C4D",
    "Name": "S3-backup-extension",
    "VersionNumber": 1,
    "Arn": "arn:aws:appconfig:us-west-2:123456789012:extension/1A2B3C4D/1",
    "Actions": {
        "PRE_CREATE_HOSTED_CONFIGURATION_VERSION": [
            {
                "Name": "S3backup",
                "Uri": "arn:aws:lambda:us-west-2:123456789012:function:s3backupfunction",
                "RoleArn": "arn:aws:iam::123456789012:role/appconfigextensionrole"
            }
        ]
    },
    "Parameters": {
        "S3bucket": {
            "Required": true
        }
    }
}

자세한 내용은 AWS AppConfig 사용 설명서의 AWS AppConfig 확장 작업을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 CreateExtension을 참조하세요.

다음 코드 예제에서는 create-hosted-configuration-version을 사용하는 방법을 보여 줍니다.

AWS CLI

호스팅 구성 버전을 생성하는 방법

다음 create-hosted-configuration-version 예제에서는 AWS AppConfig 호스팅 구성 스토어에서 새 구성을 생성합니다. 먼저 구성 콘텐츠를 base64로 변환해야 합니다.

aws appconfig create-hosted-configuration-version \
    --application-id "339ohji" \
    --configuration-profile-id "ur8hx2f" \
    --content eyAiTmFtZSI6ICJFeGFtcGxlQXBwbGljYXRpb24iLCAiSWQiOiBFeGFtcGxlSUQsICJSYW5rIjogNyB9 \
    --content-type "application/json" \
    configuration_version_output_file

configuration_version_output_file의 콘텐츠:

{ "Name": "ExampleApplication", "Id": ExampleID, "Rank": 7 }

출력:

{
    "ApplicationId": "339ohji",
    "ConfigurationProfileId": "ur8hx2f",
    "VersionNumber": "1",
    "ContentType": "application/json"
}

자세한 내용은 AWS AppConfig 사용 설명서의 AWS AppConfig 호스팅 구성 스토어 정보를 참조하세요.

다음 코드 예제에서는 delete-application을 사용하는 방법을 보여 줍니다.

AWS CLI

애플리케이션 삭제

다음 delete-application 예제에서는 지정된 애플리케이션을 삭제합니다.

aws appconfig delete-application \
--application-id 339ohji

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 AWS AppConfig 사용 설명서의 1단계: AWS AppConfig 애플리케이션 생성을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 DeleteApplication을 참조하세요.

다음 코드 예제에서는 delete-configuration-profile을 사용하는 방법을 보여 줍니다.

AWS CLI

구성 프로파일을 삭제하는 방법

다음 delete-configuration-profile 예제에서는 지정된 구성 프로파일을 삭제합니다.

aws appconfig delete-configuration-profile \
    --application-id 339ohji \
    --configuration-profile-id ur8hx2f

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 AWS AppConfig 사용 설명서의 3단계: 구성 및 구성 프로파일 생성을 참조하세요.

다음 코드 예제에서는 delete-deployment-strategy을 사용하는 방법을 보여 줍니다.

AWS CLI

배포 전략을 삭제하는 방법

다음 delete-deployment-strategy 예제에서는 지정된 배포 전략을 삭제합니다.

aws appconfig delete-deployment-strategy \
    --deployment-strategy-id 1225qzk

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 AWS AppConfig 사용 설명서의 4단계: 배포 전략 생성을 참조하세요.

다음 코드 예제에서는 delete-environment을 사용하는 방법을 보여 줍니다.

AWS CLI

환경을 삭제하려면

다음 delete-environment 예제에서는 지정된 애플리케이션 환경을 삭제합니다.

aws appconfig delete-environment \
    --application-id 339ohji \
    --environment-id 54j1r29

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 AWS AppConfig 사용 설명서의 2단계: 환경 생성을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 DeleteEnvironment를 참조하세요.

다음 코드 예제에서는 delete-extension-association을 사용하는 방법을 보여 줍니다.

AWS CLI

확장 연결을 삭제하는 방법

다음 delete-extension-association 예제에서는 AWS AppConfig에서 확장 연결을 삭제합니다.

aws appconfig delete-extension-association \
    --region us-west-2 \
    --extension-association-id a1b2c3d4

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 AWS AppConfig 사용 설명서의 AWS AppConfig 확장 작업을 참조하세요.

다음 코드 예제에서는 delete-extension을 사용하는 방법을 보여 줍니다.

AWS CLI

확장을 삭제하는 방법

다음 delete-extension 예제에서는 AWS AppConfig 에서 확장을 삭제합니다.

aws appconfig delete-extension \
    --region us-west-2 \
    --extension-identifier S3-backup-extension

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 AWS AppConfig 사용 설명서의 AWS AppConfig 확장 작업을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 DeleteExtension을 참조하세요.

다음 코드 예제에서는 delete-hosted-configuration-version을 사용하는 방법을 보여 줍니다.

AWS CLI

호스팅 구성 버전을 삭제하는 방법

다음 delete-hosted-configuration-version 예제에서는 AWS AppConfig 호스팅 구성 스토어에서 호스팅되는 구성 버전을 삭제합니다.

aws appconfig delete-hosted-configuration-version \
    --application-id 339ohji \
    --configuration-profile-id ur8hx2f \
    --version-number 1

출력:: 이 명령은 출력을 생성하지 않습니다.

자세한 내용은 AWS AppConfig 사용 설명서의 3단계: 구성 및 구성 프로파일 생성을 참조하세요.

다음 코드 예제에서는 get-application을 사용하는 방법을 보여 줍니다.

AWS CLI

애플리케이션의 세부 정보를 나열하는 방법

다음 get-application 예제에서는 지정된 애플리케이션의 세부 정보를 나열합니다.

aws appconfig get-application \
    --application-id 339ohji

출력:

{
    "Description": "An application used for creating an example.",
    "Id": "339ohji",
    "Name": "example-application"
}

자세한 내용은 AWS AppConfig 사용 설명서의 AWS AppConfig 작동 방식을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 GetApplication을 참조하세요.

다음 코드 예제에서는 get-configuration-profile을 사용하는 방법을 보여 줍니다.

AWS CLI

구성 프로파일 세부 정보를 검색하는 방법

다음 get-configuration-profile 예제에서는 지정된 구성 프로파일의 세부 정보를 반환합니다.

aws appconfig get-configuration-profile \
    --application-id 339ohji \
    --configuration-profile-id ur8hx2f

출력:

{
    "ApplicationId": "339ohji",
    "Id": "ur8hx2f",
    "Name": "Example-Configuration-Profile",
    "LocationUri": "ssm-parameter://Example-Parameter",
    "RetrievalRoleArn": "arn:aws:iam::111122223333:role/Example-App-Config-Role"
}

자세한 내용은 AWS AppConfig 사용 설명서의 3단계: 구성 및 구성 프로파일 생성을 참조하세요.

다음 코드 예제에서는 get-configuration을 사용하는 방법을 보여 줍니다.

AWS CLI

구성 세부 정보를 검색하는 방법

다음 get-configuration 예제에서는 예제 애플리케이션의 구성 세부 정보를 반환합니다. 이후의 get-configuration에 대한 호출에서는 버전이 변경된 경우에만 애플리케이션의 구성을 업데이트하도록 client-configuration-version 파라미터를 사용합니다. 버전이 변경된 경우에만 구성을 업데이트하면 get-configuration을 호출하여 발생하는 초과 요금이 발생하지 않습니다.

aws appconfig get-configuration \
    --application "example-application" \
    --environment "Example-Environment" \
    --configuration "Example-Configuration-Profile" \
    --client-id "test-id" \
    configuration-output-file

configuration-output-file의 콘텐츠:

{ "Name": "ExampleApplication", "Id": ExampleID, "Rank": 7 }

출력:

{
    "ConfigurationVersion": "1",
    "ContentType": "application/json"
}

자세한 내용은 AWS AppConfig 사용 설명서의 6단계: 구성 수신을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 GetConfiguration을 참조하세요.

다음 코드 예제에서는 get-deployment-strategy을 사용하는 방법을 보여 줍니다.

AWS CLI

배포 전략의 세부 정보를 검색하는 방법

다음 get-deployment-strategy 예제에서는 지정된 배포 전략의 세부 정보를 나열합니다.

aws appconfig get-deployment-strategy \
    --deployment-strategy-id 1225qzk

출력:

{
    "Id": "1225qzk",
    "Name": "Example-Deployment",
    "DeploymentDurationInMinutes": 15,
    "GrowthType": "LINEAR",
    "GrowthFactor": 25.0,
    "FinalBakeTimeInMinutes": 0,
    "ReplicateTo": "SSM_DOCUMENT"
}

자세한 내용은 AWS AppConfig 사용 설명서의 4단계: 배포 전략 생성을 참조하세요.

다음 코드 예제에서는 get-deployment을 사용하는 방법을 보여 줍니다.

AWS CLI

배포 세부 정보를 검색하는 방법

다음 get-deployment 예제에서는 지정된 환경 및 배포의 애플리케이션에 대한 배포의 세부 정보를 나열합니다.

aws appconfig get-deployment \
    --application-id 339ohji \
    --environment-id 54j1r29 \
    --deployment-number 1

출력:

{
    "ApplicationId": "339ohji",
    "EnvironmentId": "54j1r29",
    "DeploymentStrategyId": "1225qzk",
    "ConfigurationProfileId": "ur8hx2f",
    "DeploymentNumber": 1,
    "ConfigurationName": "Example-Configuration-Profile",
    "ConfigurationLocationUri": "ssm-parameter://Example-Parameter",
    "ConfigurationVersion": "1",
    "DeploymentDurationInMinutes": 15,
    "GrowthType": "LINEAR",
    "GrowthFactor": 25.0,
    "FinalBakeTimeInMinutes": 0,
    "State": "COMPLETE",
    "EventLog": [
        {
            "EventType": "DEPLOYMENT_COMPLETED",
            "TriggeredBy": "APPCONFIG",
            "Description": "Deployment completed",
            "OccurredAt": "2021-09-17T21:59:03.888000+00:00"
        },
        {
            "EventType": "BAKE_TIME_STARTED",
            "TriggeredBy": "APPCONFIG",
            "Description": "Deployment bake time started",
            "OccurredAt": "2021-09-17T21:58:57.722000+00:00"
        },
        {
            "EventType": "PERCENTAGE_UPDATED",
            "TriggeredBy": "APPCONFIG",
            "Description": "Configuration available to 100.00% of clients",
            "OccurredAt": "2021-09-17T21:55:56.816000+00:00"
        },
        {
            "EventType": "PERCENTAGE_UPDATED",
            "TriggeredBy": "APPCONFIG",
            "Description": "Configuration available to 75.00% of clients",
            "OccurredAt": "2021-09-17T21:52:56.567000+00:00"
        },
        {
            "EventType": "PERCENTAGE_UPDATED",
            "TriggeredBy": "APPCONFIG",
            "Description": "Configuration available to 50.00% of clients",
            "OccurredAt": "2021-09-17T21:49:55.737000+00:00"
        },
        {
            "EventType": "PERCENTAGE_UPDATED",
            "TriggeredBy": "APPCONFIG",
            "Description": "Configuration available to 25.00% of clients",
            "OccurredAt": "2021-09-17T21:46:55.187000+00:00"
        },
        {
            "EventType": "DEPLOYMENT_STARTED",
            "TriggeredBy": "USER",
            "Description": "Deployment started",
            "OccurredAt": "2021-09-17T21:43:54.205000+00:00"
        }
    ],
    "PercentageComplete": 100.0,
    "StartedAt": "2021-09-17T21:43:54.205000+00:00",
    "CompletedAt": "2021-09-17T21:59:03.888000+00:00"
}

자세한 내용은 AWS AppConfig 사용 설명서의 5단계: 구성 배포를 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 GetDeployment를 참조하세요.

다음 코드 예제에서는 get-environment을 사용하는 방법을 보여 줍니다.

AWS CLI

환경 세부 정보를 검색하는 방법

다음 get-environment 예제에서는 지정된 환경의 세부 정보 및 상태를 반환합니다.

aws appconfig get-environment \
    --application-id 339ohji \
    --environment-id 54j1r29

출력:

{
    "ApplicationId": "339ohji",
    "Id": "54j1r29",
    "Name": "Example-Environment",
    "State": "ReadyForDeployment"
}

자세한 내용은 AWS AppConfig 사용 설명서의 2단계: 환경 생성을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 GetEnvironment를 참조하세요.

다음 코드 예제에서는 get-extension-association을 사용하는 방법을 보여 줍니다.

AWS CLI

확장 연결 세부 정보를 가져오는 방법

다음 get-extension-association 예제에서는 확장 연결에 대한 정보를 표시합니다.

aws appconfig get-extension-association \
    --region us-west-2 \
    --extension-association-id a1b2c3d4

출력:

{
    "Id": "a1b2c3d4",
    "ExtensionArn": "arn:aws:appconfig:us-west-2:123456789012:extension/S3-backup-extension/1",
    "ResourceArn": "arn:aws:appconfig:us-west-2:123456789012:application/Finance",
    "Parameters": {
        "S3bucket": "FinanceConfigurationBackup"
    },
    "ExtensionVersionNumber": 1
}

자세한 내용은 AWS AppConfig 사용 설명서의 AWS AppConfig 확장 작업을 참조하세요.

다음 코드 예제에서는 get-extension을 사용하는 방법을 보여 줍니다.

AWS CLI

확장 세부 정보를 가져오는 방법

다음 get-extension 예제에서는 확장에 대한 정보를 표시합니다.

aws appconfig get-extension \
    --region us-west-2 \
    --extension-identifier S3-backup-extension

출력:

{
    "Id": "1A2B3C4D",
    "Name": "S3-backup-extension",
    "VersionNumber": 1,
    "Arn": "arn:aws:appconfig:us-west-2:123456789012:extension/S3-backup-extension/1",
    "Actions": {
        "PRE_CREATE_HOSTED_CONFIGURATION_VERSION": [
            {
                "Name": "S3backup",
                "Uri": "arn:aws:lambda:us-west-2:123456789012:function:S3backupfunction",
                "RoleArn": "arn:aws:iam::123456789012:role/appconfigextensionrole"
            }
        ]
    },
    "Parameters": {
        "S3bucket": {
            "Required": true
        }
    }
}

자세한 내용은 AWS AppConfig 사용 설명서의 AWS AppConfig 확장 작업을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 GetExtension을 참조하세요.

다음 코드 예제에서는 get-hosted-configuration-version을 사용하는 방법을 보여 줍니다.

AWS CLI

호스팅 구성 세부 정보를 검색하는 방법

다음 get-hosted-configuration-version 예제에서는 AWS AppConfig 호스팅 구성의 구성 세부 정보를 검색합니다.

aws appconfig get-hosted-configuration-version \
    --application-id 339ohji \
    --configuration-profile-id ur8hx2f \
    --version-number 1 \
    hosted-configuration-version-output

hosted-configuration-version-output의 콘텐츠:

{ "Name": "ExampleApplication", "Id": ExampleID, "Rank": 7 }

출력:

{
    "ApplicationId": "339ohji",
    "ConfigurationProfileId": "ur8hx2f",
    "VersionNumber": "1",
    "ContentType": "application/json"
}

자세한 내용은 AWS AppConfig 사용 설명서의 AWS AppConfig 호스팅 구성 스토어 정보를 참조하세요.

다음 코드 예제에서는 list-applications을 사용하는 방법을 보여 줍니다.

AWS CLI

사용 가능한 애플리케이션을 나열하는 방법

다음 list-applications 예제에서는 AWS 계정에서 사용 가능한 애플리케이션을 나열합니다.

aws appconfig list-applications

출력:

{
    "Items": [
        {
            "Id": "339ohji",
            "Name": "test-application",
            "Description": "An application used for creating an example."
        },
        {
            "Id": "rwalwu7",
            "Name": "Test-Application"
        }
    ]
}

자세한 내용은 AWS AppConfig 사용 설명서의 1단계: AWS AppConfig 애플리케이션 생성을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 ListApplications을 참조하세요.

다음 코드 예제에서는 list-configuration-profiles을 사용하는 방법을 보여 줍니다.

AWS CLI

사용 가능한 구성 프로파일을 나열하는 방법

다음 list-configuration-profiles 예제에서는 지정된 애플리케이션에 대해 사용 가능한 구성 프로파일을 나열합니다.

aws appconfig list-configuration-profiles \
    --application-id 339ohji

출력:

{
    "Items": [
        {
            "ApplicationId": "339ohji",
            "Id": "ur8hx2f",
            "Name": "Example-Configuration-Profile",
            "LocationUri": "ssm-parameter://Example-Parameter"
        }
    ]
}

자세한 내용은 AWS AppConfig 사용 설명서의 3단계: 구성 및 구성 프로파일 생성을 참조하세요.

다음 코드 예제에서는 list-deployment-strategies을 사용하는 방법을 보여 줍니다.

AWS CLI

사용 가능한 배포 전략을 나열하는 방법

다음 list-deployment-strategies 예제에서는 AWS 계정에서 사용 가능한 배포 전략을 나열합니다.

aws appconfig list-deployment-strategies

출력:

{
    "Items": [
        {
            "Id": "1225qzk",
            "Name": "Example-Deployment",
            "DeploymentDurationInMinutes": 15,
            "GrowthType": "LINEAR",
            "GrowthFactor": 25.0,
            "FinalBakeTimeInMinutes": 0,
            "ReplicateTo": "SSM_DOCUMENT"
        },
        {
            "Id": "AppConfig.AllAtOnce",
            "Name": "AppConfig.AllAtOnce",
            "Description": "Quick",
            "DeploymentDurationInMinutes": 0,
            "GrowthType": "LINEAR",
            "GrowthFactor": 100.0,
            "FinalBakeTimeInMinutes": 10,
            "ReplicateTo": "NONE"
        },
        {
            "Id": "AppConfig.Linear50PercentEvery30Seconds",
            "Name": "AppConfig.Linear50PercentEvery30Seconds",
            "Description": "Test/Demo",
            "DeploymentDurationInMinutes": 1,
            "GrowthType": "LINEAR",
            "GrowthFactor": 50.0,
            "FinalBakeTimeInMinutes": 1,
            "ReplicateTo": "NONE"
        },
        {
            "Id": "AppConfig.Canary10Percent20Minutes",
            "Name": "AppConfig.Canary10Percent20Minutes",
            "Description": "AWS Recommended",
            "DeploymentDurationInMinutes": 20,
            "GrowthType": "EXPONENTIAL",
            "GrowthFactor": 10.0,
            "FinalBakeTimeInMinutes": 10,
            "ReplicateTo": "NONE"
        }
    ]
}

자세한 내용은 AWS AppConfig 사용 설명서의 4단계: 배포 전략 생성을 참조하세요.

다음 코드 예제에서는 list-deployments을 사용하는 방법을 보여 줍니다.

AWS CLI

사용 가능한 배포를 나열하는 방법

다음 list-deployments 예제에서는 지정된 애플리케이션 및 환경에 대해 AWS 계정에서 사용 가능한 배포를 나열합니다.

aws appconfig list-deployments \
    --application-id 339ohji \
    --environment-id 54j1r29

출력:

{
    "Items": [
        {
            "DeploymentNumber": 1,
            "ConfigurationName": "Example-Configuration-Profile",
            "ConfigurationVersion": "1",
            "DeploymentDurationInMinutes": 15,
            "GrowthType": "LINEAR",
            "GrowthFactor": 25.0,
            "FinalBakeTimeInMinutes": 0,
            "State": "COMPLETE",
            "PercentageComplete": 100.0,
            "StartedAt": "2021-09-17T21:43:54.205000+00:00",
            "CompletedAt": "2021-09-17T21:59:03.888000+00:00"
        }
    ]
}

자세한 내용은 AWS AppConfig 사용 설명서의 5단계: 구성 배포를 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 ListDeployments를 참조하세요.

다음 코드 예제에서는 list-environments을 사용하는 방법을 보여 줍니다.

AWS CLI

사용 가능한 환경을 나열하는 방법

다음 list-environments 예제에서는 지정된 애플리케이션에 대해 AWS 계정에서 사용 가능한 환경을 나열합니다.

aws appconfig list-environments \
    --application-id 339ohji

출력:

{
    "Items": [
        {
            "ApplicationId": "339ohji",
            "Id": "54j1r29",
            "Name": "Example-Environment",
            "State": "ReadyForDeployment"
        }
    ]
}

자세한 내용은 AWS AppConfig 사용 설명서의 2단계: 환경 생성을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 ListEnvironments를 참조하세요.

다음 코드 예제에서는 list-extension-associations을 사용하는 방법을 보여 줍니다.

AWS CLI

AWS 리전에 대한 AWS 계정 내 모든 AWS AppConfig 확장 연결을 나열하는 방법

다음 list-extension-associations 예제에서는 특정 AWS 리전에서 현재 AWS 계정에 대한 모든 AWS AppConfig 확장 연결을 나열합니다.

aws appconfig list-extension-associations \
    --region us-west-2

출력:

{
    "Items": [
        {
            "Id": "a1b2c3d4",
            "ExtensionArn": "arn:aws:appconfig:us-west-2:123456789012:extension/S3-backup-extension/1",
            "ResourceArn": "arn:aws:appconfig:us-west-2:123456789012:application/Finance"
        }
    ]
}

자세한 내용은 AWS AppConfig 사용 설명서의 AWS AppConfig 확장 작업을 참조하세요.

다음 코드 예제에서는 list-extensions을 사용하는 방법을 보여 줍니다.

AWS CLI

AWS 리전에 대한 AWS 계정 내 모든 AWS AppConfig 확장을 나열하는 방법

다음 list-extensions 예제에서는 특정 AWS 리전에서 현재 AWS 계정에 대한 모든 AWS AppConfig 확장을 나열합니다. 이 명령은 사용자 지정 확장과 AWS 작성된 확장을 반환합니다.

aws appconfig list-extensions \
    --region us-west-2

출력:

{
    "Items": [
        {
            "Id": "1A2B3C4D",
            "Name": "S3-backup-extension",
            "VersionNumber": 1,
            "Arn": "arn:aws:appconfig:us-west-2:123456789012:extension/1A2B3C4D/1"
        },
        {
            "Id": "AWS.AppConfig.FeatureFlags",
            "Name": "AppConfig Feature Flags Helper",
            "VersionNumber": 1,
            "Arn": "arn:aws:appconfig:us-west-2::extension/AWS.AppConfig.FeatureFlags/1",
            "Description": "Validates AppConfig feature flag data automatically against a JSON schema that includes structure and constraints. Also transforms feature flag data prior to sending to the client. This extension is automatically associated to configuration profiles with type \"AWS.AppConfig.FeatureFlags\"."
        },
        {
            "Id": "AWS.AppConfig.JiraIntegration",
            "Name": "AppConfig integration with Atlassian Jira",
            "VersionNumber": 1,
            "Arn": "arn:aws:appconfig:us-west-2::extension/AWS.AppConfig.JiraIntegration/1",
            "Description": "Exports feature flag data from AWS AppConfig into Jira. The lifecycle of each feature flag in AppConfig is tracked in Jira as an individual issue. Customers can see in Jira when flags are updated, turned on or off. Works in conjunction with the AppConfig app in the Atlassian Marketplace and is automatically associated to configuration profiles configured within that app."
        },
        {
            "Id": "AWS.AppConfig.DeploymentNotificationsToEventBridge",
            "Name": "AppConfig deployment events to Amazon EventBridge",
            "VersionNumber": 1,
            "Arn": "arn:aws:appconfig:us-west-2::extension/AWS.AppConfig.DeploymentNotificationsToEventBridge/1",
            "Description": "Sends events to Amazon EventBridge when a deployment of configuration data in AppConfig is started, completed, or rolled back. Can be associated to the following resources in AppConfig: Application, Environment, Configuration Profile."
        },
        {
            "Id": "AWS.AppConfig.DeploymentNotificationsToSqs",
            "Name": "AppConfig deployment events to Amazon SQS",
            "VersionNumber": 1,
            "Arn": "arn:aws:appconfig:us-west-2::extension/AWS.AppConfig.DeploymentNotificationsToSqs/1",
            "Description": "Sends messages to the configured Amazon SQS queue when a deployment of configuration data in AppConfig is started, completed, or rolled back. Can be associated to the following resources in AppConfig: Application, Environment, Configuration Profile."
        },
        {
            "Id": "AWS.AppConfig.DeploymentNotificationsToSns",
            "Name": "AppConfig deployment events to Amazon SNS",
            "VersionNumber": 1,
            "Description": "Sends events to the configured Amazon SNS topic when a deployment of configuration data in AppConfig is started, completed, or rolled back. Can be associated to the following resources in AppConfig: Application, Environment, Configuration Profile."
        }
    ]
}

자세한 내용은 AWS AppConfig 사용 설명서의 AWS AppConfig 확장 작업을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 ListExtensions를 참조하세요.

다음 코드 예제에서는 list-hosted-configuration-versions을 사용하는 방법을 보여 줍니다.

AWS CLI

사용 가능한 호스팅 구성 버전을 나열하는 방법

다음 list-hosted-configuration-versions 예제에서는 지정된 애플리케이션 및 구성 프로파일에 대해 AWS AppConfig 호스팅 구성 스토어에서 호스팅되는 구성 버전을 나열합니다.

aws appconfig list-hosted-configuration-versions \
    --application-id 339ohji \
    --configuration-profile-id ur8hx2f

출력:

{
    "Items": [
        {
            "ApplicationId": "339ohji",
            "ConfigurationProfileId": "ur8hx2f",
            "VersionNumber": 1,
            "ContentType": "application/json"
        }
    ]
}

자세한 내용은 AWS AppConfig 사용 설명서의 AWS AppConfig 호스팅 구성 스토어 정보를 참조하세요.

다음 코드 예제에서는 list-tags-for-resource을 사용하는 방법을 보여 줍니다.

AWS CLI

애플리케이션의 태그를 나열하는 방법

다음 list-tags-for-resource 예제에서는 지정된 애플리케이션의 태그를 나열합니다.

aws appconfig list-tags-for-resource \
    --resource-arn arn:aws:appconfig:us-east-1:682428703967:application/339ohji

출력:

{
    "Tags": {
        "group1": "1"
    }
}

자세한 내용은 AWS AppConfig 사용 설명서의 1단계: AWS AppConfig 애플리케이션 생성을 참조하세요.

다음 코드 예제에서는 start-deployment을 사용하는 방법을 보여 줍니다.

AWS CLI

구성 배포를 시작하는 방법

다음 start-deployment 예제에서는 지정된 환경, 배포 전략 및 구성 프로파일을 사용하여 애플리케이션에 대한 배포를 시작합니다.

aws appconfig start-deployment \
    --application-id 339ohji \
    --environment-id 54j1r29 \
    --deployment-strategy-id 1225qzk \
    --configuration-profile-id ur8hx2f \
    --configuration-version 1

출력:

{
    "ApplicationId": "339ohji",
    "EnvironmentId": "54j1r29",
    "DeploymentStrategyId": "1225qzk",
    "ConfigurationProfileId": "ur8hx2f",
    "DeploymentNumber": 1,
    "ConfigurationName": "Example-Configuration-Profile",
    "ConfigurationLocationUri": "ssm-parameter://Example-Parameter",
    "ConfigurationVersion": "1",
    "DeploymentDurationInMinutes": 15,
    "GrowthType": "LINEAR",
    "GrowthFactor": 25.0,
    "FinalBakeTimeInMinutes": 0,
    "State": "DEPLOYING",
    "EventLog": [
        {
            "EventType": "DEPLOYMENT_STARTED",
            "TriggeredBy": "USER",
            "Description": "Deployment started",
            "OccurredAt": "2021-09-17T21:43:54.205000+00:00"
        }
    ],
    "PercentageComplete": 0.0,
    "StartedAt": "2021-09-17T21:43:54.205000+00:00"
}

자세한 내용은 AWS AppConfig 사용 설명서의 5단계: 구성 배포를 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 StartDeployment를 참조하세요.

다음 코드 예제에서는 stop-deployment을 사용하는 방법을 보여 줍니다.

AWS CLI

구성 배포를 중지하는 방법

다음 stop-deployment 예제에서는 지정된 환경에 대한 애플리케이션 구성 배포를 중지합니다.

aws appconfig stop-deployment \
    --application-id 339ohji \
    --environment-id 54j1r29 \
    --deployment-number 2

출력:

{
    "DeploymentNumber": 0,
    "DeploymentDurationInMinutes": 0,
    "GrowthFactor": 0.0,
    "FinalBakeTimeInMinutes": 0,
    "PercentageComplete": 0.0
}

자세한 내용은 AWS AppConfig 사용 설명서의 5단계: 구성 배포를 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 StopDeployment를 참조하세요.

다음 코드 예제에서는 tag-resource을 사용하는 방법을 보여 줍니다.

AWS CLI

애플리케이션에 태그를 지정하는 방법

다음 tag-resource 예제에서는 애플리케이션 리소스에 태그를 지정합니다.

aws appconfig tag-resource \
    --resource-arn arn:aws:appconfig:us-east-1:682428703967:application/339ohji \
    --tags '{"group1" : "1"}'

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 AWS AppConfig 사용 설명서의 1단계: AWS AppConfig 애플리케이션 생성을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 TagResource를 참조하세요.

다음 코드 예제에서는 untag-resource을 사용하는 방법을 보여 줍니다.

AWS CLI

애플리케이션에서 태그를 제거하는 방법

다음 untag-resource 예제에서는 지정된 애플리케이션에서 group1 태그를 제거합니다.

aws appconfig untag-resource \
    --resource-arn arn:aws:appconfig:us-east-1:111122223333:application/339ohji \
    --tag-keys '["group1"]'

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 AWS AppConfig 사용 설명서의 1단계: AWS AppConfig 애플리케이션 생성을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 UntagResource를 참조하세요.

다음 코드 예제에서는 update-application을 사용하는 방법을 보여 줍니다.

AWS CLI

애플리케이션을 업데이트하는 방법

다음 update-application 예제에서는 지정된 애플리케이션의 이름을 업데이트합니다.

aws appconfig update-application \
    --application-id 339ohji \
    --name "Example-Application"

출력:

{
    "Id": "339ohji",
    "Name": "Example-Application",
    "Description": "An application used for creating an example."
}

자세한 내용은 AWS AppConfig 사용 설명서의 1단계: AWS AppConfig 애플리케이션 생성을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 UpdateApplication을 참조하세요.

다음 코드 예제에서는 update-configuration-profile을 사용하는 방법을 보여 줍니다.

AWS CLI

구성 프로파일을 업데이트하는 방법

다음 update-configuration-profile 예제에서는 지정된 구성 프로파일의 설명을 업데이트합니다.

aws appconfig update-configuration-profile \
    --application-id 339ohji \
    --configuration-profile-id ur8hx2f \
    --description "Configuration profile used for examples."

출력:

{
    "ApplicationId": "339ohji",
    "Id": "ur8hx2f",
    "Name": "Example-Configuration-Profile",
    "Description": "Configuration profile used for examples.",
    "LocationUri": "ssm-parameter://Example-Parameter",
    "RetrievalRoleArn": "arn:aws:iam::111122223333:role/Example-App-Config-Role"
}

자세한 내용은 AWS AppConfig 사용 설명서의 3단계: 구성 및 구성 프로파일 생성을 참조하세요.

다음 코드 예제에서는 update-deployment-strategy을 사용하는 방법을 보여 줍니다.

AWS CLI

배포 전략을 업데이트하는 방법

다음 update-deployment-strategy 예제에서는 지정된 배포 전략에서 최종 베이크 소요 시간을 20분으로 업데이트합니다.

aws appconfig update-deployment-strategy \
    --deployment-strategy-id 1225qzk \
    --final-bake-time-in-minutes 20

출력:

{
    "Id": "1225qzk",
    "Name": "Example-Deployment",
    "DeploymentDurationInMinutes": 15,
    "GrowthType": "LINEAR",
    "GrowthFactor": 25.0,
    "FinalBakeTimeInMinutes": 20,
    "ReplicateTo": "SSM_DOCUMENT"
}

자세한 내용은 AWS AppConfig 사용 설명서의 4단계: 배포 전략 생성을 참조하세요.

다음 코드 예제에서는 update-environment을 사용하는 방법을 보여 줍니다.

AWS CLI

환경을 업데이트하는 방법

다음 update-environment 예제에서는 환경의 설명을 업데이트합니다.

aws appconfig update-environment \
    --application-id 339ohji \
    --environment-id 54j1r29 \
    --description "An environment for examples."

출력:

{
    "ApplicationId": "339ohji",
    "Id": "54j1r29",
    "Name": "Example-Environment",
    "Description": "An environment for examples.",
    "State": "RolledBack"
}

자세한 내용은 AWS AppConfig 사용 설명서의 2단계: 환경 생성을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 UpdateEnvironment를 참조하세요.

다음 코드 예제에서는 update-extension-association을 사용하는 방법을 보여 줍니다.

AWS CLI

AWS AppConfig 확장 연결을 업데이트하는 방법

다음 update-extension-association 예제에서는 AWS AppConfig에서 확장 연결에 새 파라미터 값을 추가합니다.

aws appconfig update-extension-association \
    --region us-west-2 \
    --extension-association-id a1b2c3d4 \
    --parameters S3bucket=FinanceMobileApp

출력:

{
    "Id": "a1b2c3d4",
    "ExtensionArn": "arn:aws:appconfig:us-west-2:123456789012:extension/S3-backup-extension/1",
    "ResourceArn": "arn:aws:appconfig:us-west-2:123456789012:application/Finance",
    "Parameters": {
        "S3bucket": "FinanceMobileApp"
    },
    "ExtensionVersionNumber": 1
}

자세한 내용은 AWS AppConfig 사용 설명서의 AWS AppConfig 확장 작업을 참조하세요.

다음 코드 예제에서는 update-extension을 사용하는 방법을 보여 줍니다.

AWS CLI

AWS AppConfig 확장을 업데이트하는 방법

다음 update-extension 예제에서는 AWS AppConfig에서 확장에 추가 파라미터 키를 추가합니다.

aws appconfig update-extension \
    --region us-west-2 \
    --extension-identifier S3-backup-extension \
    --parameters S3bucket={Required=true},CampaignID={Required=false}

출력:

{
    "Id": "1A2B3C4D",
    "Name": "S3-backup-extension",
    "VersionNumber": 1,
    "Arn": "arn:aws:appconfig:us-west-2:123456789012:extension/1A2B3C4D/1",
    "Actions": {
        "PRE_CREATE_HOSTED_CONFIGURATION_VERSION": [
            {
                "Name": "S3backup",
                "Uri": "arn:aws:lambda:us-west-2:123456789012:function:S3backupfunction",
                "RoleArn": "arn:aws:iam::123456789012:role/appconfigextensionrole"
            }
        ]
    },
    "Parameters": {
        "CampaignID": {
            "Required": false
        },
        "S3bucket": {
            "Required": true
        }
    }
}

자세한 내용은 AWS AppConfig 사용 설명서의 AWS AppConfig 확장 작업을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 UpdateExtension을 참조하세요.

다음 코드 예제에서는 validate-configuration을 사용하는 방법을 보여 줍니다.

AWS CLI

구성을 검증하는 방법

다음 validate-configuration 예제에서는 구성 프로파일에서 유효성 검사기를 사용하여 구성을 검증합니다.

aws appconfig validate-configuration \
    --application-id abc1234 \
    --configuration-profile-id ur8hx2f \
    --configuration-version 1

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 AWS AppConfig 사용 설명서의 3단계: 구성 및 구성 프로파일 생성을 참조하세요.