Trabajar con etiquetas en AWS OpsWorks for Chef Automate los recursos - AWS OpsWorks
Cómo funcionan las etiquetas en AWS OpsWorks for Chef AutomateAgregue y administre etiquetas en AWS OpsWorks for Chef Automate (consola)Agregar y administrar etiquetas en AWS OpsWorks for Chef Automate (CLI)Véase también

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Trabajar con etiquetas en AWS OpsWorks for Chef Automate los recursos

importante

AWS OpsWorks para Chef Automate llegó al final de su vida útil el 5 de mayo de 2024 y se ha desactivado tanto para los clientes nuevos como para los actuales. Recomendamos que los clientes actuales migren a Chef SaaS o a una solución alternativa. Si tienes alguna pregunta, puedes ponerte en contacto con el AWS Support equipo en AWS Re:post o a través de Premium AWS Support.

Las etiquetas son palabras o frases que funcionan como metadatos para identificar y organizar sus recursos de AWS. En AWS OpsWorks for Chef Automate, un recurso puede tener hasta 50 etiquetas aplicadas por los usuarios. Cada etiqueta consta de una clave y un valor opcional. Puede aplicar etiquetas a los siguientes recursos de AWS OpsWorks for Chef Automate:

  • AWS OpsWorks for Chef Automate servidores

  • Respaldos de AWS OpsWorks for Chef Automate servidores

Las etiquetas de AWS los recursos pueden ayudarle a realizar un seguimiento de los costes, controlar el acceso a los recursos, agrupar los recursos para automatizar tareas u organizar los recursos por finalidad o fase del ciclo de vida. Para obtener más información sobre los beneficios de las etiquetas, consulte este artículo de AWS Answers sobre las estrategias de etiquetado de AWS y el artículo Uso de etiquetas de asignación de costos de la Guía del usuario de AWS Billing and Cost Management .

Para usar etiquetas para controlar el acceso a AWS OpsWorks for Chef Automate los servidores o las copias de seguridad, debe crear o editar las declaraciones de políticas en AWS Identity and Access Management (IAM). Para obtener más información, consulte Control del acceso a los recursos de AWS mediante etiquetas de recursos en la Guía del usuario de AWS Identity and Access Management .

Al aplicar etiquetas a un AWS OpsWorks for Chef Automate servidor, las etiquetas también se aplican a las copias de seguridad del servidor, al bucket de Amazon S3 que almacena las copias de seguridad, a la instancia Amazon EC2 del servidor, a los secretos del servidor que se almacenan y a la dirección IP elástica utilizada por el servidor. AWS Secrets Manager Las etiquetas no se propagan a la AWS CloudFormation pila que se AWS OpsWorks utiliza para crear el servidor.

Cómo funcionan las etiquetas en AWS OpsWorks for Chef Automate

En esta versión, puede agregar y administrar etiquetas utilizando la API de CM de AWS OpsWorks o la AWS Management Console. AWS OpsWorks CM también intenta añadir las etiquetas que se añaden a un servidor a los AWS recursos asociados al servidor, como la instancia EC2, los secretos de Secrets Manager, la dirección IP elástica, el grupo de seguridad, el bucket de S3 y las copias de seguridad. La tabla siguiente contiene información general acerca de cómo agregar y administrar etiquetas en AWS OpsWorks for Chef Automate.

Acción Qué se usa
Agregue etiquetas a un nuevo AWS OpsWorks for Chef Automate servidor o a una copia de seguridad que esté creando manualmente.

  • Elija Create Chef Automate server (Crear servidor de Chef Automate) y agregue etiquetas en la página Configure advanced settings (Configurar opciones avanzadas).

  • Elija Create backup (Crear copia de seguridad) en la página Backups (Copias de seguridad) para un servidor existente y agregue etiquetas en la página Create a backup of your Chef Automate 2 server (Crear una copia de seguridad de su servidor Chef Automate 2).

  • Agregue un parámetro Tags a los comandos CreateServer o CreateBackup.
