# Visualize o histórico de serviços usando implantações de serviços do Amazon ECS 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. Você pode 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 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 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`. # Propriedades incluídas na implantação de serviço do Amazon ECS As propriedades a seguir estão incluídas em uma implantação de serviço. | Propriedade | Descrição | | --- | --- | | ARN da implantação do serviço | O ARN da implantação do serviço. | | Nome de recurso da Amazon (ARN) do serviço | O ARN do serviço para esta implantação de serviço. | | ARN do cluster | O ARN do cluster que hospeda o serviço. | | Hora de criação da implantação do serviço | A hora em que a implantação do serviço foi criada. | | Hora de início da implantação do serviço | A hora em que a implantação do serviço começou. | | Hora de término da implantação do serviço | A hora em que a implantação do serviço terminou. | | Hora de interrupção da implantação do serviço | A hora em que a implantação do serviço foi interrompida. | | Hora de atualização da implantação do serviço | A hora da última atualização da implantação do serviço. | | Revisões de serviços de origem | As revisões de serviços atualmente em execução. Para obter mais informações sobre as propriedades incluídas, consulte [Propriedades incluídas na revisão de serviço do Amazon ECS](service-revision-property.md). | | Configuração de implantação | Os parâmetros de implantação, incluindo a configuração do disjuntor e os alarmes.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonECS/latest/developerguide/service-deployment-property.html) | | Revisão do serviço de destino | A revisão do serviço a ser implantado. Depois que a implantação for concluída com êxito, a revisão do serviço de destino será a revisão do serviço em execução. | | Status da implantação de serviços | O estado da implantação de serviços.Os valores válidos são PENDING, SUCCESSFUL, STOPPED, STOP\$1REQUESTED, STOP\$1IN\$1PROGRESS, IN\$1PROGRESS, ROLLBACK\$1IN\$1PROGRESS, ROLLBACK\$1SUCCESSFUL, e ROLLBACK\$1FAILED. | | Informações sobre status de implantação de serviços | Informações sobre por que a implantação do serviço está no status atual. Por exemplo, o disjuntor detectou uma falha. | | Informações de reversão | As opções de reversão usadas pela implantação do serviço quando a implantação falha. | | Opções de disjuntores de implantação de serviços | O disjuntor que determina que a implantação de um serviço falhou. | | Alarmes do CloudWatch para a implantação do serviço | Os alarmes do CloudWatch que determinam quando a implantação de um serviço falha. | # Permissões necessárias para visualizar implantações de serviço do Amazon ECS Ao seguir a prática recomendada de conceder privilégio mínimo, é necessário adicionar permissões adicionais para visualizar implantações de serviço no console. É necessário ter acesso às seguintes ações: + ListServiceDeployments + DescribeServiceDeployments + DescribeServiceRevisions É necessário ter acesso aos seguintes recursos: + Serviço + Implantação de serviços + Revisão de serviços O exemplo de política a seguir contém as permissões necessárias e limita as ações a um serviço especificado. Substitua `account`, `cluster-name` e `service-name` por seus próprios valores. ------ #### [ 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/*" ] } ] } ``` ------ # Visualizar implantações de serviços do Amazon ECS Você pode ver o histórico mais recente de 90 dias das implantações criadas em ou após 25 de outubro de 2024. As implantações de serviços podem estar em qualquer um dos seguintes estados: + Em andamento + Pendente + Completed Você pode usar essas informações para determinar se precisa atualizar a forma como o serviço está sendo implantado ou a revisão do serviço. Para obter mais informações sobre as propriedades incluídas, consulte [Propriedades incluídas na implantação de serviço do Amazon ECS](service-deployment-property.md). Antes de começar, configure as permissões necessárias para visualizar as implantações de serviços. Para obter mais informações, consulte [Permissões necessárias para visualizar implantações de serviço do Amazon ECS](service-deployment-permissions.md). ------ #### [ Amazon ECS Console ] 1. Abra o console em [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2). 1. Na página **Clusters**, escolha o cluster. 1. Na página de detalhes do cluster, na seção **Serviços**, escolha o serviço. A página de detalhes do serviço é exibida. 1. Na página de detalhes da implantação, escolha **Implantações**. 1. Escolha a implantação do serviço a ser visualizada. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonECS/latest/developerguide/view-service-deployment.html) A página de detalhes da implantação do serviço é exibida. 1. (Opcional) Compare as revisões do serviço para visualizar as diferenças. Em **Revisões do serviço**, escolha **Comparar revisões** e selecione 2 revisões para comparar. As revisões do serviço são exibidas lado a lado com as diferenças destacadas. ------ #### [ AWS CLI ] 1. Execute `list-service-deployments` para recuperar o ARN da implantação do serviço. Substitua as variáveis por seus próprios valores. ``` aws ecs list-service-deployments --cluster cluster-name --service service-name ``` Anote o serviceDeploymentArn para a implantação que deseja visualizar. ``` { "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. Executar `describe-service-deployments`. Use o `serviceDeploymentArn` que foi devolvido de `list-service-deployments`. Substitua as variáveis por seus próprios valores. ``` aws ecs describe-service-deployments --service-deployment-arns arn:aws:ecs:region:123456789012:service-deployment/cluster-name/service-name/NCWGC2ZR-taawPAYrIaU5 ``` ------ ## Próximas etapas Você pode visualizar os detalhes das revisões de serviço na implantação. Para obter mais informações, consulte . [Visualizar detalhes da revisão de serviço do Amazon ECS](view-service-revision.md)