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

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

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

AWS Proton 사용 예제 AWS CLI

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

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

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

주제

작업

다음 코드 예시에서는 cancel-service-instance-deployment을 사용하는 방법을 보여 줍니다.

AWS CLI

서비스 인스턴스 배포를 취소하려면

다음 cancel-service-instance-deployment 예제에서는 서비스 인스턴스 배포를 취소합니다.

aws proton cancel-service-instance-deployment \
    --service-instance-name "instance-one" \
    --service-name "simple-svc"

출력:

{
    "serviceInstance": {
        "arn": "arn:aws:proton:region-id:123456789012:service/simple-svc/service-instance/instance-one",
        "createdAt": "2021-04-02T21:29:59.962000+00:00",
        "deploymentStatus": "CANCELLING",
        "environmentName": "simple-env",
        "lastDeploymentAttemptedAt": "2021-04-02T21:45:15.406000+00:00",
        "lastDeploymentSucceededAt": "2021-04-02T21:38:00.823000+00:00",
        "name": "instance-one",
        "serviceName": "simple-svc",
        "spec": "proton: ServiceSpec\npipeline:\n  my_sample_pipeline_optional_input: abc\n  my_sample_pipeline_required_input: '123'\ninstances:\n- name: my-instance\n  environment: MySimpleEnv\n  spec:\n    my_sample_service_instance_optional_input: def\n    my_sample_service_instance_required_input: '456'\n- name: my-other-instance\n  environment: MySimpleEnv\n  spec:\n    my_sample_service_instance_required_input: '789'\n",
        "templateMajorVersion": "1",
        "templateMinorVersion": "1",
        "templateName": "svc-simple"
    }
}

자세한 내용은 AWS Proton 관리자 안내서의 서비스 인스턴스 업데이트 또는 AWS Proton 사용 설명서의 서비스 인스턴스 업데이트를 참조하세요.

다음 코드 예시에서는 cancel-service-pipeline-deployment을 사용하는 방법을 보여 줍니다.

AWS CLI

서비스 파이프라인 배포를 취소하려면

다음 cancel-service-pipeline-deployment 예제에서는 서비스 파이프라인 배포를 취소합니다.

aws proton cancel-service-pipeline-deployment \
    --service-name "simple-svc"

출력:

{
    "pipeline": {
        "arn": "arn:aws:proton:region-id:123456789012:service/simple-svc/pipeline",
        "createdAt": "2021-04-02T21:29:59.962000+00:00",
        "deploymentStatus": "CANCELLING",
        "lastDeploymentAttemptedAt": "2021-04-02T22:02:45.095000+00:00",
        "lastDeploymentSucceededAt": "2021-04-02T21:39:28.991000+00:00",
        "templateMajorVersion": "1",
        "templateMinorVersion": "1",
        "templateName": "svc-simple"
    }
}

자세한 내용은 AWS Proton 관리자 안내서의 서비스 파이프라인 업데이트 또는 AWS Proton 사용 설명서의 서비스 파이프라인 업데이트를 참조하세요.

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

AWS CLI

서비스를 생성하려면

다음 create-service 예제에서는 서비스 파이프라인을 사용하여 서비스를 생성합니다.

aws proton create-service \
    --name "MySimpleService" \
    --template-name "fargate-service" \
    --template-major-version "1" \
    --branch-name "mainline" \
    --repository-connection-arn "arn:aws:codestar-connections:region-id:account-id:connection/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" \
    --repository-id "myorg/myapp" \
    --spec file://spec.yaml

spec.yaml의 콘텐츠:

proton: ServiceSpec

pipeline:
    my_sample_pipeline_required_input: "hello"
    my_sample_pipeline_optional_input: "bye"

instances:
    - name: "acme-network-dev"
        environment: "ENV_NAME"
        spec:
            my_sample_service_instance_required_input: "hi"
            my_sample_service_instance_optional_input: "ho"

출력:

{
    "service": {
        "arn": "arn:aws:proton:region-id:123456789012:service/MySimpleService",
        "createdAt": "2020-11-18T19:50:27.460000+00:00",
        "lastModifiedAt": "2020-11-18T19:50:27.460000+00:00",
        "name": "MySimpleService",
        "repositoryConnectionArn": "arn:aws:codestar-connections:region-id:123456789012connection/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "repositoryId": "myorg/myapp",
        "status": "CREATE_IN_PROGRESS",
        "templateName": "fargate-service"
    }
}