Consultar las etiquetas de un recurso.

  • En la página de detalles del servidor, elija Tags (Etiquetas) en el panel de navegación.

  • En la página Copias de seguridad del servidor, seleccione una copia de seguridad y, a continuación, elija Editar copia de seguridad.

  • Ejecute el comando ListTagsForResource.
Agregue etiquetas a un AWS OpsWorks for Chef Automate servidor existente o a una copia de seguridad, independientemente de si la copia de seguridad se creó manual o automáticamente.

  • En la página de detalles del servidor, elija Etiquetas en el panel de navegación y, a continuación, elija Editar.

  • En la página Copias de seguridad del servidor, seleccione una copia de seguridad y, a continuación, elija Editar copia de seguridad.

  • Ejecute el comando TagResource.
Eliminar etiquetas de un recurso.

  • En la página de detalles del servidor, elija Etiquetas en el panel de navegación y, a continuación, elija Editar. Elija X junto a las etiquetas que desee eliminar.

  • En la página Copias de seguridad del servidor, seleccione una copia de seguridad y, a continuación, elija Editar copia de seguridad. Elija X junto a las etiquetas que desee eliminar.

  • Ejecute el comando UntagResource.

Las respuestas de DescribeServers y DescribeBackups no contienen información sobre las etiquetas. Para mostrar etiquetas, use la API ListTagsForResource.

Agregue y administre etiquetas en AWS OpsWorks for Chef Automate (consola)

Los procedimientos de esta sección se realizan en la AWS Management Console.

Si agrega etiquetas, las claves de etiqueta no pueden estar vacías. La clave puede tener un máximo de 127 caracteres y solo puede contener letras, números o separadores Unicode o los siguientes caracteres especiales: + - = . _ : / @. El valor de etiqueta es opcional. Puede agregar una etiqueta que tenga una clave, pero no valores. El valor puede tener un máximo de 255 caracteres y solo puede contener letras, números o separadores Unicode o los caracteres especiales siguientes: + - = . _ : / @.

Añadir etiquetas a un nuevo AWS OpsWorks for Chef Automate servidor (consola)

  1. Asegúrese de cumplir todos los requisitos previos para crear un AWS OpsWorks for Chef Automate servidor.

  2. Siga los pasos del 1 al 10 en Crear un servidor de Chef Automate.

  3. Después de especificar la configuración de copia de seguridad automatizada, agregue etiquetas en la zona Tags (Etiquetas) de la página Configure advanced settings (Configurar opciones avanzadas). Puede agregar un máximo de 50 etiquetas. Cuando haya terminado de añadir etiquetas, elija Next (Siguiente).

  4. Vaya al paso 13 de Crear un servidor de Chef Automate y revise la configuración que ha elegido para el nuevo servidor.

Agregar etiquetas a una nueva copia de seguridad (consola)

  1. En la página de AWS OpsWorks for Chef Automate inicio, elija un servidor Chef Automate existente.

  2. En la página de detalles del servidor, elija Backups (Copias de seguridad) en el panel de navegación.

  3. En la página Backups (Copias de seguridad), elija Create backup (Crear copia de seguridad).

  4. Agregue etiquetas. Cuando termine de agregar etiquetas, elija Create (Crear).

Agregar o consultar etiquetas en un servidor existente (consola)

  1. En la página de AWS OpsWorks for Chef Automate inicio, elija un servidor Chef Automate existente para abrir su página de detalles.

  2. Elija Tags (Etiquetas) en el panel de navegación o, en la parte inferior de la página de detalles, elija View all tags (Ver todas las etiquetas).

  3. En la página Tags (Etiquetas), elija Edit (Editar).

  4. Agregue o edite etiquetas en el servidor. Cuando termine, elija Save (Guardar).

    nota

    Tenga en cuenta que el cambio de etiquetas en el servidor de Chef Automate también cambia las etiquetas en los recursos asociados al servidor, como la instancia EC2, la dirección IP elástica, el grupo de seguridad, el bucket de S3 y las copias de seguridad.

