Documentação do Oracle Cloud Infrastructure

Aplicando tags de formato livre e tags definidas a repositórios, imagens e assinaturas de imagem

Descubra como adicionar tags de formato livre e tags definidas a repositórios, imagens e assinaturas de imagem com o Container Registry.

Você pode usar tags do Oracle Cloud Infrastructure para organizar, controlar, gerenciar e gerar relatórios sobre os recursos do Container Registry (repositórios, imagens, assinaturas de imagem) que você usa. O serviço Tagging permite que você agrupe recursos diferentes entre compartimentos e também permite anotar recursos com seus próprios metadados.

Normalmente, você encontrará tags úteis para:

  • Rastreamento de recursos: Por exemplo, para gerar relatórios sobre alguns ou todos os recursos do Container Registry que você usa.

  • Rastreamento de custos: Por exemplo, para obter relatórios de custos detalhados para repositórios do Container Registry, para ativar a cobrança retroativa do uso para o centro de custos apropriado. Observe que você só pode usar tags aplicadas a repositórios para fins de rastreamento de custos.

  • Agrupamento de autorização: Por exemplo, para conceder ou limitar o acesso a repositórios com uma tag específica. Consulte Observações sobre o uso de tags para controlar o acesso a Repositórios, Imagens e Assinaturas de Imagem.

Se você tiver permissões para criar um recurso, também terá permissões para aplicar tags de formato livre a esse recurso. Para aplicar uma tag definida, você deverá ter permissões para usar o namespace de tags. Para obter mais informações sobre tags, consulte Tags de Recursos.

Usando a Console para Especificar as Tags de Formato Livre e as Tags Definidas a Serem Aplicadas aos Repositórios

Para adicionar uma tag de formato livre ou uma tag definida ao criar um novo repositório:

  1. Siga as instruções em Criando um Repositório: Usando a Console para criar um novo repositório usando a caixa de diálogo Criar repositório.

  2. Selecione Adicionar tag.

  3. Para adicionar uma tag definida ao repositório, especifique:

    • Namespace: Selecione o namespace de tag ao qual a tag pertence.

    • Chave: Selecione o nome da tag definida a ser aplicada ao repositório.

    • Valor: Selecione o valor da tag de uma lista de valores predefinida, informe um novo valor ou deixe em branco (dependendo de como a tag definida foi configurada).

  4. Para adicionar uma tag de formato livre ao repositório, especifique:

    • Namespace: Definido como Nenhum (as tags de formato livre não pertencem a um namespace de tag).

    • Chave: Informe um nome para a tag de formato livre a ser aplicada ao repositório.

    • Valor: Informe um valor para a tag a ser aplicada ao repositório.

Para adicionar uma tag de formato livre ou uma tag definida a um repositório existente:

  1. Siga as instruções em Editando um Repositório: Usando a Console para atualizar um repositório existente.

  2. Selecione a guia Tags e selecione Adicionar.

  3. Para adicionar uma tag definida ao repositório, especifique:

    • Namespace: Selecione o namespace de tag ao qual a tag pertence.

    • Chave: Selecione o nome da tag definida a ser aplicada ao repositório.

    • Valor: Selecione o valor da tag em uma lista de valores predefinida, informe um novo valor ou deixe em branco (dependendo de como a tag definida foi configurada).

  4. Para adicionar uma tag de formato livre ao repositório, especifique:

    • Namespace: Definido como Nenhum (as tags de formato livre não pertencem a um namespace de tag).

    • Chave: Informe um nome para a tag de formato livre a ser aplicada ao repositório.

    • Valor: Informe um valor para a tag a ser aplicada ao repositório.

Para atualizar uma tag de formato livre existente ou uma tag definida aplicada a um repositório:

  1. Siga as instruções em Editando um Repositório: Usando a Console para atualizar um repositório existente.

  2. Selecione a guia Tags.

  3. Selecione Editar no menu Ações (três pontos) ao lado da tag de formato livre ou da tag definida que você deseja alterar.

  4. Atualize a tag no painel Editar tags.

