# Visualización del historial de servicios mediante las implementaciones de servicios de Amazon ECS
Las implementaciones de servicios proporcionan una visión completa de las implementaciones. Las implementaciones de servicio proporcionan la siguiente información acerca del servicio:
+ La configuración de la carga de trabajo actualmente implementada (la revisión de servicios de origen)
+ La configuración de la carga de trabajo que se está implementando (la revisión de servicios de destino)
+ Estado de las implementaciones
+ El número de tareas con errores que detectó el interruptor
+ Las alarmas de CloudWatch que están en alarma
+ Cuando se inició y finalizó la implementación del servicio
+ Los detalles de una reversión, si se ha producido
Para obtener información sobre las propiedades de implementación del servicio, consulte [Propiedades incluidas en la implementación de un servicio de Amazon ECS](service-deployment-property.md).
Las implementaciones de servicios son de solo lectura y cada una tiene un identificador único.
Hay tres etapas de implementación del servicio:
| Etapa | Definición | Estados asociados |
| --- | --- | --- |
| Pending (Pendiente) | Se ha creado una implementación de servicios, pero no se ha iniciado | PENDIENTE |
| Continuo | La implementación de servicios está en curso. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AmazonECS/latest/developerguide/service-deployment.html) |
| Completado | La implementación de un servicio ha finalizado (correctamente o con errores) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AmazonECS/latest/developerguide/service-deployment.html) |
Utilice las implementaciones de servicios para comprender el ciclo de vida de su servicio y determinar si hay alguna acción que deba tomar. Por ejemplo, si se ha producido una reversión, es posible que tenga que investigar la implementación del servicio y analizar los eventos del servicio.
Puede ver el historial de 90 días más reciente de las implementaciones creadas a partir del 25 de octubre de 2024 mediante la consola, la API y la AWS CLI.
Puede detener una implementación que no se haya completado. Para obtener más información, consulte [Detención de las implementaciones de servicios de Amazon ECS](stop-service-deployment.md).
## Ciclo de la implementación de servicios
Amazon ECS crea una nueva implementación de servicio automáticamente cuando se produce alguna de las siguientes acciones:
+ Un usuario crea un servicio.
+ Un usuario actualiza el servicio y utiliza la opción de forzar una nueva implementación.
+ Un usuario actualiza una o varias propiedades del servicio que requieren una implementación.
Mientras la implementación está en curso, Amazon ECS actualiza las siguientes propiedades de implementación de servicios para reflejar el progreso de la implementación de servicios:
+ El estado
+ El número de tareas en ejecución
Es posible que el número de tareas en ejecución indicado en la revisión de servicios no sea igual al número real de tareas en ejecución. Este número representa el número de tareas en ejecución cuando se completó la implementación. Por ejemplo, si ha lanzado tareas independientes de la implementación del servicio, esas tareas no se incluyen en el recuento de tareas en ejecución para la revisión de servicios.
+ Detección de error en el interruptor:
+ El número de tareas que han presentado un error al iniciarse
+ Detección de un error de alarma de CloudWatch
+ Las alarmas activas
+ Información de reversión:
+ La hora de inicio
+ El motivo de la reversión
+ El ARN de la revisión de servicio que se utilizó para la reversión
+ El motivo del estado
Amazon ECS elimina la implementación del servicio cuando usted elimina un servicio.
## Estados de implementaciones de servicios
La implementación de un servicio comienza en el estado `PENDING`.
En la siguiente ilustración se muestran los estados de implementación del servicio que pueden producirse después del estado `PENDING`: `IN_PROGRESS`, `ROLLBACK_REQUESTED`, `SUCCESSFUL`, `STOP_REQUESTED`, `ROLLBACK_IN_PROGRESSS`, `ROLLBACK_FAILED`, `ROLLBACK_SUCCESSFUL` y `STOPPED`.
![\[Los estados STOP_REQUESTED, SUCCESSFUL y ROLLBACK_IN_PROGRESS de implementación del servicio pueden producirse después del estado IN_PROGRESS.\]](http://docs.aws.amazon.com/es_es/AmazonECS/latest/developerguide/images/service-deployment-states.png)
La siguiente información proporciona detalles sobre los estados de implementación de servicios:
+ `PENDING`: se ha creado la implementación de servicios, pero no se ha iniciado.
El estado puede pasar a ser `IN_PROGRESS`, `ROLLBACK_REQUESTED`, `STOP_REQUESTED` o `STOPPED`.
+ `IN_PROGRESS`: la implementación del servicio está en curso.
El estado puede pasar a ser `SUCCESSFUL`, `STOP_REQUESTED`, `ROLLBACK_REQUESTED`, `ROLLBACK_IN_PROGRESS` y `STOPPED`.
+ `STOP_REQUESTED`: el estado de implementación del servicio pasa a ser `STOP_REQUESTED` cuando ocurre alguna de las siguientes situaciones:
+ Un usuario inicia una nueva implementación de servicios.
+ La opción de reversión no se utiliza para el mecanismo de detección de errores (el interruptor o la alarma) y el servicio no alcanza el estado `SUCCESSFUL`.
El estado pasa a ser `STOPPED`.
+ `ROLLBACK_REQUESTED`: el estado de implementación del servicio pasa a `ROLLBACK_REQUESTED` cuando un usuario solicita una reversión a través de la consola, la API o la CLI.
El estado puede pasar a ser `SUCCESSFUL`, `ROLLBACK_IN_PROGRESS` y `STOPPED`.
+ `SUCCESSFUL`: el estado de implementación del servicio pasa a ser `SUCCESSFUL` cuando la implementación del servicio se completa correctamente.
+ `ROLLBACK_IN_PROGRESS`: el estado de implementación del servicio pasa a ser `ROLLBACK_IN_PROGRESS` cuando se utiliza la opción de reversión para el mecanismo de detección de errores (el interruptor o la alarma) y el servicio produce un error.
El estado pasa a ser `ROLLBACK_SUCCESSFUL` o `ROLLBACK_FAILED`.
# Propiedades incluidas en la implementación de un servicio de Amazon ECS
Las siguientes propiedades se incluyen en la implementación de un servicio.
| Propiedad | Descripción |
| --- | --- |
| ARN de implementación de servicios | El ARN de la implementación de servicios. |
| ARN de servicio | El ARN del servicio para esta implementación de servicios. |
| ARN del clúster | El ARN del clúster que aloja el servicio. |
| Hora de creación de la implementación de servicios | La hora a la que se creó la implementación de servicios. |
| Hora de inicio de la implementación de servicios | La hora a la que se inició la implementación de servicios. |
| Hora de finalización de la implementación de servicios | La hora a la que finalizó la implementación de servicios. |
| Hora de detención de la implementación de servicios | La hora a la que se detuvo la implementación de servicios. |
| Hora de actualización de la implementación de servicios | La hora de la última actualización de la implementación de servicios. |
| Revisiones de servicios de origen | Las revisiones del servicio que se están ejecutando actualmente. Para obtener más información sobre las propiedades incluidas, consulte [Propiedades incluidas en una revisión de servicios de Amazon ECS](service-revision-property.md). |
| Configuración de implementación | Los parámetros de implementación incluyen la configuración del interruptor y las alarmas que determinan.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AmazonECS/latest/developerguide/service-deployment-property.html) |
| Revisión de servicios de destino | La revisión de servicios que se debe implementar. Una vez que la implementación se complete correctamente, la revisión de servicios de destino es la revisión de servicios en ejecución. |
| Estados de implementación de servicios | El estado de la implementación de servicios.Los valores válidos son PENDING, SUCCESSFUL, STOP\$1REQUESTED, STOP\$1IN\$1PROGRESS, IN\$1PROGRESS, ROLLBACK\$1IN\$1PROGRESS, ROLLBACK\$1SUCCESSFUL y ROLLBACK\$1FAILED. |
| Información de estado de la implementación de servicios | Información sobre por qué la implementación del servicio se encuentra en el estado actual. Por ejemplo, el interruptor detectó un error. |
| Información de reversión | Las opciones de reversión que utiliza la implementación del servicio cuando se produce un error en la implementación. |
| Opciones de interruptor de implementación de servicios | El interruptor que determina que se produjo un error en la implementación de un servicio. |
| Alarmas de CloudWatch para la implementación de servicios | Las alarmas de CloudWatch que determinan cuándo se produce un error en la implementación de un servicio. |
# Permisos necesarios para ver las implementaciones de servicios de Amazon ECS
Si sigue la práctica recomendada de concesión de privilegios mínimos, debe agregar más permisos para ver las implementaciones de servicios en la consola.
Debe acceder a las siguientes acciones:
+ ListServiceDeployments
+ DescribeServiceDeployments
+ DescribeServiceRevisions
Debe acceder a los siguientes recursos:
+ Servicio
+ Implementación de servicios
+ Revisión de servicios
La siguiente política de ejemplo contiene los permisos necesarios y limita las acciones a un servicio especificado.
Sustituya `account`, `cluster-name` y `service-name` por sus 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/*"
]
}
]
}
```
------
# Visualización de las implementaciones de servicios de Amazon ECS
Puede consultar el historial de 90 días más reciente de las implementaciones creadas a partir del 25 de octubre de 2024. Las implementaciones de servicios pueden tener alguno de los estados que se indican a continuación:
+ En curso
+ Pending (Pendiente)
+ Completado
Puede usar esta información para determinar si debe actualizar la forma en que se implementa el servicio o la revisión de servicios. Para obtener más información sobre las propiedades incluidas, consulte [Propiedades incluidas en la implementación de un servicio de Amazon ECS](service-deployment-property.md).
Antes de empezar, configure los permisos necesarios para ver las implementaciones de servicios. Para obtener más información, consulte [Permisos necesarios para ver las implementaciones de servicios de Amazon ECS](service-deployment-permissions.md).
------
#### [ Amazon ECS Console ]
1. Abra la consola en [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2).
1. En la página **Clusters** (Clústeres), elija el clúster.
1. En la página de detalles del clúster, en la sección **Servicios**, elija el servicio.
Aparecerá la página de detalles del servicio.
1. En la página de detalles del servicio, elija **Implementaciones**.
1. Elija la implementación de servicios que desea ver.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AmazonECS/latest/developerguide/view-service-deployment.html)
Se abrirá la página de detalles de la implementación de servicios.
1. (Opcional) Compare las revisiones del servicio para ver las diferencias.
En **Revisiones del servicio**, elija **Comparar revisiones** y, a continuación, seleccione 2 revisiones para comparar.
Las revisiones del servicio se muestran una al lado de la otra con las diferencias resaltadas.
------
#### [ AWS CLI ]
1. Ejecute `list-service-deployments` para recuperar el ARN de implementación del servicio.
Sustituya las variables por valores propios.
```
aws ecs list-service-deployments --cluster cluster-name --service service-name
```
Anote el identificador serviceDeploymentArn de la implementación que quiere ver.
```
{
"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. Ejecuta `describe-service-deployments`. Utilice el identificador `serviceDeploymentArn` que se devolvió de `list-service-deployments`.
Sustituya las variables por valores propios.
```
aws ecs describe-service-deployments --service-deployment-arns arn:aws:ecs:region:123456789012:service-deployment/cluster-name/service-name/NCWGC2ZR-taawPAYrIaU5
```
------
## Siguientes pasos
Puede ver los detalles de las revisiones de servicios en la implementación. Para obtener más información, consulte [Visualización de los detalles de la revisión de servicios de Amazon ECS](view-service-revision.md)