Dies ist der AWS CDK v2-Entwicklerhandbuch. Das ältere CDK v1 wurde am 1. Juni 2022 in die Wartung aufgenommen und der Support wurde am 1. Juni 2023 eingestellt.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Konstrukte mit CDK Blueprints konfigurieren

Verwenden Sie AWS CDK Blueprints, um L2-Konstruktkonfigurationen in Ihrem Unternehmen zu standardisieren und zu verteilen. Mit Blueprints können Sie sicherstellen, dass AWS Ressourcen konsistent gemäß Ihren Unternehmensstandards und Best Practices konfiguriert werden. Sie können beispielsweise automatisch die Verschlüsselung für alle Amazon S3 S3-Buckets aktivieren, spezifische Protokollierungskonfigurationen auf alle AWS Lambda-Funktionen anwenden oder Standardsicherheitsregeln für alle Sicherheitsgruppen durchsetzen.

Blueprints basieren auf Property Injection, einem in AWS CDK v2.196.0 eingeführten Mechanismus, mit dem Sie Konstrukteigenschaften bei der Instanziierung ändern können. Ein Blueprint ist eine Sammlung von Eigenschafteninjektoren, wobei jeder Eigenschaftsinjektor die optimale Konfiguration für ein bestimmtes L2-Konstrukt spezifiziert. Der Blueprint stellt die allgemeinen Best Practices für Ihr Unternehmen dar.

Blueprints sind kein Mechanismus zur Durchsetzung von Vorschriften. Entwickler können die Standardeinstellungen bei Bedarf immer noch überschreiben. Für eine strikte Einhaltung der Vorschriften sollten Sie zusätzlich zu Blueprints auch AWS CloudFormation Guard, Service Control Policies oder CDK Aspects verwenden.

Detaillierte Informationen zur Implementierung finden Sie im Property Injection RFC.

Hauptkomponenten von Blueprints

Blueprints sind Sammlungen von Eigenschafteninjektoren, die Standardeigenschaften auf Konstrukte anwenden, wenn sie instanziiert werden. Ein Eigenschafteninjektor ist eine Komponente, die die IPropertyInjector Schnittstelle implementiert, die die Erstellung von Konstrukten abfängt und Eigenschaften ändert oder hinzufügt, bevor das Konstrukt erstellt wird.

Allgemeine Anwendungsfälle für Blueprints

Sie können CDK Blueprints verwenden, um viele Aspekte Ihrer AWS-Ressourcen zu standardisieren. Hier sind einige gängige Anwendungsfälle:

Erste Schritte mit Blueprints

Hier ist ein einfaches Beispiel für die Erstellung und Verwendung eines Eigenschafteninjektors:

Erstellen Sie zunächst einen Property Injector für Amazon S3 S3-Buckets:

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,
    };
  }
}

Verwenden Sie dann den Injektor in Ihrer CDK-Anwendung:

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

Alternativ können Sie die PropertyInjectors.of() Methode verwenden:

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

Bewährte Methoden

Ausführlichere Informationen zur Eigenschafteninjektion, einschließlich Implementierungsdetails, Tipps zur Fehlerbehebung und Referenzinformationen, finden Sie im Property Injection RFC.