Esta es la guía para desarrolladores de AWS CDK v2. 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.

Configure los constructos con Esquemas de CDK

Utilice los Esquemas de AWS CDK para estandarizar y distribuir las configuraciones de los constructos de nivel 2 en toda su organización. Con los Esquemas, puede asegurarse de que los recursos de AWS se configuren de manera coherente de acuerdo con los estándares y las prácticas recomendadas de su organización. Por ejemplo, puede habilitar automáticamente el cifrado para todos los buckets de Amazon S3, aplicar configuraciones de registro específicas a todas las funciones de AWS Lambda o hacer cumplir las reglas de seguridad estándar para todos los grupos de seguridad.

Los esquemas se basan en la inyección de propiedades, un mecanismo introducido en la versión 2.196.0 del AWS CDK que permite modificar las propiedades del constructo en el momento de la instancia. Un esquema es un conjunto de inyectores de propiedades, en el que cada inyector de propiedades especifica la configuración óptima para un constructo de nivel 2 específico. El esquema representa las prácticas recomendadas generales para su organización.

Los esquemas no son un mecanismo de cumplimiento. Si es necesario, los desarrolladores aún pueden anular los valores predeterminados. Para una aplicación estricta del cumplimiento, considere la posibilidad de utilizar AWS CloudFormation Guard, política de control de servicio o aspectos de CDK además de los esquemas.

Para obtener información detallada sobre la implementación, consulte RFC sobre inyección de propiedades.

Componentes clave de los esquemas

Los esquemas son conjuntos de inyectores de propiedades que aplican las propiedades predeterminadas a los constructos cuando se crean instancias. Un inyector de propiedades es un componente que implementa la interfaz IPropertyInjector, que intercepta la creación del constructo y modifica o añade propiedades antes de que se cree el constructo.

Casos de uso comunes para los esquemas

Puede usar los esquemas de CDK para estandarizar muchos aspectos de sus recursos de AWS. A continuación, se indican algunos casos de uso comunes:

Introducción a los esquemas

A continuación, se muestra un ejemplo sencillo de cómo crear y usar un inyector de propiedades:

Primero, cree un inyector de propiedades para los buckets de Amazon S3:

import { IPropertyInjector, InjectionContext } from 'aws-cdk-lib';
import { Bucket, BucketProps, BlockPublicAccess } from 'aws-cdk-lib/aws-s3';

export class SecureBucketDefaults implements IPropertyInjector {
  public readonly constructUniqueId: string;

  constructor() {
    this.constructUniqueId = Bucket.PROPERTY_INJECTION_ID;
  }

  public inject(originalProps: BucketProps, _context: InjectionContext): BucketProps {
    return {
      // Set security defaults
      blockPublicAccess: BlockPublicAccess.BLOCK_ALL,
      enforceSSL: true,

      // Include original props to allow overrides
      ...originalProps,
    };
  }
}

Luego, utilice el inyector en su aplicación de CDK:

import { App, Stack } from 'aws-cdk-lib';
import { Bucket } from 'aws-cdk-lib/aws-s3';
import { SecureBucketDefaults } from './secure-bucket-defaults';

// Attach injectors when creating the App
const app = new App({
  propertyInjectors: [new SecureBucketDefaults()]
});

const stack = new Stack(app, 'MyStack');

// This bucket automatically gets the default properties
const myBucket = new Bucket(stack, 'MyBucket');

También puede utilizar el método PropertyInjectors.of():

import { App, Stack, PropertyInjectors } from 'aws-cdk-lib';
import { SecureBucketDefaults } from './secure-bucket-defaults';

const app = new App();
PropertyInjectors.of(app).add(new SecureBucketDefaults());

const stack = new Stack(app, 'MyStack');
const myBucket = new Bucket(stack, 'MyBucket');

Prácticas recomendadas

Para obtener información más detallada sobre la inyección de propiedades, incluidos los detalles de implementación, consejos para la solución de problemas e información de referencia, consulte RFC sobre inyección de propiedades.