Este é o Guia do Desenvolvedor AWS CDK v2. O CDK v1 antigo entrou em manutenção em 1º de junho de 2022 e encerrou o suporte em 1º de junho de 2023.
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á.
As tags são elementos informativos de valor-chave que você pode adicionar às construções em seu aplicativo. AWS CDK Uma tag aplicada a um determinado constructo também se aplica a todos os seus filhos que podem receber tags. As tags são incluídas no AWS CloudFormation modelo sintetizado a partir do seu aplicativo e aplicadas aos AWS recursos que ele implanta. É possível usar tags para identificar e categorizar os recursos para as seguintes finalidades:
-
Simplificando o gerenciamento
-
Alocação de custos
-
Controle de acesso
-
Quaisquer outros propósitos que você conceba
dica
Para obter mais informações sobre como você pode usar tags com seus AWS recursos, consulte Melhores práticas para marcar AWS recursos no AWS whitepaper.
Usar tags
A classe Tags inclui o método estático of(), por meio do qual você pode adicionar ou remover tags do constructo especificado.
-
Tags.of(aplica uma nova tag ao constructo fornecido e a todos os seus filhos.SCOPE).add() -
Tags.of(remove uma tag de um determinado constructo e de qualquer um de seus filhos, incluindo tags que um constructo secundário possa ter aplicado a si mesmo.SCOPE).remove()
nota
As tags são implementadas usando Aspectos e o AWS CDK. Aspectos são uma forma de aplicar uma operação (como as tags) a todos os constructos em um determinado escopo.
O exemplo a seguir aplica a tag key com o valor value a um constructo.
Tags.of(myConstruct).add('key', 'value');O exemplo a seguir exclui a tag key de um constructo.
Tags.of(myConstruct).remove('key');Se você estiver usando constructos Stage, aplique a tag no nível Stage ou abaixo. As tags não são aplicadas além dos limites Stage.
Prioridades de tags
O AWS CDK aplica e remove as tags recursivamente. Se houver conflitos, a operação de tag com a prioridade mais alta vence. (As prioridades são definidas usando a propriedade opcional priority.) Se as prioridades de duas operações forem as mesmas, a operação com tag mais próxima da parte inferior da árvore de constructo vence. Por padrão, a aplicação de uma tag tem uma prioridade de 100 (exceto as tags adicionadas diretamente a um AWS CloudFormation recurso, que tem uma prioridade de 50). A prioridade padrão para remover uma tag é 200.
O seguinte aplica uma tag com prioridade de 300 a uma constructo.
Tags.of(myConstruct).add('key', 'value', {
priority: 300
});Propriedades opcionais
As tags oferecem suporte ao properties que ajusta a forma como as tags são aplicadas ou removidas dos recursos. Todas as propriedades são opcionais.
applyToLaunchedInstances(Python:apply_to_launched_instances)-
Disponível somente para add(). Por padrão, as tags são aplicadas às instâncias executadas em um grupo do Auto Scaling. Defina essa propriedade como false para ignorar instâncias iniciadas em um grupo do Auto Scaling.
includeResourceTypes/excludeResourceTypes(Python:include_resource_types/exclude_resource_types)-
Use-os para manipular tags somente em um subconjunto de recursos, com base nos tipos de AWS CloudFormation recursos. Por padrão, a operação é aplicada a todos os recursos na subárvore de constructo, mas isso pode ser alterado incluindo ou excluindo determinados tipos de recursos. Excluir tem precedência sobre incluir, se ambas forem especificadas.
priority-
Use isso para definir a prioridade dessa operação em relação a outras operações
Tags.add()eTags.remove(). Valores mais altos têm precedência sobre valores mais baixos. O padrão é 100 para operações de adição (50 para tags aplicadas diretamente aos AWS CloudFormation recursos) e 200 para operações de remoção.
O exemplo a seguir aplica a tag tagname com o valor do valor e a prioridade 100 aos recursos do tipo AWS::Xxx::Yyyna construção. Ela não aplica a tag a instâncias lançadas em um grupo do Amazon EC2 Auto Scaling ou a recursos desse tipo. AWS::Xxx::Zzz (Esses são espaços reservados para dois tipos de AWS CloudFormation recursos arbitrários, mas diferentes.)
Tags.of(myConstruct).add('tagname', 'value', {
applyToLaunchedInstances: false,
includeResourceTypes: ['AWS::Xxx::Yyy'],
excludeResourceTypes: ['AWS::Xxx::Zzz'],
priority: 100,
});O exemplo a seguir remove a tag tagname com prioridade 200 dos recursos do tipo AWS::Xxx::Yyyna construção, mas não dos recursos do tipo AWS::Xxx::Zzz.
Tags.of(myConstruct).remove('tagname', {
includeResourceTypes: ['AWS::Xxx::Yyy'],
excludeResourceTypes: ['AWS::Xxx::Zzz'],
priority: 200,
});Exemplo
O exemplo a seguir adiciona a chave de tag StackTypecom valor TheBesta qualquer recurso criado dentro do Stack nomeMarketingSystem. Em seguida, ele o remove novamente de todos os recursos, exceto das sub-redes da Amazon EC2 VPC. O resultado é que somente as sub-redes têm a tag aplicada.
import { App, Stack, Tags } from 'aws-cdk-lib';
const app = new App();
const theBestStack = new Stack(app, 'MarketingSystem');
// Add a tag to all constructs in the stack
Tags.of(theBestStack).add('StackType', 'TheBest');
// Remove the tag from all resources except subnet resources
Tags.of(theBestStack).remove('StackType', {
excludeResourceTypes: ['AWS::EC2::Subnet']
});O código a seguir obtém o mesmo resultado. Considere qual abordagem (inclusão ou exclusão) torna sua intenção mais clara.
Tags.of(theBestStack).add('StackType', 'TheBest',
{ includeResourceTypes: ['AWS::EC2::Subnet']});Aplicar tags de constructos individuais
Tags.of(scope).add(key, value) é a forma padrão de adicionar tags aos constructos no AWS CDK. Seu comportamento de caminhar em árvores, que aplica tags recursivamente todos os recursos que podem ter aplicação de tag sob um determinado escopo, é quase sempre o que você deseja. Às vezes, no entanto, você precisa aplicat tags a um constructo (ou constructos) específico e arbitrário.
Um desses casos envolve a aplicação de tags cujo valor é derivado de alguma propriedade do constructo que está tendo a aplicação de tag. A abordagem de aplicação de tags padrão aplica recursivamente a mesma chave e valor a todos os recursos correspondentes no escopo. No entanto, aqui o valor pode ser diferente para cada constructo com tags.
As tags são implementadas usando aspectos, e o CDK chama o método visit() da tag para cada constructo sob o escopo que você especificou usando o Tags.of(scope). Podemos chamar o Tag.visit() diretamente para aplicar uma tag a um único constructo.
new cdk.Tag(key, value).visit(scope);Você pode marcar todos os constructos em um escopo, mas deixar que os valores das tags sejam derivados das propriedades de cada constructo. Para fazer isso, escreva um aspecto e aplique a tag no método visit() do aspecto, conforme mostrado no exemplo anterior. Em seguida, adicione o aspecto ao escopo desejado usando Aspects.of(scope).add(aspect).
O exemplo a seguir aplica uma tag a cada recurso em uma pilha contendo o caminho do recurso.
class PathTagger implements cdk.IAspect {
visit(node: IConstruct) {
new cdk.Tag("aws-cdk-path", node.node.path).visit(node);
}
}
stack = new MyStack(app);
cdk.Aspects.of(stack).add(new PathTagger())dica
A lógica da marcação condicional, incluindo prioridades, tipos de recursos e assim por diante, é incorporada à classe Tag. Você pode usar esses recursos ao aplicar tags a recursos arbitrários; a tag não é aplicada se as condições não forem atendidas. Além disso, a classe Tag só marca recursos marcáveis, então você não precisa testar se um constructo pode ser marcado antes de aplicar uma tag.
