Trabalhando com tags em AWS OpsWorks for Chef Automate recursos - AWS OpsWorks
Como as tags funcionam em AWS OpsWorks for Chef AutomateAdicionar e gerenciar tags no AWS OpsWorks for Chef Automate (console)Adicionar e gerenciar tags em AWS OpsWorks for Chef Automate (CLI)Consulte também

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Trabalhando com tags em AWS OpsWorks for Chef Automate recursos

Importante

AWS OpsWorks O Chef Automate chegou ao fim da vida útil em 5 de maio de 2024 e foi desativado para clientes novos e existentes. Recomendamos que os clientes existentes migrem para o Chef SaaS ou uma solução alternativa. Se você tiver dúvidas, pode entrar em contato com a AWS Support equipe no AWS re:POST ou por meio do Premium AWS Support.

As tags são palavras ou frases que atuam como metadados para identificar e organizar os recursos da AWS. Em AWS OpsWorks for Chef Automate, um recurso pode ter até 50 tags aplicadas pelo usuário. Cada tag consiste em uma chave e em um valor opcional. É possível aplicar tags aos seguintes recursos no AWS OpsWorks for Chef Automate:

  • AWS OpsWorks for Chef Automate servidores

  • Backups de AWS OpsWorks for Chef Automate servidores

As tags nos AWS recursos podem ajudar você a monitorar custos, controlar o acesso aos recursos, agrupar recursos para automatizar tarefas ou organizar recursos por finalidade ou estágio do ciclo de vida. Para obter mais informações sobre os benefícios das tags, consulte Estratégias de marcação da AWS no AWS Answers e Usar tags de alocação de custos no Guia do usuário do AWS Billing and Cost Management .

Para usar tags para controlar o acesso a AWS OpsWorks for Chef Automate servidores ou backups, você cria ou edita declarações de política no AWS Identity and Access Management (IAM). Para obter mais informações, consulte Controlar o acesso aos recursos da AWS usando tags de recurso no Guia do usuário do AWS Identity and Access Management .

Quando você aplica tags a um AWS OpsWorks for Chef Automate servidor, as tags também são aplicadas aos backups do servidor, ao bucket do Amazon S3 que armazena os backups, à instância Amazon EC2 do servidor, aos segredos do servidor que estão armazenados AWS Secrets Manager e ao endereço IP elástico usado pelo servidor. As tags não são propagadas para a AWS CloudFormation pilha AWS OpsWorks usada para criar seu servidor.

Como as tags funcionam em AWS OpsWorks for Chef Automate

Nesta versão, é possível adicionar e gerenciar tags usando a API do AWS OpsWorks CM ou o AWS Management Console. AWS OpsWorks O CM também tenta adicionar tags que você adiciona a um servidor aos AWS recursos associados ao servidor, incluindo a instância EC2, segredos no Secrets Manager, endereço IP elástico, grupo de segurança, bucket do S3 e backups. A tabela a seguir fornece uma visão geral de como adicionar e gerenciar tags no AWS OpsWorks for Chef Automate.

Ação O que usar
Adicione tags a um novo AWS OpsWorks for Chef Automate servidor ou backup que você está criando manualmente.

  • Escolha Create Chef Automate server (Criar servidor Chef Automate) e adicione tags na página Configure advanced settings (Definir configurações avançadas).

  • Escolha Create backup (Criar backup) na página Backups para um servidor existente e adicione tags na página Create a backup of your Chef Automate 2 server (Criar um backup do servidor Chef Automate 2).

  • Adicione um parâmetro Tags aos comandos CreateServer ou CreateBackup.
Visualize tags em um recurso.

  • Na página de detalhes do servidor, escolha Tags no painel de navegação.

  • Na página Backups do servidor, selecione um backup e escolha Edit backup (Editar backup).

  • Execute o comando ListTagsForResource.
Adicione tags a um AWS OpsWorks for Chef Automate servidor ou backup existente, independentemente de o backup ter sido criado manual ou automaticamente.

  • Na página de detalhes do servidor, escolha Tags no painel de navegação e escolha Edit (Editar).

  • Na página Backups do servidor, selecione um backup e escolha Edit backup (Editar backup).

  • Execute o comando TagResource.
Exclua tags de um recurso.

  • Na página de detalhes do servidor, escolha Tags no painel de navegação e escolha Edit (Editar). Escolha X ao lado das tags que deseja excluir.

  • Na página Backups do servidor, selecione um backup e escolha Edit backup (Editar backup). Escolha X ao lado das tags que deseja excluir.

  • Execute o comando UntagResource.

As respostas DescribeServers e DescribeBackups não incluem informações de tag. Para mostrar tags, use a API ListTagsForResource.

Adicionar e gerenciar tags no AWS OpsWorks for Chef Automate (console)

Os procedimentos nesta seção são realizados na AWS Management Console.

Se você adicionar tags, uma chave de tag não poderá ficar vazia. A chave pode ter, no máximo, 127 caracteres e pode conter somente letras, números ou separadores Unicode, ou os seguintes caracteres especiais: + - = . _ : / @. Um valor de tag é opcional. É possível adicionar uma tag que tenha uma chave, mas nenhum valor. O valor pode ter, no máximo, 255 caracteres e conter somente letras, números ou separadores Unicode, ou os seguintes caracteres especiais: + - = . _ : / @

