Esta es la guía para AWS CDK desarrolladores de la versión 2. La primera versión del CDK pasó a la etapa de mantenimiento el 1.° de junio de 2022 y no cuenta con soporte desde el 1.° de junio de 2023.
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.
Las etiquetas son elementos clave-valor informativos que puedes añadir a las estructuras de tu aplicación. AWS CDK Una etiqueta aplicada a un constructo determinado también se aplica a todos sus elementos secundarios que se pueden etiquetar. Las etiquetas se incluyen en la AWS CloudFormation plantilla sintetizada a partir de la aplicación y se aplican a los AWS recursos que implementa. Puede utilizar etiquetas para identificar y clasificar los recursos con los siguientes fines:
-
Administración simplificada
-
Asignación de costos
-
Control de acceso
-
Cualquier otra finalidad que se le ocurra
sugerencia
Para obtener más información sobre cómo usar las etiquetas con sus AWS recursos, consulte las prácticas recomendadas para etiquetar AWS los recursos en el AWS documento técnico.
Uso de etiquetas
La clase de Tags incluye el método estático of(), mediante el cual puede agregar o eliminar etiquetas del constructo especificado.
-
El código
Tags.of(aplica una nueva etiqueta a un constructo determinado y a todos sus elementos secundarios.SCOPE).add() -
El código
Tags.of(elimina una etiqueta de un constructo determinado y de cualquiera de sus elementos secundarios, incluidas las etiquetas que un constructo secundario pueda haberse aplicado a sí mismo.SCOPE).remove()
nota
El etiquetado se implementa mediante Aspectos y AWS CDK. Los aspectos son una forma de aplicar una operación (como el etiquetado) a todos los constructos de un ámbito determinado.
El siguiente ejemplo aplica la etiqueta clave con el valor valor a un constructo.
Tags.of(myConstruct).add('key', 'value');En el siguiente ejemplo, se elimina la etiqueta clave de un constructo.
Tags.of(myConstruct).remove('key');Si utiliza constructos Stage fijos, aplique la etiqueta en el nivel Stage o debajo. Las etiquetas no se aplican a través de los límites Stage.
Prioridades de etiqueta
AWS CDK Aplica y elimina las etiquetas de forma recursiva. Si hay conflictos, prevalece la operación de etiquetado con la prioridad más alta. (Las prioridades se establecen mediante la propiedad opcional priority). Si las prioridades de dos operaciones son las mismas, prevalece la operación de etiquetado que se encuentre más cerca de la parte inferior del árbol del constructo. De forma predeterminada, aplicar una etiqueta tiene una prioridad de 100 (excepto en el caso de las etiquetas que se añaden directamente a un AWS CloudFormation recurso, que tienen una prioridad de 50). La prioridad predeterminada para eliminar una etiqueta es de 200.
A continuación, se aplica una etiqueta con una prioridad de 300 a un constructo.
Tags.of(myConstruct).add('key', 'value', {
priority: 300
});Propiedades opcionales
Las etiquetas admiten las properties que permiten afinar cómo se aplican las etiquetas a los recursos o se eliminan de ellos. Todas las propiedades son opcionales.
applyToLaunchedInstances(Python:apply_to_launched_instances)-
Disponible solo para add(). De forma predeterminada, las etiquetas se aplican a las instancias lanzadas en un grupo de escalado automático. Establezca esta propiedad como falsa para ignorar las instancias lanzadas en un grupo de escalado automático.
includeResourceTypes/excludeResourceTypes(Python:include_resource_types/exclude_resource_types)-
Úselas para manipular las etiquetas solo en un subconjunto de recursos, en función de los tipos AWS CloudFormation de recursos. De forma predeterminada, la operación se aplica a todos los recursos del subárbol de constructos, pero esto se puede cambiar si se incluyen o excluyen determinados tipos de recursos. La exclusión tiene prioridad sobre la inclusión, si se especifican ambas opciones.
priority-
Utilice esta opción para establecer la prioridad de esta operación con respecto a otras
Tags.add()y operacionesTags.remove(). Los valores más altos tienen prioridad sobre los valores más bajos. El valor predeterminado es 100 para las operaciones de adición (50 para las etiquetas aplicadas directamente a AWS CloudFormation los recursos) y 200 para las operaciones de eliminación.
En el siguiente ejemplo, se aplica la etiqueta tagname con el valor y la prioridad 100 a los recursos del tipo de AWS::Xxx::Yyyla construcción. No aplica la etiqueta a las instancias lanzadas en un grupo de Amazon EC2 Auto Scaling ni a los recursos de este tipo AWS::Xxx::Zzz. (Son marcadores de posición para dos tipos de AWS CloudFormation recursos arbitrarios pero diferentes).
Tags.of(myConstruct).add('tagname', 'value', {
applyToLaunchedInstances: false,
includeResourceTypes: ['AWS::Xxx::Yyy'],
excludeResourceTypes: ['AWS::Xxx::Zzz'],
priority: 100,
});En el siguiente ejemplo, se elimina la etiqueta tagname con prioridad 200 de los recursos de tipo de AWS::Xxx::Yyyla construcción, pero no de los recursos de tipo. AWS::Xxx::Zzz
Tags.of(myConstruct).remove('tagname', {
includeResourceTypes: ['AWS::Xxx::Yyy'],
excludeResourceTypes: ['AWS::Xxx::Zzz'],
priority: 200,
});Ejemplo
En el siguiente ejemplo, se agrega la clave de etiqueta StackTypecon valor TheBesta cualquier recurso creado dentro del Stack nombreMarketingSystem. A continuación, lo vuelve a eliminar de todos los recursos, excepto de las subredes de Amazon EC2 VPC. El resultado es que la etiqueta solo se aplica a las subredes.
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']
});Con el siguiente código se obtiene el mismo resultado. Considere qué enfoque (inclusión o exclusión) deja más en claro su intención.
Tags.of(theBestStack).add('StackType', 'TheBest',
{ includeResourceTypes: ['AWS::EC2::Subnet']});Etiquetado de constructos individuales
Tags.of(scope).add(key, value) es la forma estándar de agregar etiquetas a los componentes fijos del AWS CDK. Su comportamiento de tree-walking, que etiqueta de forma recursiva todos los recursos etiquetables dentro de un ámbito determinado, que casi siempre es lo que se busca. Sin embargo, a veces es necesario etiquetar un constructo (o constructos) arbitrarios específicos.
Uno de estos casos implica la aplicación de etiquetas cuyo valor se deriva de alguna propiedad del constructo que se etiqueta. El enfoque de etiquetado estándar aplica de forma recursiva la misma clave y valor a todos los recursos coincidentes del ámbito. Sin embargo, en este caso el valor podría ser diferente para cada constructo etiquetado.
Las etiquetas se implementan mediante aspectos, y el CDK llama al método visit() de la etiqueta para cada constructo dentro del ámbito especificado mediante Tags.of(scope). Podemos llamar a Tag.visit() directamente para aplicar una etiqueta a un solo constructo.
new cdk.Tag(key, value).visit(scope);Puede etiquetar todos los constructos fijos incluidos en un ámbito, pero dejar que los valores de las etiquetas se deriven de las propiedades de cada constructo. Para ello, escriba un aspecto y aplique la etiqueta en el método del aspecto visit(), tal y como se muestra en el ejemplo anterior. A continuación, agregue el aspecto al ámbito deseado mediante Aspects.of(scope).add(aspect).
En el siguiente ejemplo se aplica una etiqueta a cada recurso de una pila que contiene la ruta del 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())sugerencia
La lógica del etiquetado condicional, que incluye las prioridades, los tipos de recursos, etc., está integrada en la clase de la Tag. Puede utilizar estas características cuando aplica etiquetas a recursos arbitrarios; la etiqueta no se aplica si no se cumplen las condiciones. Además, la clase de Tag solo etiqueta los recursos etiquetables, por lo que no es necesario comprobar si un constructo es etiquetable antes de aplicar una etiqueta.