Para remover uma tag de formato livre existente ou uma tag definida aplicada a um repositório:

  1. Siga as instruções em Editando um Repositório: Usando a Console para atualizar um repositório existente.

  2. Selecione a guia Tags.

  3. Selecione Excluir no menu Ações (três pontos) ao lado da tag de formato livre ou da tag definida que você deseja excluir.

  4. Quando solicitado, confirme a exclusão.

Usando a Console para Especificar as Tags de Formato Livre e as Tags Definidas a Serem Aplicadas a Imagens

Para adicionar uma tag de formato livre ou uma tag definida a uma imagem:

  1. Siga as instruções em Obtendo Detalhes de uma Imagem: Usando a Console para ver detalhes da imagem.

  2. Selecione a guia Tags e selecione Adicionar.

  3. Para adicionar uma tag definida à imagem, especifique:

    • Namespace: Selecione o namespace de tag ao qual a tag pertence.

    • Chave: Selecione o nome da tag definida a ser aplicada à imagem.

    • Valor: Selecione o valor da tag de uma lista de valores predefinida, informe um novo valor ou deixe em branco (dependendo de como a tag definida foi configurada).

  4. Para adicionar uma tag de formato livre à imagem, especifique:

    • Namespace: Definido como Nenhum (as tags de formato livre não pertencem a um namespace de tag).

    • Chave: Informe um nome para a tag de formato livre a ser aplicada à imagem.

    • Valor: Informe um valor para a tag a ser aplicada à imagem.

Para atualizar uma tag de formato livre existente ou uma tag definida aplicada a uma imagem:

  1. Siga as instruções em Obtendo Detalhes de uma Imagem: Usando a Console para ver detalhes da imagem.

  2. Selecione a guia Tags.

  3. Selecione Editar no menu Ações (três pontos) ao lado da tag de formato livre ou da tag definida que você deseja excluir.

  4. Atualize a tag no painel Editar tags.

Para remover uma tag de formato livre existente ou uma tag definida aplicada a uma imagem:

  1. Siga as instruções em Obtendo Detalhes de uma Imagem: Usando a Console para ver detalhes da imagem.
  2. Selecione a guia Tags.

  3. Selecione Excluir no menu Ações (três pontos) ao lado da tag de formato livre ou da tag definida que você deseja alterar.

  4. Quando solicitado, confirme a exclusão.

Usando a Console para Especificar as Tags de Formato Livre e as Tags Definidas a Serem Aplicadas às Assinaturas de Imagem

Para adicionar uma tag de formato livre ou uma tag definida a uma assinatura de imagem criada quando uma imagem foi assinada:

  1. Siga as instruções em Obtendo Detalhes de uma Imagem: Usando a Console para ver detalhes da imagem assinada para a qual a assinatura foi criada.

  2. Selecione a guia Assinaturas para exibir detalhes da(s) assinatura(ões) criada(s) quando a imagem foi assinada.

    A coluna Tag mostra o número de tags de formato livre ou de tags definidas já aplicadas à assinatura da imagem.

  3. Adicione uma marca à assinatura da seguinte forma:

    • Para adicionar uma tag a uma assinatura à qual nenhuma tag foi aplicada ainda, selecione Adicionar tags no menu Ações ao lado da assinatura.

    • Para adicionar uma tag a uma assinatura à qual uma ou mais tags já foram aplicadas, selecione Exibir tags no menu Ações ao lado da assinatura e, em seguida, selecione Adicionar tags na caixa de diálogo Exibir tags.

  4. Para adicionar uma marca definida à assinatura da imagem, especifique:

    • Namespace: Selecione o namespace de tag ao qual a tag pertence.

    • Chave: Selecione o nome da tag definida a ser aplicada à assinatura da imagem.

    • Valor: Selecione o valor da tag de uma lista de valores predefinida, informe um novo valor ou deixe em branco (dependendo de como a tag definida foi configurada).

  5. Para adicionar uma tag de formato livre à assinatura da imagem, especifique:

    • Namespace: Definido como Nenhum (as tags de formato livre não pertencem a um namespace de tag).

    • Chave: Informe um nome para a tag de formato livre a ser aplicada à assinatura da imagem.

    • Valor: Informe um valor para a tag a ser aplicada à assinatura da imagem.