자세한 내용은 AWS Proton 관리자 안내서의 서비스 생성 및 AWS Proton 사용 설명서의 서비스 생성을 참조하세요.

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

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

AWS CLI

서비스를 삭제하는 방법

다음 delete-service 예제에서는 서비스를 삭제합니다.

aws proton delete-service \
    --name "simple-svc"

출력:

{
    "service": {
        "arn": "arn:aws:proton:region-id:123456789012:service/simple-svc",
        "branchName": "mainline",
        "createdAt": "2020-11-28T22:40:50.512000+00:00",
        "description": "Edit by updating description",
        "lastModifiedAt": "2020-11-29T00:30:39.248000+00:00",
        "name": "simple-svc",
        "repositoryConnectionArn": "arn:aws:codestar-connections:region-id:123456789012:connection/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "repositoryId": "myorg/myapp",
        "status": "DELETE_IN_PROGRESS",
        "templateName": "fargate-service"
    }
}

자세한 내용은 AWS Proton 관리자 안내서의 서비스 삭제를 참조하세요.

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

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

AWS CLI

서비스 인스턴스 세부 정보를 가져오려면

다음 get-service-instance 예제에서는 서비스 인스턴스에 대한 세부 데이터를 가져옵니다.

aws proton get-service-instance \
    --name "instance-one" \
    --service-name "simple-svc"

출력:

{
    "serviceInstance": {
        "arn": "arn:aws:proton:region-id:123456789012:service/simple-svc/service-instance/instance-one",
        "createdAt": "2020-11-28T22:40:50.512000+00:00",
        "deploymentStatus": "SUCCEEDED",
        "environmentName": "simple-env",
        "lastDeploymentAttemptedAt": "2020-11-28T22:40:50.512000+00:00",
        "lastDeploymentSucceededAt": "2020-11-28T22:40:50.512000+00:00",
        "name": "instance-one",
        "serviceName": "simple-svc",
        "spec": "proton: ServiceSpec\npipeline:\n  my_sample_pipeline_optional_input: hello world\n  my_sample_pipeline_required_input: pipeline up\ninstances:\n- name: instance-one\n  environment: my-simple-env\n  spec:\n    my_sample_service_instance_optional_input: Ola\n    my_sample_service_instance_required_input: Ciao\n",
        "templateMajorVersion": "1",
        "templateMinorVersion": "0",
        "templateName": "svc-simple"
    }
}

자세한 내용은 AWS Proton 관리자 안내서의 서비스 데이터 보기 또는 AWS Proton 사용 설명서의 서비스 데이터 보기를 참조하세요.

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

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

AWS CLI

서비스 세부 정보를 가져오려면

다음 get-service 예제에서는 서비스에 대한 세부 데이터를 가져옵니다.

aws proton get-service \
    --name "simple-svc"

출력:

{
    "service": {
        "arn": "arn:aws:proton:region-id:123456789012:service/simple-svc",
        "branchName": "mainline",
        "createdAt": "2020-11-28T22:40:50.512000+00:00",
        "lastModifiedAt": "2020-11-28T22:44:51.207000+00:00",
        "name": "simple-svc",
        "pipeline": {
            "arn": "arn:aws:proton:region-id:123456789012:service/simple-svc/pipeline/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
            "createdAt": "2020-11-28T22:40:50.512000+00:00",
            "deploymentStatus": "SUCCEEDED",
            "lastDeploymentAttemptedAt": "2020-11-28T22:40:50.512000+00:00",
            "lastDeploymentSucceededAt": "2020-11-28T22:40:50.512000+00:00",
            "spec": "proton: ServiceSpec\npipeline:\n  my_sample_pipeline_required_input: hello\n  my_sample_pipeline_optional_input: bye\ninstances:\n- name: instance-svc-simple\n  environment: my-simple-env\n  spec:\n    my_sample_service_instance_required_input: hi\n    my_sample_service_instance_optional_input: ho\n",
            "templateMajorVersion": "1",
            "templateMinorVersion": "1",
            "templateName": "svc-simple"
        },
        "repositoryConnectionArn": "arn:aws:codestar-connections:region-id:123456789012:connection/a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
        "repositoryId": "myorg/myapp",
        "spec": "proton: ServiceSpec\npipeline:\n  my_sample_pipeline_required_input: hello\n  my_sample_pipeline_optional_input: bye\ninstances:\n- name: instance-svc-simple\n  environment: my-simple-env\n  spec:\n    my_sample_service_instance_required_input: hi\n    my_sample_service_instance_optional_input: ho\n",
        "status": "ACTIVE",
        "templateName": "svc-simple"
    }
}