Agregar o consultar etiquetas en una copia de seguridad existente (consola)

  1. En la página de AWS OpsWorks for Chef Automate inicio, elija un servidor Chef Automate existente para abrir su página de detalles.

  2. Elija Backups (Copias de seguridad) en el panel de navegación o en el área Recent backups (Copias de seguridad recientes) de la página de detalles, elija View all backups (Ver todas las copias de seguridad).

  3. En la página Backups (Copias de seguridad), elija una copia de seguridad para administrar y, a continuación, elija Edit backup (Editar copia de seguridad).

  4. Agregue o edite etiquetas en la copia de seguridad. Elija Update (Actualizar) cuando haya terminado.

Eliminar etiquetas de un servidor (consola)

  1. En la página de AWS OpsWorks for Chef Automate inicio, elija un servidor Chef Automate existente para abrir su página de detalles.

  2. Elija Tags (Etiquetas) en el panel de navegación o, en la parte inferior de la página de detalles, elija View all tags (Ver todas las etiquetas).

  3. En la página Tags (Etiquetas), elija Edit (Editar).

  4. Elija X junto a una etiqueta para eliminarla. Cuando termine, elija Save (Guardar).

    nota

    Tenga en cuenta que el cambio de etiquetas en el servidor de Chef Automate también cambia las etiquetas en los recursos asociados al servidor, como la instancia EC2, la dirección IP elástica, el grupo de seguridad, el bucket de S3 y las copias de seguridad.

Eliminar etiquetas de una copia de seguridad (consola)

  1. En la página de AWS OpsWorks for Chef Automate inicio, elija un servidor Chef Automate existente para abrir su página de detalles.

  2. Elija Backups (Copias de seguridad) en el panel de navegación o en el área Recent backups (Copias de seguridad recientes) de la página de detalles, elija View all backups (Ver todas las copias de seguridad).

  3. En la página Backups (Copias de seguridad), elija una copia de seguridad para administrar y, a continuación, elija Edit backup (Editar copia de seguridad).

  4. Elija X junto a una etiqueta para eliminarla. Elija Update (Actualizar) cuando haya terminado.

Agregar y administrar etiquetas en AWS OpsWorks for Chef Automate (CLI)

Los procedimientos de esta sección se realizan en la AWS CLI. Asegúrese de utilizar la versión más reciente de AWS CLI antes de empezar a trabajar con las etiquetas. Para obtener más información sobre la instalación o actualización de AWS CLI, consulte Instalación de AWS CLI en la Guía del AWS Command Line Interface usuario.

Si agrega etiquetas, las claves de etiqueta no pueden estar vacías. La clave puede tener un máximo de 127 caracteres y solo puede contener letras, números o separadores Unicode o los siguientes caracteres especiales: + - = . _ : / @. El valor de etiqueta es opcional. Puede agregar una etiqueta que tenga una clave, pero no valores. El valor puede tener un máximo de 255 caracteres y solo puede contener letras, números o separadores Unicode o los caracteres especiales siguientes: + - = . _ : / @.

Agregar etiquetas a un nuevo AWS OpsWorks for Chef Automate servidor (CLI)

Puede utilizarla AWS CLI para añadir etiquetas al crear un AWS OpsWorks for Chef Automate servidor. Este procedimiento no describe completamente cómo se crea un servidor. Para obtener información detallada sobre cómo crear un AWS OpsWorks for Chef Automate servidor mediante el uso, AWS CLI consulte Cree un servidor de Chef Automate utilizando el AWS CLI esta guía. Puede agregar hasta 50 etiquetas a un servidor.

  1. Asegúrese de cumplir todos los requisitos previos para crear un AWS OpsWorks for Chef Automate servidor.

  2. Complete los pasos 1 a 5 de Cree un servidor de Chef Automate utilizando el AWS CLI.

  3. En el paso 6, cuando ejecute el comando create-server, agregue el parámetro --tags al comando, tal y como se muestra en el ejemplo siguiente.

    aws opsworks-cm create-server ... --tags Key=Key1,Value=Value1 Key=Key2,Value=Value2

    A continuación, se incluye un ejemplo en el que solo se muestra la parte de las etiquetas del comando create-server.

    aws opsworks-cm create-server ... --tags Key=Stage,Value=Production Key=Department,Value=Marketing

  4. Complete los demás pasos proporcionados en Cree un servidor de Chef Automate utilizando el AWS CLI. Para comprobar si las etiquetas se agregaron al nuevo servidor, siga los pasos que se indican en la sección Enumerar etiquetas de recursos de este tema.

