AWS CLI를 사용한 AWS Proton 예제

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

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

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

주제

작업

작업

다음 코드 예제에서는 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"
    }
}

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

API 세부 정보는 AWS CLI 명령 참조의 CancelServiceInstanceDeployment 섹션을 참조하세요.

다음 코드 예제에서는 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"
    }
}

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

API 세부 정보는 AWS CLI 명령 참조의 CancelServicePipelineDeployment 섹션을 참조하세요.

다음 코드 예제에서는 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"
    }
}

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

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

다음 코드 예제에서는 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 세부 정보는 AWS CLI 명령 참조의 DeleteService를 참조하세요.

다음 코드 예제에서는 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"
    }
}

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

API 세부 정보는 AWS CLI 명령 참조의 GetServiceInstance 섹션을 참조하세요.

다음 코드 예제에서는 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"
    }
}

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

API 세부 정보는 AWS CLI 명령 참조의 GetService 섹션을 참조하세요.

다음 코드 예제에서는 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"
        }
    ]
}

자세한 내용은 The AWS Proton 관리자 안내서의 서비스 인스턴스 데이터 보기 또는 The 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"
    }
}

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

API 세부 정보는 AWS CLI 명령 참조의 ListServiceInstances 섹션을 참조하세요.

다음 코드 예제에서는 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"
    }
}

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

API 세부 정보는 AWS CLI 명령 참조의 UpdateServiceInstance 섹션을 참조하세요.

다음 코드 예제에서는 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"
    }
}

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

API 세부 정보는 AWS CLI 명령 참조의 UpdateServicePipeline 섹션을 참조하세요.

다음 코드 예제에서는 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"
    }
}

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

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

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

AWS Private CA

QLDB