자세한 내용은 AWS Proton 관리자 안내서의 서비스 데이터 보기 또는 AWS Proton 사용 설명서의 서비스 데이터 보기를 참조하세요.

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

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

AWS CLI

예제 1: 모든 서비스 인스턴스 나열

다음 list-service-instances 예제에서는 서비스 인스턴스를 나열합니다.

aws proton list-service-instances

출력:

{
    "serviceInstances": [
        {
            "arn": "arn:aws:proton:region-id:123456789012:service/simple-svc/service-instance/instance-one",
            "createdAt": "2020-11-28T22:40:50.512000+00:00",
            "deploymentStatus": "SUCCEEDED",
            "environmentArn": "arn:aws:proton:region-id:123456789012:environment/simple-env",
            "lastDeploymentAttemptedAt": "2020-11-28T22:40:50.512000+00:00",
            "lastDeploymentSucceededAt": "2020-11-28T22:40:50.512000+00:00",
            "name": "instance-one",
            "serviceName": "simple-svc",
            "templateMajorVersion": "1",
            "templateMinorVersion": "0",
            "templateName": "fargate-service"
        }
    ]
}

자세한 내용은 AWS Proton 관리자 안내서의 서비스 인스턴스 데이터 보기 또는 AWS Proton 사용 설명서의 서비스 인스턴스 데이터 보기를 참조하세요.

예제 2: 지정된 서비스 인스턴스를 나열하려면

다음 get-service-instance 예제에서는 서비스 인스턴스를 가져옵니다.

aws proton get-service-instance \
    --name "instance-one" \
    --service-name "simple-svc"

출력:

{
    "serviceInstance": {
        "arn": "arn:aws:proton:region-id:123456789012:service/simple-svc/service-instance/instance-one",
        "createdAt": "2020-11-28T22:40:50.512000+00:00",
        "deploymentStatus": "SUCCEEDED",
        "environmentName": "simple-env",
        "lastDeploymentAttemptedAt": "2020-11-28T22:40:50.512000+00:00",
        "lastDeploymentSucceededAt": "2020-11-28T22:40:50.512000+00:00",
        "name": "instance-one",
        "serviceName": "simple-svc",
        "spec": "proton: ServiceSpec\npipeline:\n  my_sample_pipeline_optional_input: hello world\n  my_sample_pipeline_required_input: pipeline up\ninstances:\n- name: instance-one\n  environment: my-simple-env\n  spec:\n    my_sample_service_instance_optional_input: Ola\n    my_sample_service_instance_required_input: Ciao\n",
        "templateMajorVersion": "1",
        "templateMinorVersion": "0",
        "templateName": "svc-simple"
    }
}

자세한 내용은 AWS Proton 관리자 안내서의 서비스 인스턴스 데이터 보기 또는 AWS Proton 사용 설명서의 서비스 인스턴스 데이터 보기를 참조하세요.

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

AWS CLI

서비스 인스턴스를 새 마이너 버전으로 업데이트하려면

다음 update-service-instance 예제에서는 서비스 인스턴스를 서비스 템플릿의 새 마이너 버전으로 업데이트하고, 이 버전은 'my-other-instance'라는 새 인스턴스를 새로운 필수 입력과 함께 추가합니다.

aws proton update-service-instance \
    --service-name "simple-svc" \
    --spec "file://service-spec.yaml " \
    --template-major-version "1" \
    --template-minor-version "1" \
    --deployment-type "MINOR_VERSION" \
    --name "instance-one"

