Questa è la AWS CDK v2 Developer Guide. Il vecchio CDK v1 è entrato in manutenzione il 1° giugno 2022 e ha terminato il supporto il 1° giugno 2023.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Configura i costrutti con CDK Blueprints

Utilizzate AWS CDK Blueprints per standardizzare e distribuire le configurazioni di costruzione L2 in tutta l'organizzazione. Con Blueprints, potete garantire che le AWS risorse siano configurate in modo coerente in base agli standard e alle migliori pratiche organizzative. Ad esempio, puoi abilitare automaticamente la crittografia per tutti i bucket Amazon S3, applicare configurazioni di registrazione specifiche a tutte le funzioni AWS Lambda o applicare regole di sicurezza standard per tutti i gruppi di sicurezza.

I blueprint si basano sull'iniezione di proprietà, un meccanismo introdotto in AWS CDK v2.196.0 che consente di modificare le proprietà di costruzione al momento dell'istanziazione. Un Blueprint è una raccolta di iniettori di proprietà, in cui ogni iniettore di proprietà specifica la configurazione ottimale per uno specifico costrutto L2. Il Blueprint rappresenta le migliori pratiche generali per l'organizzazione.

I blueprint non sono un meccanismo di applicazione della conformità. Gli sviluppatori possono comunque sovrascrivere le impostazioni predefinite, se necessario. Per una rigorosa applicazione della conformità, prendi in considerazione l'utilizzo di AWS CloudFormation Guard, Service Control Policies o CDK Aspects oltre a Blueprints.

Per informazioni dettagliate sull'implementazione, vedere Property Injection RFC.

Componenti chiave di Blueprints

I blueprint sono raccolte di iniettori di proprietà che applicano proprietà predefinite ai costrutti quando vengono istanziati. Un iniettore di proprietà è un componente che implementa l'IPropertyInjectorinterfaccia, che intercetta la creazione di costrutti e modifica o aggiunge proprietà prima della creazione del costrutto.

Casi d'uso comuni per Blueprints

Puoi usare CDK Blueprints per standardizzare molti aspetti delle tue risorse AWS. Ecco alcuni casi d'uso comuni:

Guida introduttiva a Blueprints

Ecco un semplice esempio di come creare e utilizzare un property injector:

Innanzitutto, crea un property injector per i bucket 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,
    };
  }
}

Quindi, usa l'iniettore nella tua applicazione 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');

In alternativa, puoi usare il PropertyInjectors.of() metodo:

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');

Best practice

Per informazioni più dettagliate sull'iniezione di proprietà, inclusi dettagli di implementazione, suggerimenti per la risoluzione dei problemi e informazioni di riferimento, consulta la RFC di Property Injection.