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

이 설명서는 의 버전 1 AWS CLI 전용입니다. 의 버전 2와 관련된 설명서는 버전 2 사용 설명서 를 AWS CLI참조하세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

AWS AppConfig 사용 예제 AWS CLI

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

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

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

주제

작업

다음 코드 예시에서는 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 내용은 명령 참조CreateApplication의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 내용은 명령 참조CreateEnvironment의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 내용은 명령 참조CreateExtension의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 내용은 명령 참조DeleteApplication의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 내용은 명령 참조DeleteEnvironment의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 내용은 명령 참조DeleteExtension의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 내용은 명령 참조GetApplication의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 예제에서는 예제 애플리케이션의 구성 세부 정보를 반환합니다. 이후 구성 가져오기 호출에서는 버전이 변경된 경우에만 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 내용은 명령 참조GetConfiguration의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 내용은 명령 참조GetDeployment의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 내용은 명령 참조GetEnvironment의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 내용은 명령 참조GetExtension의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 내용은 명령 참조ListApplications의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 내용은 명령 참조ListDeployments의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 내용은 명령 참조ListEnvironments의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 내용은 명령 참조ListExtensions의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 애플리케이션 생성을 참조하세요.

  • 자세한 API 내용은 명령 참조ListTagsForResource의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 내용은 명령 참조StartDeployment의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 내용은 명령 참조StopDeployment의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 내용은 명령 참조TagResource의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 내용은 명령 참조UntagResource의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 내용은 명령 참조UpdateApplication의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 내용은 명령 참조UpdateEnvironment의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 내용은 명령 참조UpdateExtension의 섹션을 참조하세요. AWS CLI

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

AWS CLI

구성을 검증하려면

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

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

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

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