Este é o Guia do desenvolvedor do 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á.

Configure construções com CDK Blueprints

Use o AWS CDK Blueprints para padronizar e distribuir configurações de construção L2 em toda a sua organização. Com o Blueprints, você pode garantir que AWS os recursos sejam configurados de forma consistente de acordo com seus padrões organizacionais e melhores práticas. Por exemplo, você pode habilitar automaticamente a criptografia para todos os buckets do Amazon S3, aplicar configurações de registro específicas a todas as funções do AWS Lambda ou aplicar regras de segurança padrão para todos os grupos de segurança.

Os blueprints são alimentados pela injeção de propriedades, um mecanismo introduzido no AWS CDK v2.196.0 que permite modificar as propriedades da construção no momento da instanciação. Um Blueprint é uma coleção de injetores de propriedades, em que cada injetor de propriedades especifica a configuração ideal para uma construção L2 específica. O Blueprint representa as melhores práticas gerais para sua organização.

Os esquemas não são um mecanismo de fiscalização da conformidade. Os desenvolvedores ainda podem substituir os padrões, se necessário. Para uma fiscalização rigorosa da conformidade, considere usar o AWS CloudFormation Guard, as Políticas de Controle de Serviços ou o CDK Aspects, além dos Blueprints.

Para obter informações detalhadas sobre a implementação, consulte o Property Injection RFC.

Componentes-chave dos Blueprints

Os blueprints são coleções de injetores de propriedades que aplicam propriedades padrão às construções quando elas são instanciadas. Um injetor de propriedades é um componente que implementa a IPropertyInjector interface, que intercepta a criação da construção e modifica ou adiciona propriedades antes que a construção seja criada.

Casos de uso comuns para Blueprints

Você pode usar o CDK Blueprints para padronizar muitos aspectos dos seus recursos da AWS. Aqui estão alguns casos de uso comuns:

Começando com Blueprints

Aqui está um exemplo simples de como criar e usar um injetor de propriedades:

Primeiro, crie um injetor de propriedades para os buckets do 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,
    };
  }
}

Em seguida, use o injetor em seu aplicativo 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');

Como alternativa, você pode usar o PropertyInjectors.of() método:

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áticas recomendadas

Para obter informações mais detalhadas sobre injeção de propriedades, incluindo detalhes de implementação, dicas de solução de problemas e informações de referência, consulte o RFC de injeção de propriedades.