환경 업데이트 - AWS Proton
AWS 관리형 프로비저닝 환경 업데이트자체 관리형 프로비저닝 환경 업데이트진행 중인 환경 배포 취소

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

환경 업데이트

AWS Proton 환경이 환경 계정 연결과 연결된 경우 환경 계정 연결을 업데이트하거나 연결하기 위해 protonServiceRoleArn 파라미터를 업데이트하거나 포함시키지 마십시오.

다음 두 가지 모두에 해당하는 경우에만 새 환경 계정 연결로 업데이트할 수 있습니다.

  • 환경 계정 연결이 현재 환경 계정 연결이 만들어진 환경 계정과 동일한 환경 계정에서 만들어졌습니다.

  • >환경 계정 연결이 현재 환경과 연결되어 있습니다.

환경이 환경 계정 연결과 연결되어 있지 않은 경우 environmentAccountConnectionId 파라미터를 업데이트하거나 포함하지 마십시오.

environmentAccountConnectionId 또는 protonServiceRoleArn 파라미터 및 값을 업데이트할 수 있습니다. 둘 다 업데이트할 수는 없습니다.

자체 관리형 프로비저닝을 사용하는 환경에서는 provisioning-repository 파라미터를 업데이트하거나 environmentAccountConnectionId 및 protonServiceRoleArn 파라미터를 생략하지 마십시오.

다음 목록에 설명된 대로 환경을 업데이트하는 데는 네 가지 모드가 있습니다. 를 AWS CLI사용하는 경우 deployment-type 필드는 모드를 정의합니다. 콘솔을 사용할 때 이러한 모드는 작업에서 드롭다운되는 편집, 업데이트, 사소한 업데이트 및 주요 업데이트 작업에 매핑됩니다.

NONE

이 모드에서는 배포가 이루어지지 않습니다. 요청된 메타데이터 파라미터만 업데이트됩니다.

CURRENT_VERSION

이 모드에서는 사용자가 제공한 새 사양으로 환경이 배포되고 업데이트됩니다. 요청된 파라미터만 업데이트됩니다. 이 deployment-type을 사용할 때 마이너 버전 또는 메이저 버전 파라미터를 포함하지 마십시오.

MINOR_VERSION

이 모드에서는 환경이 기본적으로 현재 사용 중인 메이저 버전의 권장되는 최신 마이너 버전으로 배포 및 업데이트됩니다. 현재 사용 중인 메이저 버전과 다른 마이너 버전을 지정할 수도 있습니다.

MAJOR_VERSION

이 모드에서는 기본적으로 현재 템플릿의 게시된 권장(최신) 메이저 버전 및 마이너 버전으로 환경이 배포 및 업데이트됩니다. 사용 중인 메이저 버전보다 상위의 다른 메이저 버전과 마이너 버전을 지정할 수도 있습니다(선택 사항).

AWS 관리형 프로비저닝 환경 업데이트

표준 프로비저닝은 AWS CloudFormation을 사용하여 프로비저닝하는 환경에서만 지원됩니다.

AWS CLI 콘솔을 사용하거나 환경을 업데이트하십시오.

AWS Management Console
다음 단계에 따라 콘솔을 사용하여 환경을 업데이트합니다.
  1. 다음 2단계 중 하나를 선택합니다.
    1. 환경 목록에서.

      1. AWS Proton 콘솔에서 환경을 선택합니다.

      2. 환경 목록에서 업데이트하려는 환경의 왼쪽에 있는 라디오 버튼을 선택합니다.

    2. 콘솔의 작업자 환경 세부 정보 페이지

      1. AWS Proton 콘솔에서 환경을 선택합니다.

      2. 환경 목록에서 업데이트할 환경의 이름을 선택합니다.

  2. 다음 4단계 중 하나를 선택하여 환경을 업데이트합니다.
    1. 환경 배포가 필요 없는 편집을 하려면

      1. 설명을 변경하는 경우를 예로 들 수 있습니다.

        편집을 선택합니다.

      2. 양식을 작성하고 다음 선택합니다.

      3. 편집 내용을 검토하고 업데이트를 선택합니다.

    2. 메타데이터 입력만 업데이트하려면

      1. 작업을 선택한 다음 업데이트를 선택합니다.

      2. 양식을 작성하고 편집을 선택합니다.

      3. 양식을 작성하고 검토 페이지가 표시될 때까지 다음을 선택합니다.

      4. 업데이트 내용을 검토하고 업데이트를 선택합니다.

    3. 환경 템플릿의 새 마이너 버전으로 업데이트하기.

      1. 작업을 선택한 다음 업데이트 마이너를 선택합니다.

      2. 양식을 작성하고 다음 선택합니다.

      3. 양식을 작성하고 검토 페이지가 표시될 때까지 다음을 선택합니다.

      4. 업데이트 내용을 검토하고 업데이트를 선택합니다.

    4. 환경 템플릿의 새 메이저 버전으로 업데이트하기.

      1. 작업을 선택한 다음 업데이트 메이저를 선택합니다.

      2. 양식을 작성하고 다음 선택합니다.

      3. 양식을 작성하고 검토 페이지가 표시될 때까지 다음을 선택합니다.

      4. 업데이트 내용을 검토하고 업데이트를 선택합니다.