Agregar etiquetas a una nueva copia de seguridad (CLI)

Puede utilizarla AWS CLI para añadir etiquetas al crear una nueva copia de seguridad manual de un AWS OpsWorks for Chef Automate servidor. Este procedimiento no describe completamente cómo se crea una copia de seguridad manual. Para obtener información detallada sobre cómo crear una copia de seguridad manual, consulte «Para realizar una copia de seguridad manual en AWS CLI» enHacer una copia de seguridad de un AWS OpsWorks for Chef Automate servidor. Puede agregar hasta 50 etiquetas a una copia de seguridad. Si un servidor tiene etiquetas, las copias de seguridad nuevas se etiquetan automáticamente con las etiquetas del servidor.

De forma predeterminada, al crear un AWS OpsWorks for Chef Automate servidor nuevo, las copias de seguridad automáticas están habilitadas. Puede agregar etiquetas a una copia de seguridad automatizada ejecutando el comando tag-resource que se describe en la sección Agregar etiquetas a un servidor o una copia de seguridad existentes (CLI) de este tema.

  • Para agregar etiquetas a una copia de seguridad manual mientras crea la copia de seguridad, ejecute el siguiente comando. Solo se muestra la parte de las etiquetas del comando. Para ver un ejemplo completo del comando create-backup, consulte «Para realizar una copia de seguridad manual en la AWS CLI" en Hacer una copia de seguridad de un AWS OpsWorks for Chef Automate servidor.

    aws opsworks-cm create-backup ... --tags Key=Key1,Value=Value1 Key=Key2,Value=Value2

    En el ejemplo siguiente, solo se muestra la parte de las etiquetas del comando create-backup.

    aws opsworks-cm create-backup ... --tags Key=Stage,Value=Production Key=Department,Value=Marketing

Agregar etiquetas a un servidor o una copia de seguridad existentes (CLI)

Puede ejecutar el comando tag-resource para agregar etiquetas a un servidor o una copia de seguridad de AWS OpsWorks for Chef Automate existente (independientemente de si las copias de seguridad se crearon de forma automática o manual). Especifique el número de recurso de Amazon (ARN) de un recurso de destino para agregarle etiquetas.

  1. Para obtener el ARN del recurso al que desea aplicar etiquetas:

    • Si se trata de un servidor, ejecute describe-servers --server-name server_name. Los resultados del comando muestran el ARN del servidor.

    • Si se trata de una copia de seguridad, ejecute describe-backups --backup-id backup_ID. Los resultados del comando muestran el ARN de la copia de seguridad. También puede ejecutar describe-backups --server-name server_name para mostrar información sobre todas las copias de seguridad de un AWS OpsWorks for Chef Automate servidor específico.

    En el ejemplo siguiente, solo se muestra el ServerArn de los resultados de un comando describe-servers --server-name opsworks-cm-test. El valor de ServerArn se agrega a un comando tag-resource para agregar etiquetas al servidor.

    {
    "Servers": [
        {
            ...
            "ServerArn": "arn:aws:opsworks-cm:us-west-2:123456789012:server/opsworks-cm-test/EXAMPLEd-66b0-4196-8274-d1a2bEXAMPLE"
        }
    ]
}

  2. Ejecute el comando tag-resource con el ARN devuelto en el paso 1.

    aws opsworks-cm tag-resource --resource-arn "server_or_backup_ARN" --tags Key=Key1,Value=Value1 Key=Key2,Value=Value2

    A continuación, se muestra un ejemplo.

    aws opsworks-cm tag-resource --resource-arn "arn:aws:opsworks-cm:us-west-2:123456789012:server/opsworks-cm-test/EXAMPLEd-66b0-4196-8274-d1a2bEXAMPLE" --tags Key=Stage,Value=Production Key=Department,Value=Marketing

  3. Para comprobar si las etiquetas se agregaron correctamente, complete el siguiente procedimiento, Enumerar etiquetas de recursos.

