

# Visualize o histórico de serviços usando implantações de serviços do Amazon ECS
<a name="service-deployment"></a>

As implantações de serviços fornecem uma visão abrangente das suas implantações. As implantações de serviços fornecem as seguintes informações sobre o serviço:
+ A configuração da workload atualmente implantada (a revisão do serviço de origem)
+ A configuração da workload em implantação (a revisão do serviço de destino)
+ O status da implantação
+ O número de tarefas com falha que a interrupção do circuito detectou
+ Os alarmes do CloudWatch que estão em alarme
+ Quando a implantação do serviço foi iniciada e concluída
+ Os detalhes de uma reversão, caso tenha ocorrido

Para obter informações sobre as propriedades de implantação do serviço, consulte [Propriedades incluídas na implantação de serviço do Amazon ECS](service-deployment-property.md).

As implantações de serviços são somente leitura e cada uma tem um ID exclusivo. 

Há três estágios de implantação de um serviço:


| Estágio | Definição | Estados associados | 
| --- | --- | --- | 
| Pendente | Uma implantação de serviço foi criada, mas ainda não foi iniciada | PENDING | 
| Contínuo | Uma implantação de serviço está em andamento |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/AmazonECS/latest/developerguide/service-deployment.html)  | 
| Completed  | A implantação de um serviço foi concluída (com ou sem êxito) |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/AmazonECS/latest/developerguide/service-deployment.html)  | 

Você usa implantações de serviços para entender o ciclo de vida do seu serviço e determinar se há alguma medida a ser tomada. Por exemplo, se uma reversão ocorreu, talvez seja necessário investigar a implantação do serviço e observar os eventos do serviço.

É possível ver o histórico mais recente de 90 dias das implantações criadas em ou após 25 de outubro de 2024 usando o console, a API e a AWS CLI. 

É possível interromper uma implantação que não foi concluída. Para obter mais informações, consulte [Parar implantações de serviços do Amazon ECS](stop-service-deployment.md).

## Ciclo de vida de implantação de serviços
<a name="service-deployments-lifecycle"></a>

O Amazon ECS cria uma nova implantação de serviço automaticamente quando qualquer uma das seguintes ações acontece:
+ Um usuário cria um serviço.
+ Um usuário atualiza o serviço e usa a opção de forçar nova implantação.
+ Um usuário atualiza uma ou mais propriedades do serviço que exigem uma implantação.

Enquanto a implantação está em andamento, o Amazon ECS atualiza as seguintes propriedades de implantação do serviço para refletir o progresso da implantação:
+ O estado
+ O número de tarefas em execução

  O número de tarefas em execução indicado na revisão do serviço pode não ser igual ao número real de tarefas em execução. Esse número representa o número de tarefas em execução quando a implantação foi concluída. Por exemplo, se você iniciou tarefas independentemente da implantação do serviço, essas tarefas não serão incluídas na contagem de tarefas em execução para a revisão do serviço.
+ Detecção de falha no disjuntor:
  + O número de tarefas que falharam ao iniciar
+ Detecção de falhas de alarme do CloudWatch
  + Os alarmes que estão ativos
+ Informações de reversão:
  + A hora de início
  + O motivo da reversão
  + O ARN da revisão de serviço usada para a reversão
+ O motivo do status

O Amazon ECS exclui a implantação do serviço quando você exclui um serviço.

## Estados da implantação de serviços
<a name="service-deployments-states"></a>

A implantação de um serviço começa no estado `PENDING`. 

A ilustração a seguir mostra os estados de implantação de um serviço que podem ocorrer após o estado `PENDING`: `IN_PROGRESS`, `ROLLBACK_REQUESTED`, `SUCCESSFUL`, `STOP_REQUESTED`, `ROLLBACK_IN_PROGRESSS`, `ROLLBACK_FAILED`, `ROLLBACK_SUCCESSFUL` e `STOPPED`.

![Estados de implantação de serviços STOP_REQUESTED, SUCCESSFUL e ROLLBACK_IN_PROGRESS que podem ocorrer após o estado IN_PROGRESS.](http://docs.aws.amazon.com/pt_br/AmazonECS/latest/developerguide/images/service-deployment-states.png)


As informações a seguir fornecem detalhes sobre os estados de implantação de um serviço:
+ `PENDING`: a implantação de serviço foi criada, mas ainda não foi iniciada.

  O estado pode avançar para `IN_PROGRESS`, `ROLLBACK_REQUESTED`, `STOP_REQUESTED` ou `STOPPED`.
+ `IN_PROGRESS`: a implantação do serviço está em andamento.

  O estado pode avançar para `SUCCESSFUL`, `STOP_REQUESTED`, `ROLLBACK_REQUESTED`, `ROLLBACK_IN_PROGRESS` ou `STOPPED`.
+ `STOP_REQUESTED`: o estado de implantação do serviço avança para `STOP_REQUESTED` quando qualquer uma das seguintes situações acontece:
  + Um usuário inicia uma novaa implantação de serviço.
  + A opção de reversão não está em uso para o mecanismo de detecção de falhas (disjuntor ou baseado em alarme) e o serviço não atinge o estado `SUCCESSFUL`.

  O estado avança para `STOPPED`.
+  `ROLLBACK_REQUESTED`: o estado de implantação do serviço muda para `ROLLBACK_REQUESTED` quando um usuário solicita uma reversão via console, API ou CLI.

  O estado pode avançar para `SUCCESSFUL`, `ROLLBACK_IN_PROGRESS` e `STOPPED`.
+ `SUCCESSFUL`: o estado de implantação do serviço avança para `SUCCESSFUL` quando a implantação do serviço é concluída com êxito.
+  `ROLLBACK_IN_PROGRESS`: o estado de implantação do serviço avança para `ROLLBACK_IN_PROGRESS` quando a opção de reversão está em uso para o mecanismo de detecção de falhas (disjuntor ou baseado em alarme) e o serviço falha.

   O estado avança para `ROLLBACK_SUCCESSFUL` ou `ROLLBACK_FAILED`.