AWS CLI

AWS Proton AWS CLI 를 사용하여 환경을 새 마이너 버전으로 업데이트하십시오.

다음 명령을 실행하여 환경을 업데이트합니다.

$ aws proton update-environment \
        --name "MySimpleEnv" \
        --deployment-type "MINOR_VERSION" \
        --template-major-version "1" \
        --template-minor-version "1" \
        --proton-service-role-arn arn:aws:iam::123456789012:role/service-role/ProtonServiceRole \
        --spec "file:///spec.yaml"

응답:

{
    "environment": {
        "arn": "arn:aws:proton:region-id:123456789012:environment/MySimpleEnv",
        "createdAt": "2021-04-02T17:29:55.472000+00:00",
        "deploymentStatus": "IN_PROGRESS",        
        "lastDeploymentAttemptedAt": "2021-04-02T17:48:26.307000+00:00",
        "lastDeploymentSucceededAt": "2021-04-02T17:29:55.472000+00:00",
        "name": "MySimpleEnv",
        "protonServiceRoleArn": "arn:aws:iam::123456789012:role/service-role/ProtonServiceRole",
        "templateMajorVersion": "1",
        "templateMinorVersion": "0",
        "templateName": "simple-env"
    }
}

다음 명령을 실행하여 상태를 가져와 확인합니다.

$ aws proton get-environment \
        --name "MySimpleEnv"

응답:

{
    "environment": {
        "arn": "arn:aws:proton:region-id:123456789012:environment/MySimpleEnv",
        "createdAt": "2021-04-02T17:29:55.472000+00:00",
        "deploymentStatus": "SUCCEEDED",
        "environmentName": "MySimpleEnv",
        "lastDeploymentAttemptedAt": "2021-04-02T17:48:26.307000+00:00",
        "lastDeploymentSucceededAt": "2021-04-02T17:48:26.307000+00:00",
        "protonServiceRoleArn": "arn:aws:iam::123456789012:role/service-role/ProtonServiceRole",
        "spec": "proton: EnvironmentSpec\n\nspec:\n  my_sample_input: hello\n  my_other_sample_input: everybody\n",
        "templateMajorVersion": "1",
        "templateMinorVersion": "1",
        "templateName": "simple-env"
    }
}

자체 관리형 프로비저닝 환경 업데이트

자체 관리형 프로비저닝은 Terraform으로 프로비저닝하는 환경에서만 지원됩니다.

AWS CLI 콘솔을 사용하거나 환경을 업데이트하십시오.

