지원 종료 알림: 2026년 10월 7일에 AWS 에 대한 지원이 종료됩니다 AWS Proton. 2026년 10월 7일 이후에는 AWS Proton 콘솔 또는 AWS Proton 리소스에 더 이상 액세스할 수 없습니다. 배포된 인프라는 그대로 유지됩니다. 자세한 내용은 [AWS Proton 서비스 사용 중단 및 마이그레이션 안내서](https://docs.aws.amazon.com/proton/latest/userguide/proton-end-of-support.html)를 참조하세요.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 환경 업데이트
AWS Proton 환경이 환경 계정 연결과 연결된 경우 환경 계정 연결을 업데이트하거나 연결하기 위한 `protonServiceRoleArn` 파라미터를 업데이트하거나 포함하지 *마십시오*.
다음 두 가지 모두에 해당하는 경우에만 새 환경 계정 연결로 업데이트할 수 있습니다.
+ 환경 계정 연결이 현재 환경 계정 연결이 만들어진 환경 계정과 동일한 환경 계정에서 만들어졌습니다.
+ >환경 계정 연결이 현재 환경과 연결되어 있습니다.
환경이 환경 계정 연결과 연결되어 *있지 않은* 경우 `environmentAccountConnectionId` 파라미터를 업데이트하거나 포함하지 *마십시오*.
`environmentAccountConnectionId` 또는 `protonServiceRoleArn` 파라미터 및 값을 업데이트할 수 있습니다. 둘 다 업데이트할 수는 없습니다.
자체 관리형 프로비저닝을 사용하는 환경에서는 `provisioning-repository` 파라미터를 업데이트하거나 `environmentAccountConnectionId` 및 `protonServiceRoleArn` 파라미터를 *생략하지* *마십시오*.
다음 목록에 설명된 대로 환경을 업데이트하는 데는 네 가지 모드가 있습니다. 를 사용할 때 AWS CLI`deployment-type` 필드는 모드를 정의합니다. 콘솔을 사용할 때 이러한 모드는 **작업**에서 드롭다운되는 **편집**, **업데이트**, **사소한 업데이트** 및 **주요 업데이트** 작업에 매핑됩니다.
`NONE`
이 모드에서는 배포가 이루어지지 *않습니다*. 요청된 메타데이터 파라미터만 업데이트됩니다.
`CURRENT_VERSION`
이 모드에서는 사용자가 제공한 새 사양으로 환경이 배포되고 업데이트됩니다. 요청된 파라미터만 업데이트됩니다. 이 `deployment-type`을 사용할 때 마이너 버전 또는 메이저 버전 파라미터를 포함하지 *마십시오*.
`MINOR_VERSION`
이 모드에서는 환경이 기본적으로 현재 사용 중인 메이저 버전의 권장되는 최신 마이너 버전으로 배포 및 업데이트됩니다. 현재 사용 중인 메이저 버전과 다른 마이너 버전을 지정할 수도 있습니다.
`MAJOR_VERSION`
이 모드에서는 기본적으로 현재 템플릿의 게시된 권장(최신) 메이저 버전 및 마이너 버전으로 환경이 배포 및 업데이트됩니다. 사용 중인 메이저 버전보다 상위의 다른 메이저 버전과 마이너 버전을 지정할 수도 있습니다(선택 사항).
**Topics**
+ [AWS 관리형 프로비저닝 환경 업데이트](#ag-env-std-update)
+ [자체 관리형 프로비저닝 환경 업데이트](#ag-env-pr-update)
+ [진행 중인 환경 배포 취소](#ag-env-cancel)
## AWS 관리형 프로비저닝 환경 업데이트
표준 프로비저닝은 CloudFormation을 사용하여 프로비저닝하는 환경에서만 지원됩니다.
**콘솔 또는 AWS CLI 를 사용하여 환경을 업데이트합니다.**
------
#### [ AWS Management Console ]
**다음 단계에 따라 콘솔을 사용하여 환경을 업데이트합니다.**
1.
**다음 2단계 중 하나를 선택합니다.**
1.
**환경 목록에서.**
1. [AWS Proton 콘솔](https://console.aws.amazon.com//proton/)에서 **환경**을 선택합니다.
1. 환경 목록에서 업데이트하려는 환경의 왼쪽에 있는 라디오 버튼을 선택합니다.
1.
****콘솔의 작업자 환경 세부 정보 페이지****
1. [AWS Proton 콘솔](https://console.aws.amazon.com//proton/)에서 **환경**을 선택합니다.
1. 환경 목록에서 업데이트할 환경의 이름을 선택합니다.
1.
**다음 4단계 중 하나를 선택하여 환경을 업데이트합니다.**
1.
**환경 배포가 필요 없는 편집을 하려면**
1. 설명을 변경하는 경우를 예로 들 수 있습니다.
**편집**을 선택합니다.
1. 양식을 작성하고 **다음** 선택합니다.
1. 편집 내용을 검토하고 **업데이트**를 선택합니다.
1.
**메타데이터 입력만 업데이트하려면**
1. **작업**을 선택한 다음 **업데이트**를 선택합니다.
1. 양식을 작성하고 **편집**을 선택합니다.
1. 양식을 작성하고 **검토** 페이지가 표시될 때까지 **다음**을 선택합니다.
1. 업데이트 내용을 검토하고 **업데이트**를 선택합니다.
1.
**환경 템플릿의 새 마이너 버전으로 업데이트하기.**
1. **작업**을 선택한 다음 **업데이트 마이너**를 선택합니다.
1. 양식을 작성하고 **다음** 선택합니다.
1. 양식을 작성하고 **검토** 페이지가 표시될 때까지 **다음**을 선택합니다.
1. 업데이트 내용을 검토하고 **업데이트**를 선택합니다.
1.
**환경 템플릿의 새 메이저 버전으로 업데이트하기.**
1. **작업**을 선택한 다음 **업데이트 메이저**를 선택합니다.
1. 양식을 작성하고 **다음** 선택합니다.
1. 양식을 작성하고 **검토** 페이지가 표시될 때까지 **다음**을 선택합니다.
1. 업데이트 내용을 검토하고 **업데이트**를 선택합니다.
------
#### [ 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 콘솔](https://console.aws.amazon.com//proton/)에서 **환경**을 선택합니다.
1. 환경 목록에서 업데이트하려는 환경 템플릿의 왼쪽에 있는 라디오 버튼을 선택합니다.
1.
****콘솔의 작업자 환경 세부 정보 페이지****
1. [AWS Proton 콘솔](https://console.aws.amazon.com//proton/)에서 **환경**을 선택합니다.
1. 환경 목록에서 업데이트할 환경의 이름을 선택합니다.
1.
**다음 4단계 중 하나를 선택하여 환경을 업데이트합니다.**
1.
**환경 배포가 필요 없는 편집을 하려면**
1. 설명을 변경하는 경우를 예로 들 수 있습니다.
**편집**을 선택합니다.
1. 양식을 작성하고 **다음** 선택합니다.
1. 편집 내용을 검토하고 **업데이트**를 선택합니다.
1.
**메타데이터 입력만 업데이트하려면**
1. **작업**을 선택한 다음 **업데이트**를 선택합니다.
1. 양식을 작성하고 **편집**을 선택합니다.
1. 양식을 작성하고 **검토** 페이지가 표시될 때까지 **다음**을 선택합니다.
1. 업데이트 내용을 검토하고 **업데이트**를 선택합니다.
1.
**환경 템플릿의 새 마이너 버전으로 업데이트하기.**
1. **작업**을 선택한 다음 **업데이트 마이너**를 선택합니다.
1. 양식을 작성하고 **다음** 선택합니다.
1. 양식을 작성하고 **검토** 페이지가 표시될 때까지 **다음**을 선택합니다.
1. 업데이트 내용을 검토하고 **업데이트**를 선택합니다.
1.
**환경 템플릿의 새 메이저 버전으로 업데이트하기.**
1. **작업**을 선택한 다음 **업데이트 메이저**를 선택합니다.
1. 양식을 작성하고 **다음** 선택합니다.
1. 양식을 작성하고 **검토** 페이지가 표시될 때까지 **다음**을 선택합니다.
1. 업데이트 내용을 검토하고 **업데이트**를 선택합니다.
------
#### [ 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"
}
}
```
1. 다음 명령을 실행하여 상태를 가져와 확인합니다.
```
$ 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"
}
}
```
1. 에서 전송한 풀 요청을 검토합니다 AWS Proton.
+ 요청을 승인하면 프로비저닝이 진행 중인 것입니다.
+ 요청을 거부하면 환경 생성이 취소됩니다.
+ 풀 리퀘스트 제한 시간이 초과되면 환경 생성이 완료되지 않습니다.
1. 프로비저닝 상태를에 제공합니다 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 attempts에 있는 경우 환경 업데이트 배포 취소를 시도하여 배포를 취소할 수 있습니다. 취소 성공은 보장되지 *않습니다*.
업데이트 배포를 취소하면는 다음 단계에 나열된 대로 배포 취소를 AWS Proton 시도합니다.
**AWS관리형 프로비저닝을 사용하면 다음을 AWS Proton 수행합니다.**
+ 배포 상태를 `CANCELLING`로 설정합니다.
+ `IN_PROGRESS`가 되면 진행 중인 배포를 중지하고 배포에 의해 생성된 모든 새 리소스를 삭제합니다.
+ 배포 상태를 `CANCELLED`로 설정합니다.
+ 리소스 상태를 배포가 시작되기 전의 상태로 되돌립니다.
**자체 관리형 프로비저닝을 사용하면에서 다음을 AWS Proton 수행합니다.**
+ 변경 사항을 리포지토리에 병합하지 못하도록 풀 리퀘스트를 닫으려고 시도합니다.
+ 풀 리퀘스트가 성공적으로 종료되면 배포 상태를 `CANCELLED`로 설정합니다.
환경 배포를 취소하는 방법에 대한 지침은 *AWS Proton API 참조*의 [CancelEnvironmentDeployment](https://docs.aws.amazon.com/proton/latest/APIReference/API_CancelEnvironmentDeployment.html) 항목을 참조하세요.
콘솔 또는 CLI를 사용하여 진행 중인 환경을 취소할 수 있습니다.
------
#### [ AWS Management Console ]
**콘솔을 사용하여 다음 단계에 따라 환경 업데이트 배포를 취소할 수 있습니다.**
1. [AWS Proton 콘솔](https://console.aws.amazon.com//proton/)의 왼쪽 탐색 창에서 **환경**을 선택합니다.
1. 환경 목록에서 취소하려는 배포 업데이트가 있는 환경의 이름을 선택합니다.
1. 업데이트 배포 상태가 **진행 중**이면 환경 세부 정보 페이지에서 **작업**을 선택한 다음 **배포 취소**를 선택합니다.
1. 취소할 것인지 확인하는 모달이 표시됩니다. **배포 취소**를 선택합니다.
1. 업데이트 배포 상태가 **취소 중**으로 설정된 다음 취소가 완료되면 **취소됨**으로 설정됩니다.
------
#### [ AWS CLI ]
** AWS Proton AWS CLI 를 사용하여 새 마이너 버전 2에 대한 IN\$1PROGRESS 환경 업데이트 배포를 취소합니다.**
이 예제에 사용된 템플릿에는 업데이트 배포가 성공하기 전에 취소가 시작되도록 대기 조건이 포함되어 있습니다.
다음 명령을 실행하여 업데이트를 취소합니다.
```
$ 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"
}
}
```
------