Adicionar tags a um novo AWS OpsWorks for Chef Automate servidor (console)

  1. Certifique-se de preencher todos os pré-requisitos para criar um servidor. AWS OpsWorks for Chef Automate

  2. Siga as etapas de 1 a 10 em Criar um servidor Chef Automate.

  3. Depois que especificar as configurações de backup automatizado, adicione as tags na área Tags da página Configure advanced settings (Definir configurações avançadas). É possível adicionar um máximo de 50 tags. Quando terminar de adicionar tags, escolha Próximo.

  4. Vá para a etapa 13 de Criar um servidor Chef Automate e revise as configurações escolhidas para o novo servidor.

Adicionar tags a um novo backup (console)

  1. Na página AWS OpsWorks for Chef Automate inicial, escolha um servidor Chef Automate existente.

  2. Na página de detalhes do servidor, escolha Backups no painel de navegação.

  3. Na página Backups, escolha Create backup (Criar backup).

  4. Adicione as tags. Escolha Create (Criar) quando terminar de adicionar as tags.

Adicionar ou visualizar tags em um servidor existente (console)

  1. Na página AWS OpsWorks for Chef Automate inicial, escolha um servidor Chef Automate existente para abrir sua página de detalhes.

  2. Escolha Tags no painel de navegação ou, na parte inferior da página de detalhes, escolha View all tags (Visualizar todas as tags).

  3. Na página Tags, escolha Edit (Editar).

  4. Adicione ou edite as tags no servidor. Escolha Salvar quando terminar.

    nota

    Lembre-se de que a alteração de tags no servidor Chef Automate também altera as tags nos recursos associados ao servidor, como a instância do EC2, o endereço IP elástico, o grupo de segurança, o bucket do S3 e os backups.

Adicionar ou visualizar tags em um backup existente (console)

  1. Na página AWS OpsWorks for Chef Automate inicial, escolha um servidor Chef Automate existente para abrir sua página de detalhes.

  2. Escolha Backups no painel de navegação ou, na área Recent backups (Backups recentes) da página de detalhes, escolha View all backups (Visualizar todos os backups).

  3. Na página Backups, escolha um backup para gerenciar e, depois, escolha Edit backup (Editar backup).

  4. Adicione ou edite as tags no backup. Escolha Update (Atualizar) quando terminar.

Excluir tags de um servidor (console)

  1. Na página AWS OpsWorks for Chef Automate inicial, escolha um servidor Chef Automate existente para abrir sua página de detalhes.

  2. Escolha Tags no painel de navegação ou, na parte inferior da página de detalhes, escolha View all tags (Visualizar todas as tags).

  3. Na página Tags, escolha Edit (Editar).

  4. Escolha X ao lado de uma tag para excluí-la. Escolha Salvar quando terminar.

    nota

    Lembre-se de que a alteração de tags no servidor Chef Automate também altera as tags nos recursos associados ao servidor, como a instância do EC2, o endereço IP elástico, o grupo de segurança, o bucket do S3 e os backups.

Excluir tags de um backup (console)

  1. Na página AWS OpsWorks for Chef Automate inicial, escolha um servidor Chef Automate existente para abrir sua página de detalhes.

  2. Escolha Backups no painel de navegação ou, na área Recent backups (Backups recentes) da página de detalhes, escolha View all backups (Visualizar todos os backups).

  3. Na página Backups, escolha um backup para gerenciar e, depois, escolha Edit backup (Editar backup).

  4. Escolha X ao lado de uma tag para excluí-la. Escolha Update (Atualizar) quando terminar.

Adicionar e gerenciar tags em AWS OpsWorks for Chef Automate (CLI)

Os procedimentos nesta seção são realizados na AWS CLI. Verifique se você está executando a versão mais recente do AWS CLI antes de começar a trabalhar com tags. Para obter mais informações sobre como instalar ou atualizar o AWS CLI, consulte Instalando o AWS CLI no Guia AWS Command Line Interface do Usuário.

Se você adicionar tags, uma chave de tag não poderá ficar vazia. A chave pode ter, no máximo, 127 caracteres e pode conter somente letras, números ou separadores Unicode, ou os seguintes caracteres especiais: + - = . _ : / @. Um valor de tag é opcional. É possível adicionar uma tag que tenha uma chave, mas nenhum valor. O valor pode ter, no máximo, 255 caracteres e conter somente letras, números ou separadores Unicode, ou os seguintes caracteres especiais: + - = . _ : / @

Adicionar tags a um novo AWS OpsWorks for Chef Automate servidor (CLI)

