# Amazon ECS 서비스 배포를 사용하여 서비스 기록 보기
서비스 배포에서는 배포에 대한 포괄적인 보기가 제공됩니다. 서비스 배포에서는 서비스에 대한 다음과 같은 정보가 제공됩니다.
+ 현재 배포된 워크로드 구성(소스 서비스 개정)
+ 배포 중인 워크로드 구성(대상 서비스 개정)
+ 배포 상태
+ 회로 차단이 감지된 실패한 태스크 수
+ 경보에 있는 CloudWatch 경보
+ 서비스 배포 시작 및 완료 시점
+ 롤백 발생 시 세부 정보
서비스 배포 속성에 대한 내용은 [Amazon ECS 서비스 배포에 포함된 속성](service-deployment-property.md) 섹션을 참조하세요.
서비스 배포는 읽기 전용이며 각각 고유한 ID가 있습니다.
세 가지 서비스 배포 스테이지가 있습니다.
| 단계 | 정의 | 연결된 상태 |
| --- | --- | --- |
| 보류중 | 서비스 배포가 생성되었으나 시작되지 않았음 | PENDING |
| 지속적 | 서비스 배포 진행 중 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/AmazonECS/latest/developerguide/service-deployment.html) |
| 완료됨 | 서비스 배포 마침(성공 또는 실패) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/AmazonECS/latest/developerguide/service-deployment.html) |
서비스 배포를 사용하여 서비스의 수명 주기를 이해하고 취해야 할 조치가 있는지 결정합니다. 예를 들면, 롤백이 발생한 경우 서비스 배포를 조사하고 서비스 이벤트를 살펴보는 것이 좋습니다.
콘솔, API 및 AWS CLI를 사용하여 2024년 10월 25일 이후에 생성된 배포에 대한 최근 90일 기록을 볼 수 있습니다.
완료되지 않은 배포를 중지할 수 있습니다. 자세한 내용은 [Amazon ECS 서비스 배포 중지](stop-service-deployment.md) 섹션을 참조하세요.
## 서비스 배포 수명 주기
Amazon ECS에서는 다음과 같은 조치 중 하나라도 발생하면 자동으로 새 서비스 배포가 생성됩니다.
+ 사용자가 서비스를 생성합니다.
+ 사용자가 서비스를 업데이트하고 새 배포 강제 적용 옵션을 사용합니다.
+ 배포가 필요한 하나 이상의 서비스 속성을 사용자가 업데이트합니다.
배포가 진행되는 동안 Amazon ECS에서는 서비스 배포의 진행률이 반영되도록 다음과 같은 서비스 배포 속성이 업데이트됩니다.
+ 상태
+ 실행 중인 태스크 수
서비스 개정에 표시된 실행 중인 태스크 수는 실행 중인 태스크의 실제 수와 같지 않을 수 있습니다. 이 숫자는 배포 완료 시 실행 중인 태스크 수를 나타냅니다. 예를 들면, 서비스 배포와 독립적으로 태스크를 시작한 경우 해당 태스크는 서비스 개정의 실행 중인 태스크 수에 포함되지 않습니다.
+ 회로 차단기 실패 탐지:
+ 시작에 실패한 태스크 수
+ CloudWatch 경보 실패 탐지
+ 활성 상태인 경보
+ 롤백 정보:
+ 시작 시각
+ 롤백 사유
+ 롤백에 사용된 서비스 개정의 ARN
+ 상태 사유
서비스를 삭제할 때 Amazon ECS에서 서비스 배포가 삭제됩니다.
## 서비스 배포 상태
서비스 배포는 `PENDING` 상태로 시작됩니다.
다음 그림에서는 `PENDING` 상태 이후에 발생할 수 있는 서비스 배포 상태인 `IN_PROGRESS`, `ROLLBACK_REQUESTED`, `SUCCESSFUL`, `STOP_REQUESTED`, `ROLLBACK_IN_PROGRESSS`, `ROLLBACK_FAILED`, `ROLLBACK_SUCCESSFUL`, `STOPPED`를 보여줍니다.
![\[IN_PROGRESS 상태 이후에 발생할 수 있는 서비스 배포 STOP_REQUESTED, SUCCESSFUL 및 ROLLBACK_IN_PROGRESS 상태입니다.\]](http://docs.aws.amazon.com/ko_kr/AmazonECS/latest/developerguide/images/service-deployment-states.png)
다음과 같은 정보에서는 서비스 배포 상태에 대한 세부 정보가 제공됩니다.
+ `PENDING` - 서비스 배포가 생성되었으나 시작되지 않았습니다.
상태가 `IN_PROGRESS`, `ROLLBACK_REQUESTED`, `STOP_REQUESTED` 또는 `STOPPED`로 바뀔 수 있습니다.
+ `IN_PROGRESS` - 서비스 배포가 진행 중입니다.
상태가 `SUCCESSFUL`, `STOP_REQUESTED`, `ROLLBACK_REQUESTED`, `ROLLBACK_IN_PROGRESS` 및 `STOPPED`로 바뀔 수 있습니다.
+ `STOP_REQUESTED` - 다음 중 하나가 발생하면 서비스 배포 상태가 `STOP_REQUESTED`로 바뀝니다.
+ 사용자가 새 서비스 배포를 시작합니다.
+ 롤백 옵션은 실패 탐지 메커니즘(회로 차단기 또는 경보 기반)에 사용되지 않으며 서비스가 `SUCCESSFUL` 상태에 도달하지 않습니다.
상태가 `STOPPED`로 바뀝니다.
+ `ROLLBACK_REQUESTED` - 사용자가 콘솔, API 또는 CLI를 통해 롤백을 요청하면 서비스 배포 상태가 `ROLLBACK_REQUESTED`로 바뀝니다.
상태가 `SUCCESSFUL`, `ROLLBACK_IN_PROGRESS` 및 `STOPPED`로 바뀔 수 있습니다.
+ `SUCCESSFUL` - 서비스 배포가 완료되면 서비스 배포 상태가 `SUCCESSFUL`로 바뀝니다.
+ `ROLLBACK_IN_PROGRESS` - 롤백 옵션이 실패 탐지 메커니즘(회로 차단기 또는 경보 기반)에 사용 중이면 서비스 배포 상태가 `ROLLBACK_IN_PROGRESS`로 바뀌며 서비스에 실패합니다.
상태가 `ROLLBACK_SUCCESSFUL` 또는 `ROLLBACK_FAILED`로 바뀝니다.
# Amazon ECS 서비스 배포에 포함된 속성
다음과 같은 속성이 서비스 배포에 포함되어 있습니다.
| 속성 | 설명 |
| --- | --- |
| 서비스 배포 ARN | 서비스 배포의 ARN입니다. |
| 서비스 ARN | 이 서비스 배포에 대한 서비스의 ARN입니다. |
| 클러스터 ARN | 서비스가 호스팅되는 클러스터의 ARN입니다. |
| 서비스 배포 생성 시각 | 서비스 배포가 생성된 시각입니다. |
| 서비스 배포 시작 시각 | 서비스 배포가 시작된 시각입니다. |
| 서비스 배포 완료 시각 | 서비스 배포가 완료된 시각입니다. |
| 서비스 배포 중지 시각 | 서비스 배포가 중지된 시각입니다. |
| 서비스 배포 업데이트 시각 | 서비스 배포가 마지막으로 업데이트된 시각입니다. |
| 소스 서비스 개정 | 현재 실행 중인 서비스 개정입니다. 포함된 속성에 대한 내용은 [Amazon ECS 서비스 개정에 포함된 속성](service-revision-property.md) 섹션을 참조하세요. |
| 배포 구성 | 회로 차단기 구성, 결정 경보가 포함된 배포 파라미터입니다.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/AmazonECS/latest/developerguide/service-deployment-property.html) |
| 대상 서비스 개정 | 배포되는 서비스 개정입니다.배포가 완료되면 실행 중인 서비스 개정이 대상 서비스 개정입니다. |
| 서비스 배포 상태 | 서비스 배포 상태입니다.유효한 값은 PENDING, SUCCESSFUL, STOPPED, STOP\$1REQUESTED, STOP\$1IN\$1PROGRESS, IN\$1PROGRESS, ROLLBACK\$1IN\$1PROGRESS, ROLLBACK\$1SUCCESSFUL 및 ROLLBACK\$1FAILED입니다. |
| 서비스 배포 상태 정보 | 서비스 배포가 현재 상태인 이유에 대한 정보입니다. 예: 실패가 회로 차단기에서 탐지되었습니다. |
| 롤백 정보 | 배포 실패 시 서비스 배포에 사용되는 롤백 옵션입니다. |
| 서비스 배포 회로 차단기 옵션 | 서비스 배포 실패가 결정되는 회로 차단기입니다. |
| 서비스 배포에 대한 CloudWatch 경보 | 서비스 배포 실패 시점이 결정되는 CloudWatch 경보입니다. |
# Amazon ECS 서비스 배포를 보는 데 필요한 권한
최소 권한 부여의 모범 사례를 따는 경우 콘솔에서 서비스 배포를 보려면 추가 권한을 추가해야 합니다.
다음과 같은 조치에 대한 액세스 권한이 필요합니다.
+ ListServiceDeployments
+ DescribeServiceDeployments
+ DescribeServiceRevisions
다음과 같은 리소스에 대한 액세스 권한이 필요합니다.
+ 서비스
+ 서비스 배포
+ 서비스 개정
다음 예제 정책에는 필요한 권한이 있으며, 지정된 서비스로 조치가 제한됩니다.
`account`, `cluster-name` 및 `service-name`을 원하는 값으로 바꿉니다.
------
#### [ JSON ]
****
```
{
"Statement": [
{
"Effect": "Allow",
"Action": [
"ecs:ListServiceDeployments",
"ecs:DescribeServiceDeployments",
"ecs:DescribeServiceRevisions"
],
"Resource": [
"arn:aws:ecs:us-east-1:123456789012:service/cluster-name/service-name",
"arn:aws:ecs:us-east-1:123456789012:service-deployment/cluster-name/service-name/*",
"arn:aws:ecs:us-east-1:123456789012:service-revision/cluster-name/service-name/*"
]
}
]
}
```
------
# Amazon ECS 서비스 배포 보기
2024년 10월 25일 이후에 생성된 배포에 대한 최근 90일 기록을 참조할 수 있습니다. 서비스 배포 상태는 다음 중 하나일 수 있습니다.
+ 진행 중
+ 보류중
+ 완료됨
이 정보를 사용하여 서비스가 배포되는 방식 또는 서비스 개정을 업데이트해야 하는지 결정할 수 있습니다. 포함된 속성에 대한 내용은 [Amazon ECS 서비스 배포에 포함된 속성](service-deployment-property.md) 단원을 참조하세요.
시작하기 전에 서비스 배포를 보는 데 필요한 권한을 구성합니다. 자세한 내용은 [Amazon ECS 서비스 배포를 보는 데 필요한 권한](service-deployment-permissions.md) 섹션을 참조하세요.
------
#### [ Amazon ECS Console ]
1. [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2)에서 콘솔을 엽니다.
1. **클러스터(Clusters)** 페이지에서 클러스터를 선택합니다.
1. 클러스터 세부 정보 페이지의 **서비스** 섹션에서 서비스를 선택합니다.
서비스 세부 정보 페이지가 표시됩니다.
1. 배포 세부 정보 페이지에서 **배포**를 선택합니다.
1. 보려는 서비스 배포를 선택합니다.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/AmazonECS/latest/developerguide/view-service-deployment.html)
서비스 배포 세부 정보 페이지가 나타납니다.
1. (선택 사항) 서비스 개정을 비교하여 차이점을 봅니다.
**서비스 개정**에서 **개정 비교**를 선택한 다음에 비교할 개정 2개를 선택합니다.
서비스 개정은 차이점이 강조 표시되어 나란히 표시됩니다.
------
#### [ AWS CLI ]
1. `list-service-deployments`를 실행하여 서비스 배포 ARN을 검색합니다.
변수를 원하는 값으로 바꿉니다.
```
aws ecs list-service-deployments --cluster cluster-name --service service-name
```
보려는 배포에 대한 serviceDeploymentArn을 기록해 둡니다.
```
{
"serviceDeployments": [
{
"serviceDeploymentArn": "arn:aws:ecs:us-west-2:123456789012:service-deployment/example/sd-example/NCWGC2ZR-taawPAYrIaU5",
"serviceArn": "arn:aws:ecs:us-west-2:123456789012:service/example/sd-example",
"clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/example",
"targetServiceRevisionArn": "arn:aws:ecs:us-west-2:123456789012:service-revision/example/sd-example/4980306466373577095",
"status": "SUCCESSFUL"
}
]
}
```
1. `describe-service-deployments`를 실행합니다. `list-service-deployments`에서 반환된 `serviceDeploymentArn`을 사용합니다.
변수를 원하는 값으로 바꿉니다.
```
aws ecs describe-service-deployments --service-deployment-arns arn:aws:ecs:region:123456789012:service-deployment/cluster-name/service-name/NCWGC2ZR-taawPAYrIaU5
```
------
## 다음 단계
배포에서 서비스 개정에 대한 세부 정보를 볼 수 있습니다. 자세한 내용은 [Amazon ECS 서비스 개정 세부 정보 보기](view-service-revision.md) 섹션을 참조하세요.