¿Cómo soluciono los problemas relacionados con el etiquetado de las tareas de ECS?
Quiero solucionar problemas con las etiquetas de tareas de Amazon Elastic Container Service (Amazon ECS).
Resolución
Al configurar etiquetas de tareas con Amazon ECS, es posible que experimente los siguientes problemas:
- Las etiquetas no se propagan de la definición de tarea o servicio a las tareas.
- Utiliza un ARN y un formato de ID de recursos obsoletos para las etiquetas.
- No puede añadir etiquetas a sus recursos de ECS debido a que faltan permisos de AWS Identity and Access Management (IAM) o las restricciones de las etiquetas.
- No puede ver las etiquetas de ECS en el panel de facturación de AWS.
Para solucionar estos problemas, realice las siguientes tareas.
Utilización del parámetro PropagateTags para propagar desde las definiciones de tarea o servicio a las tareas
Nota: Si se muestran errores al ejecutar comandos de la Interfaz de la línea de comandos de AWS (AWS CLI), consulte Troubleshoot AWS CLI errors. Además, asegúrese de utilizar la versión más reciente de la AWS CLI.
El parámetro PropagateTags no está activado de forma predeterminada. Active el parámetro para copiar las etiquetas de la definición de tarea o servicio a la tarea. Puede copiar etiquetas al ejecutar una tarea, crear un servicio o actualizar un servicio.
Para comprobar si PropagateTags está activado en un servicio específico, ejecute el siguiente comando en la AWS CLI:
aws ecs describe-services --services <servicename> --cluster <clustername> --region <region> --query 'services[*].propagateTags' --output text
Nota: Sustituya servicename, clustername, y region por sus valores.
Para configurar las etiquetas con la AWS CLI para que se propaguen desde la definición de tarea o servicio, ejecute los comandos run-task, create-service y update-service.
Para utilizar la consola para activar la propagación de etiquetas, siga estos pasos:
- Abra la consola de Amazon ECS.
- Seleccione la región de AWS para su recurso de ECS.
- En el panel de navegación, seleccione Definiciones de tareas.
- Seleccione la definición de la tarea en la lista de recursos y, a continuación, elija Acciones.
- Seleccione Crear servicio o Ejecutar tarea.
- En la Configuración de etiquetado de tareas, seleccione Servicio o Definiciones de tareas.
Nota: La opción predeterminada es No propagar.
Para utilizar la AWS CLI para actualizar la propagación de las etiquetas de un servicio existente, ejecute el siguiente comando:
aws ecs update-service --cluster <clustername> --service <servicename> --propagate-tags <SERVICE/TASK_DEFINITION> --force-new-deployment
Para utilizar AWS CloudFormation para configurar etiquetas en ECS, debe declarar el recurso AWS::ECS::Service. Para declarar AWS: :ECS: :Service, utilice las propiedades EnableECSManagedTags y PropagateTags con el valor SERVICE o TASK_DEFINITION.
Nota:
- Para utilizar las etiquetas de servicio relacionadas con la propiedad de ECS después de crear una pila en CloudFormation, debe actualizar la pila y el reemplazo de recursos. La actualización elimina y vuelve a crear el servicio mediante CloudFormation.
- Puede acceder a las mismas configuraciones para las tareas programadas que para las tareas lanzadas directamente desde la API RunTask de Amazon ECS.
Utilización del nuevo formato de ARN
Para etiquetar los recursos de Amazon ECS, debe utilizar los nuevos formatos de ARN e ID. Para migrar el despliegue de ECS al nuevo formato de ARN e ID de recurso, consulte Migrating your Amazon ECS deployment to the new ARN and resource ID format.
Nota: Los recursos existentes no recibirán el nuevo formato de ARN hasta que se vuelvan a crear los recursos.
Comprobación de que la entidad de IAM tiene los permisos necesarios y comprobación de las restricciones de las etiquetas
Si no puede agregar etiquetas a su servicio de ECS, siga estos pasos:
- Consulte los eventos de AWS CloudTrail para ver los eventos de TagResource.
- Revise los eventos para ver si aparece uno de los siguientes mensajes de error:
«AccessDenied»
«The tags cannot be updated at this time. Wait a few minutes and try again»
Si encuentra uno de los errores anteriores, significa que la entidad de IAM no tiene los permisos ecs:TagResource. - Utilice la consola de IAM o la AWS CLI para agregar los permisos ecs:TagResource a las entidades de IAM.
- Intente agregar de nuevo las etiquetas al clúster de ECS.
- Confirme que las etiquetas de ECS estén dentro de las restricciones de las etiquetas.
Comprobación de la existencia de un problema de administración de facturación y costes de AWS
Para comprobar que las etiquetas requeridas estén en el nivel de tareas de ECS, ejecute el comando list-tags-for-resource:
aws ecs list-tags-for-resource --resource-arn <value>
Nota: Sustituya value por el ARN.
Para utilizar la consola para comprobar que las etiquetas requeridas estén en las tareas de ECS, siga estos pasos:
- Abra la consola de Amazon ECS.
- Seleccione la región para su recurso de ECS.
- En el panel de navegación, seleccione un tipo de recurso, como Clústeres.
- Seleccione el recurso de la lista de recursos y, a continuación, elija Etiquetas. Si existen etiquetas, se mostrarán en la lista.
Si busca etiquetas administradas, active las etiquetas administradas de ECS. Para comprobar que las etiquetas administradas de ECS estén activadas, ejecute el siguiente comando:
aws ecs describe-services --services <servicename> --cluster <clustername> --region <region> --query 'services[*].enableECSManagedTags' --output text
Nota: Sustituya servicename, clustername, y region por sus valores.
La salida del comando contiene el valor enableECSManagedTags.
Para utilizar la consola para activar las etiquetas administradas de ECS, siga estos pasos:
- Abra la consola de Amazon ECS.
- Seleccione la región para su recurso de ECS.
- En el panel de navegación, seleccione Definiciones de tareas.
- Seleccione la definición de la tarea en la lista de recursos y, a continuación, elija Acciones.
- Seleccione Crear servicio o Ejecutar tarea.
- En la Configuración de etiquetado de tareas, seleccione Habilitar etiquetas administradas por ECS.
Para utilizar la AWS CLI para activar las etiquetas administradas de ECS, ejecute el comando update-service:
aws ecs update-service --cluster <clustername> --service <servicename> --enable-ecs-managed-tags --force-new-deployment
Las etiquetas que utiliza para la facturación pueden aparecer en la lista, pero no aparecen en el Explorador de costes de AWS. Para resolver este problema, active las etiquetas de asignación de costes en la consola de administración de facturación y costes.
Nota: Las etiquetas pueden tardar hasta 24 horas en activarse.
Información relacionada
Contenido relevante
- OFICIAL DE AWSActualizada hace 6 meses
- OFICIAL DE AWSActualizada hace 2 años
- OFICIAL DE AWSActualizada hace 3 años
- OFICIAL DE AWSActualizada hace 3 años