Você pode usar o AWS CLI para adicionar tags ao criar um AWS OpsWorks for Chef Automate servidor. Este procedimento não descreve na íntegra como criar um servidor. Para obter informações detalhadas sobre como criar um AWS OpsWorks for Chef Automate servidor usando o, AWS CLI consulte Crie um servidor Chef Automate usando o AWS CLI neste guia. É possível adicionar até 50 tags a um servidor.

  1. Certifique-se de preencher todos os pré-requisitos para criar um servidor. AWS OpsWorks for Chef Automate

  2. Conclua as etapas 1 a 5 de Crie um servidor Chef Automate usando o AWS CLI.

  3. Na etapa 6, ao executar o comando create-server, adicione o parâmetro --tags ao comando, conforme mostrado no exemplo a seguir.

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

    Veja a seguir um exemplo que mostra somente a parte de tags do comando create-server.

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

  4. Conclua as etapas restantes em Crie um servidor Chef Automate usando o AWS CLI. Para verificar se as tags foram adicionadas ao novo servidor, siga as etapas em Listar tags de recurso neste tópico.

Adicionar tags a um novo backup (CLI)

Você pode usar o AWS CLI para adicionar tags ao criar um novo backup manual de um AWS OpsWorks for Chef Automate servidor. Este procedimento não descreve na íntegra como criar um backup manual. Para obter informações detalhadas sobre como criar um backup manual, consulte “Para realizar um backup manual no AWS CLI" emFaça backup de um AWS OpsWorks for Chef Automate servidor. É possível adicionar até 50 tags a um backup. Se um servidor tiver tags, novos backups serão marcados automaticamente com as tags do servidor.

Por padrão, quando você cria um novo AWS OpsWorks for Chef Automate servidor, os backups automatizados são habilitados. É possível adicionar tags a um backup automatizado executando o comando tag-resource, descrito em Adicionar tags a backups ou servidores existentes (CLI) neste tópico.

  • Para adicionar tags a um backup manual à medida que cria o backup, execute o comando a seguir. Somente a parte de tags do comando é exibida. Para obter um exemplo do comando create-backup completo, consulte "Como executar um backup manual na AWS CLI" em Faça backup de um AWS OpsWorks for Chef Automate servidor.

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

    O exemplo a seguir mostra somente a parte de tags do comando create-backup.

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

Adicionar tags a backups ou servidores existentes (CLI)

É possível executar o comando tag-resource para adicionar tags a servidores do AWS OpsWorks for Chef Automate ou backups existentes (se os backups foram criados manual ou automaticamente). Especifique o número de recurso da Amazon (ARN) de um recurso de destino para adicionar tags a ele.

  1. Para obter o ARN do recurso ao qual deseja aplicar tags:

    • Para um servidor, execute describe-servers --server-name server_name. Os resultados do comando mostram o ARN do servidor.

    • Para um backup, execute describe-backups --backup-id backup_ID. Os resultados do comando mostram o ARN do backup. Você também pode executar describe-backups --server-name server_name para mostrar informações sobre todos os backups de um AWS OpsWorks for Chef Automate servidor específico.

    O exemplo a seguir mostra somente o ServerArn nos resultados de um comando describe-servers --server-name opsworks-cm-test. O valor ServerArn é adicionado a um comando tag-resource para adicionar tags ao servidor.

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

  2. Execute o comando tag-resource com o ARN retornado na etapa 1.

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

    Veja um exemplo a seguir.

    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 verificar se as tags foram adicionadas com êxito, vá para o próximo procedimento, Listar tags de recurso.

Listar tags de recurso

Você pode executar o list-tags-for-resource comando para mostrar as tags que estão anexadas aos AWS OpsWorks for Chef Automate servidores ou backups. Especifique o ARN de um recurso de destino para exibir suas tags.

  1. Para obter o ARN do recurso para o qual deseja listar tags:

    • Para um servidor, execute describe-servers --server-name server_name. Os resultados do comando mostram o ARN do servidor.

    • Para um backup, execute describe-backups --backup-id backup_ID. Os resultados do comando mostram o ARN do backup. Você também pode executar describe-backups --server-name server_name para mostrar informações sobre todos os backups de um AWS OpsWorks for Chef Automate servidor específico.

  2. Execute o comando list-tags-for-resource com o ARN retornado na etapa 1.

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

    Veja um exemplo a seguir.

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

    Se houver tags no recurso, o comando retornará resultados como os seguintes.

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

Excluir tags de um recurso

É possível executar o comando untag-resource para excluir tags de servidores do AWS OpsWorks for Chef Automate ou de backups. Se o recurso for excluído, as tags no recurso também serão excluídas. Especifique o número de recurso da Amazon (ARN) de um recurso de destino para remover as tags dele.

  1. Para obter o ARN do recurso do qual deseja remover tags:

    • Para um servidor, execute describe-servers --server-name server_name. Os resultados do comando mostram o ARN do servidor.

    • Para um backup, execute describe-backups --backup-id backup_ID. Os resultados do comando mostram o ARN do backup. Você também pode executar describe-backups --server-name server_name para mostrar informações sobre todos os backups de um AWS OpsWorks for Chef Automate servidor específico.

  2. Execute o comando untag-resource com o ARN retornado na etapa 1. Especifique somente as tags que deseja excluir.

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

    Neste exemplo, o comando untag-resource remove somente a tag com uma chave de Stage e um valor de 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 verificar se as tags foram excluídas com êxito, siga as etapas em Listar tags de recurso neste tópico.

Consulte também