

# Amazon ECS 서비스 배포를 사용하여 서비스 기록 보기
<a name="service-deployment"></a>

서비스 배포에서는 배포에 대한 포괄적인 보기가 제공됩니다. 서비스 배포에서는 서비스에 대한 다음과 같은 정보가 제공됩니다.
+ 현재 배포된 워크로드 구성(소스 서비스 개정)
+ 배포 중인 워크로드 구성(대상 서비스 개정)
+ 배포 상태
+ 회로 차단이 감지된 실패한 태스크 수
+ 경보에 있는 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) 섹션을 참조하세요.

## 서비스 배포 수명 주기
<a name="service-deployments-lifecycle"></a>

Amazon ECS에서는 다음과 같은 조치 중 하나라도 발생하면 자동으로 새 서비스 배포가 생성됩니다.
+ 사용자가 서비스를 생성합니다.
+ 사용자가 서비스를 업데이트하고 새 배포 강제 적용 옵션을 사용합니다.
+ 배포가 필요한 하나 이상의 서비스 속성을 사용자가 업데이트합니다.

배포가 진행되는 동안 Amazon ECS에서는 서비스 배포의 진행률이 반영되도록 다음과 같은 서비스 배포 속성이 업데이트됩니다.
+ 상태
+ 실행 중인 태스크 수

  서비스 개정에 표시된 실행 중인 태스크 수는 실행 중인 태스크의 실제 수와 같지 않을 수 있습니다. 이 숫자는 배포 완료 시 실행 중인 태스크 수를 나타냅니다. 예를 들면, 서비스 배포와 독립적으로 태스크를 시작한 경우 해당 태스크는 서비스 개정의 실행 중인 태스크 수에 포함되지 않습니다.
+ 회로 차단기 실패 탐지:
  + 시작에 실패한 태스크 수
+ CloudWatch 경보 실패 탐지
  + 활성 상태인 경보
+ 롤백 정보:
  + 시작 시각
  + 롤백 사유
  + 롤백에 사용된 서비스 개정의 ARN
+ 상태 사유

서비스를 삭제할 때 Amazon ECS에서 서비스 배포가 삭제됩니다.

## 서비스 배포 상태
<a name="service-deployments-states"></a>

서비스 배포는 `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`로 바뀝니다.