AWS Management Console
다음 단계에 따라 콘솔을 사용하여 환경을 업데이트합니다.
  1. 다음 2단계 중 하나를 선택합니다.
    1. 환경 목록에서.

      1. AWS Proton 콘솔에서 환경을 선택합니다.

      2. 환경 목록에서 업데이트하려는 환경 템플릿의 왼쪽에 있는 라디오 버튼을 선택합니다.

    2. 콘솔의 작업자 환경 세부 정보 페이지

      1. AWS Proton 콘솔에서 환경을 선택합니다.

      2. 환경 목록에서 업데이트할 환경의 이름을 선택합니다.

  2. 다음 4단계 중 하나를 선택하여 환경을 업데이트합니다.
    1. 환경 배포가 필요 없는 편집을 하려면

      1. 설명을 변경하는 경우를 예로 들 수 있습니다.

        편집을 선택합니다.

      2. 양식을 작성하고 다음 선택합니다.

      3. 편집 내용을 검토하고 업데이트를 선택합니다.

    2. 메타데이터 입력만 업데이트하려면

      1. 작업을 선택한 다음 업데이트를 선택합니다.

      2. 양식을 작성하고 편집을 선택합니다.

      3. 양식을 작성하고 검토 페이지가 표시될 때까지 다음을 선택합니다.

      4. 업데이트 내용을 검토하고 업데이트를 선택합니다.

    3. 환경 템플릿의 새 마이너 버전으로 업데이트하기.

      1. 작업을 선택한 다음 업데이트 마이너를 선택합니다.

      2. 양식을 작성하고 다음 선택합니다.

      3. 양식을 작성하고 검토 페이지가 표시될 때까지 다음을 선택합니다.

      4. 업데이트 내용을 검토하고 업데이트를 선택합니다.

    4. 환경 템플릿의 새 메이저 버전으로 업데이트하기.

      1. 작업을 선택한 다음 업데이트 메이저를 선택합니다.

      2. 양식을 작성하고 다음 선택합니다.

      3. 양식을 작성하고 검토 페이지가 표시될 때까지 다음을 선택합니다.

      4. 업데이트 내용을 검토하고 업데이트를 선택합니다.

AWS CLI
AWS CLI 를 사용하여 Terraform 환경을 자체 관리형 프로비저닝이 포함된 새 마이너 버전으로 업데이트하십시오.

  1. 다음 명령을 실행하여 환경을 업데이트합니다.

    $ aws proton update-environment \
    --name "pr-environment" \
    --deployment-type "MINOR_VERSION" \
    --template-major-version "1" \
    --template-minor-version "1" \
    --provisioning-repository "branch=main,name=myrepos/env-repo,provider=GITHUB" \
    --spec "file://env-spec-mod.yaml"

    응답:

    {
    "environment": {
        "arn": "arn:aws:proton:region-id:123456789012:environment/pr-environment",
        "createdAt": "2021-11-18T21:09:15.745000+00:00",
        "deploymentStatus": "IN_PROGRESS",
        "lastDeploymentAttemptedAt": "2021-11-18T21:25:41.998000+00:00",
        "lastDeploymentSucceededAt": "2021-11-18T21:09:15.745000+00:00",
        "name": "pr-environment",
        "provisioningRepository": {
            "arn": "arn:aws:proton:region-id:123456789012:repository/github:myrepos/env-repo",
            "branch": "main",
            "name": "myrepos/env-repo",
            "provider": "GITHUB"
        },
        "templateMajorVersion": "1",
        "templateMinorVersion": "0",
        "templateName": "pr-env-template"
    }
}

  2. 다음 명령을 실행하여 상태를 가져와 확인합니다.

    $ aws proton get-environment \
    --name "pr-environment"

    응답:

    {
    "environment": {
        "arn": "arn:aws:proton:region-id:123456789012:environment/pr-environment",
        "createdAt": "2021-11-18T21:09:15.745000+00:00",
        "deploymentStatus": "SUCCEEDED",
        "lastDeploymentAttemptedAt": "2021-11-18T21:25:41.998000+00:00",
        "lastDeploymentSucceededAt": "2021-11-18T21:25:41.998000+00:00",
        "name": "pr-environment",
        "provisioningRepository": {
            "arn": "arn:aws:proton:region-id:123456789012:repository/github:myrepos/env-repo",
            "branch": "main",
            "name": "myrepos/env-repo",
            "provider": "GITHUB"
        },
        "spec": "proton: EnvironmentSpec\nspec:\n   ssm_parameter_value: \"test\"\n ssm_another_parameter_value: \"update\"\n",
        "templateMajorVersion": "1",
        "templateMinorVersion": "1",
        "templateName": "pr-env-template"
    }
}

  3. 에서 전송한 풀 리퀘스트를 검토하세요. AWS Proton

    • 요청을 승인하면 프로비저닝이 진행 중인 것입니다.

    • 요청을 거부하면 환경 생성이 취소됩니다.

    • 풀 리퀘스트 제한 시간이 초과되면 환경 생성이 완료되지 않습니다.

  4. 에 프로비저닝 상태를 제공하십시오. AWS Proton

    $ aws proton notify-resource-deployment-status-change \
    --resource-arn "arn:aws:proton:region-id:123456789012:environment/pr-environment" \
    --status "SUCCEEDED"

진행 중인 환경 배포 취소

deploymentStatus가 있는 경우 환경 업데이트 배포를 취소할 수 있습니다IN_PROGRESS. AWS Proton 배포 취소를 시도합니다. 취소 성공은 보장되지 않습니다.