Enumerar etiquetas de recursos

Puede ejecutar el list-tags-for-resource comando para mostrar las etiquetas adjuntas a los AWS OpsWorks for Chef Automate servidores o a las copias de seguridad. Especifique el ARN de un recurso de destino para ver sus etiquetas.

  1. Para obtener el ARN del recurso cuyas etiquetas desea mostrar:

    • Si se trata de un servidor, ejecute describe-servers --server-name server_name. Los resultados del comando muestran el ARN del servidor.

    • Si se trata de una copia de seguridad, ejecute describe-backups --backup-id backup_ID. Los resultados del comando muestran el ARN de la copia de seguridad. También puede ejecutarlo describe-backups --server-name server_name para mostrar información sobre todas las copias de seguridad de un AWS OpsWorks for Chef Automate servidor específico.

  2. Ejecute el comando list-tags-for-resource con el ARN devuelto en el paso 1.

    aws opsworks-cm list-tags-for-resource --resource-arn "server_or_backup_ARN"

    A continuación, se muestra un ejemplo.

    aws opsworks-cm tag-resource --resource-arn "arn:aws:opsworks-cm:us-west-2:123456789012:server/opsworks-cm-test/EXAMPLEd-66b0-4196-8274-d1a2bEXAMPLE"

    Si hay etiquetas en el recurso, el comando devuelve resultados como los siguientes.

    {
    "Tags": [
        {
            "Key": "Stage",
            "Value": "Production"
        },
        {
            "Key": "Department",
            "Value": "Marketing"
        }
    ]
}

Eliminar etiquetas de un recurso

Puede ejecutar el comando untag-resource para eliminar etiquetas de los servidores o copias de seguridad de AWS OpsWorks for Chef Automate . Si se elimina el recurso, también se eliminan las etiquetas del recurso. Especifique el número de recurso de Amazon (ARN) de un recurso de destino para eliminar sus etiquetas.

  1. Para obtener el ARN del recurso cuyas etiquetas desea eliminar:

    • Si se trata de un servidor, ejecute describe-servers --server-name server_name. Los resultados del comando muestran el ARN del servidor.

    • Si se trata de una copia de seguridad, ejecute describe-backups --backup-id backup_ID. Los resultados del comando muestran el ARN de la copia de seguridad. También puedes ejecutar describe-backups --server-name server_name para mostrar información sobre todas las copias de seguridad de un AWS OpsWorks for Chef Automate servidor específico.

  2. Ejecute el comando untag-resource con el ARN devuelto en el paso 1. Especifique exclusivamente las etiquetas que desea eliminar.

    aws opsworks-cm untag-resource --resource-arn "server_or_backup_ARN" --tags Key=Key1,Value=Value1 Key=Key2,Value=Value2

    En este ejemplo, el comando untag-resource solo elimina la etiqueta con la clave Stage y el valor Production.

    aws opsworks-cm untag-resource --resource-arn "arn:aws:opsworks-cm:us-west-2:123456789012:server/opsworks-cm-test/EXAMPLEd-66b0-4196-8274-d1a2bEXAMPLE" --tags Key=Stage,Value=Production

  3. Para comprobar si las etiquetas se eliminaron correctamente, siga los pasos que se indican en la sección Enumerar etiquetas de recursos de este tema.

Véase también