Para atualizar uma tag de formato livre existente ou uma tag definida aplicada a uma assinatura de imagem:

  1. Siga as instruções em Obtendo Detalhes de uma Imagem: Usando a Console para ver detalhes da imagem assinada para a qual a assinatura foi criada.

  2. Selecione a guia Assinaturas para exibir detalhes da(s) assinatura(ões) criada(s) quando a imagem foi assinada.

    A coluna Tag mostra o número de tags de formato livre ou de tags definidas já aplicadas à assinatura da imagem.

  3. Selecione Exibir tags no menu Ações ao lado da assinatura.

  4. Selecione o botão de edição ao lado da tag de formato livre ou da tag definida que você deseja alterar.

  5. Atualize a tag na caixa de diálogo Editar tag.

Para remover uma tag de formato livre existente ou uma tag definida aplicada a uma assinatura de imagem:

  1. Siga as instruções em Obtendo Detalhes de uma Imagem: Usando a Console para ver detalhes da imagem assinada para a qual a assinatura foi criada.

  2. Selecione a guia Assinaturas para exibir detalhes das assinaturas criadas quando a imagem foi assinada.

    A coluna Tag mostra o número de tags de formato livre ou de tags definidas já aplicadas à assinatura da imagem.

  3. Selecione Exibir tags no menu Ações ao lado da assinatura.

  4. Selecione o botão de edição ao lado da tag de formato livre ou da tag definida que você deseja remover.

  5. Selecione Remover tag na caixa de diálogo Editar tag.

Observações sobre o uso de tags para controlar o acesso a Repositórios, Imagens e Assinaturas de Imagem

Depois de aplicar tags de formato livre e tags definidas aos recursos do Container Registry, você pode incluir a variável de política target.resource.tag em que condições nas políticas do IAM para controlar o acesso a esses recursos.

Como acontece com outros serviços do OCI:

Observe o seguinte ao gravar instruções de política para controlar o acesso aos recursos do Container Registry usando a variável de política target.resource.tag:

  • O uso de repos nas instruções de política abrange todos os recursos do Container Registry, ou seja, repositórios, imagens e assinaturas de imagem. Por exemplo, considere a seguinte instrução de política:

    allow any-user to read repos in compartment HR where target.resource.tag.mynamespace.dept= 'Sales'

    Esta política permite acesso de leitura a repositórios, imagens e assinaturas de imagem aos quais a tag Sales foi aplicada.

  • Você deve aplicar uma tag diretamente ao recurso ao qual deseja permitir acesso. Quando você aplica uma tag a um repositório, a tag não é aplicada a imagens ou assinaturas de imagem no repositório. Da mesma forma, se você aplicar uma tag a uma imagem, a tag não será aplicada a uma assinatura de imagem criada para a imagem. Por exemplo, considere a seguinte instrução de política:
    allow any-user to manage repos in compartment HR where target.resource.tag.mynamespace.dept= 'Marketing'

    Esta política permite gerenciar o acesso a qualquer repositório, a qualquer imagem e a qualquer assinatura de imagem à qual a tag Marketing tenha sido aplicada. Observe que o acesso não é concedido a imagens ou assinaturas de imagem em um repositório ao qual a tag Marketing foi aplicada, a menos que a tag Marketing também tenha sido aplicada diretamente a elas.

  • Ao autorizar uma operação de API a acessar um recurso do Container Registry usando uma tag especificada pela variável de política target.resource.tag, você deve aplicar a tag a um recurso apropriado para a operação de API. Consulte Detalhes do Container Registry.