업데이트 배포를 취소하면 다음 단계에 나열된 대로 배포 취소를 AWS Proton 시도합니다.

AWS-managed 프로비저닝을 사용하면 다음을 AWS Proton 수행합니다.

  • 배포 상태를 CANCELLING로 설정합니다.

  • IN_PROGRESS가 되면 진행 중인 배포를 중지하고 배포에 의해 생성된 모든 새 리소스를 삭제합니다.

  • 배포 상태를 CANCELLED로 설정합니다.

  • 리소스 상태를 배포가 시작되기 전의 상태로 되돌립니다.

자체 관리형 프로비저닝으로 다음을 AWS Proton 수행합니다.

  • 변경 사항을 리포지토리에 병합하지 못하도록 풀 리퀘스트를 닫으려고 시도합니다.

  • 풀 리퀘스트가 성공적으로 종료되면 배포 상태를 CANCELLED로 설정합니다.

환경 배포를 취소하는 방법에 대한 지침은 참조를 참조하십시오 CancelEnvironmentDeployment.AWS Proton API

콘솔을 사용하거나 진행 중인 환경을 CLI 취소할 수 있습니다.

AWS Management Console

콘솔을 사용하여 다음 단계에 따라 환경 업데이트 배포를 취소할 수 있습니다.

  1. AWS Proton 콘솔의 왼쪽 탐색 창에서 환경을 선택합니다.

  2. 환경 목록에서 취소하려는 배포 업데이트가 있는 환경의 이름을 선택합니다.

  3. 업데이트 배포 상태가 진행 중이면 환경 세부 정보 페이지에서 작업을 선택한 다음 배포 취소를 선택합니다.

  4. 취소할 것인지 확인하는 모달이 표시됩니다. 배포 취소를 선택합니다.

  5. 업데이트 배포 상태가 취소 중으로 설정된 다음 취소가 완료되면 취소됨으로 설정됩니다.

AWS CLI

AWS Proton AWS CLI 를 사용하여 새 마이너 버전 2에 대한 IN_ PROGRESS 환경 업데이트 배포를 취소할 수 있습니다.

이 예제에 사용된 템플릿에는 업데이트 배포가 성공하기 전에 취소가 시작되도록 대기 조건이 포함되어 있습니다.

다음 명령을 실행하여 업데이트를 취소합니다.

$ aws proton cancel-environment-deployment \
        --environment-name "MySimpleEnv"

응답:

{
    "environment": {
        "arn": "arn:aws:proton:region-id:123456789012:environment/MySimpleEnv",
        "createdAt": "2021-04-02T17:29:55.472000+00:00",
        "deploymentStatus": "CANCELLING",
        "lastDeploymentAttemptedAt": "2021-04-02T18:15:10.243000+00:00",
        "lastDeploymentSucceededAt": "2021-04-02T17:48:26.307000+00:00",
        "name": "MySimpleEnv",
        "protonServiceRoleArn": "arn:aws:iam::123456789012:role/service-role/ProtonServiceRole",
        "spec": "proton: EnvironmentSpec\n\nspec:\n  my_sample_input: hello\n  my_other_sample_input: everybody\n",
        "templateMajorVersion": "1",
        "templateMinorVersion": "1",
        "templateName": "simple-env"
    }
}

다음 명령을 실행하여 상태를 가져와 확인합니다.

$ aws proton get-environment \
        --name "MySimpleEnv"

응답:

{
    "environment": {
        "arn": "arn:aws:proton:region-id:123456789012:environment/MySimpleEnv",
        "createdAt": "2021-04-02T17:29:55.472000+00:00",
        "deploymentStatus": "CANCELLED",
        "deploymentStatusMessage": "User initiated cancellation.",
        "lastDeploymentAttemptedAt": "2021-04-02T18:15:10.243000+00:00",
        "lastDeploymentSucceededAt": "2021-04-02T17:48:26.307000+00:00",
        "name": "MySimpleEnv",
        "protonServiceRoleArn": "arn:aws:iam::123456789012:role/service-role/ProtonServiceRole",
        "spec": "proton: EnvironmentSpec\n\nspec:\n  my_sample_input: hello\n  my_other_sample_input: everybody\n",
        "templateMajorVersion": "1",
        "templateMinorVersion": "1",
        "templateName": "simple-env"
    }
}