service-spec.yaml의 콘텐츠:

proton: ServiceSpec
pipeline:
    my_sample_pipeline_optional_input: "abc"
    my_sample_pipeline_required_input: "123"
instances:
    - name: "instance-one"
        environment: "simple-env"
        spec:
            my_sample_service_instance_optional_input: "def"
            my_sample_service_instance_required_input: "456"
    - name: "my-other-instance"
        environment: "simple-env"
        spec:
            my_sample_service_instance_required_input: "789"

출력:

{
    "serviceInstance": {
        "arn": "arn:aws:proton:region-id:123456789012:service/simple-svc/service-instance/instance-one",
        "createdAt": "2021-04-02T21:29:59.962000+00:00",
        "deploymentStatus": "IN_PROGRESS",
        "environmentName": "arn:aws:proton:region-id:123456789012:environment/simple-env",
        "lastDeploymentAttemptedAt": "2021-04-02T21:38:00.823000+00:00",
        "lastDeploymentSucceededAt": "2021-04-02T21:29:59.962000+00:00",
        "name": "instance-one",
        "serviceName": "simple-svc",
        "templateMajorVersion": "1",
        "templateMinorVersion": "0",
        "templateName": "svc-simple"
    }
}

자세한 내용은 AWS Proton 관리자 안내서의 서비스 인스턴스 업데이트 또는 AWS Proton 사용 설명서의 서비스 인스턴스 업데이트를 참조하세요.

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

AWS CLI

서비스 파이프라인을 업데이트하려면

다음 update-service-pipeline 예제에서는 서비스 파이프라인을 서비스 템플릿의 새 마이너 버전으로 업데이트합니다.

aws proton update-service-pipeline \
    --service-name "simple-svc" \
    --spec "file://service-spec.yaml" \
    --template-major-version "1" \
    --template-minor-version "1" \
    --deployment-type "MINOR_VERSION"

출력:

{
    "pipeline": {
        "arn": "arn:aws:proton:region-id:123456789012:service/simple-svc/pipeline/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "createdAt": "2021-04-02T21:29:59.962000+00:00",
        "deploymentStatus": "IN_PROGRESS",
        "lastDeploymentAttemptedAt": "2021-04-02T21:39:28.991000+00:00",
        "lastDeploymentSucceededAt": "2021-04-02T21:29:59.962000+00:00",
        "spec": "proton: ServiceSpec\n\npipeline:\n  my_sample_pipeline_optional_input: \"abc\"\n  my_sample_pipeline_required_input: \"123\"\n\ninstances:\n  - name: \"my-instance\"\n    environment: \"MySimpleEnv\"\n    spec:\n      my_sample_service_instance_optional_input: \"def\"\n      my_sample_service_instance_required_input: \"456\"\n  - name: \"my-other-instance\"\n    environment: \"MySimpleEnv\"\n    spec:\n      my_sample_service_instance_required_input: \"789\"\n",
        "templateMajorVersion": "1",
        "templateMinorVersion": "0",
        "templateName": "svc-simple"
    }
}

자세한 내용은 AWS Proton 관리자 안내서의 서비스 파이프라인 업데이트 또는 AWS Proton 사용 설명서의 서비스 파이프라인 업데이트를 참조하세요.

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

AWS CLI

서비스를 업데이트하려면

다음 update-service 예제에서는 서비스 설명을 편집합니다.

aws proton update-service \
    --name "MySimpleService" \
    --description "Edit by updating description"

출력:

{
    "service": {
        "arn": "arn:aws:proton:region-id:123456789012:service/MySimpleService",
        "branchName": "mainline",
        "createdAt": "2021-03-12T22:39:42.318000+00:00",
        "description": "Edit by updating description",
        "lastModifiedAt": "2021-03-12T22:44:21.975000+00:00",
        "name": "MySimpleService",
        "repositoryConnectionArn": "arn:aws:codestar-connections:region-id:123456789012:connection/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "repositoryId": "myorg/myapp",
        "status": "ACTIVE",
        "templateName": "fargate-service"
    }
}

자세한 내용은 AWS Proton 관리자 안내서의 서비스 편집 또는 AWS Proton 사용 설명서의 서비스 편집을 참조하세요.

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