CDK AWS v2 개발자 안내서입니다. 이전 CDK v1은 2022년 6월 1일에 유지 관리에 들어갔으며 2023년 6월 1일에 지원이 종료되었습니다.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

CDK 블루프린트를 사용하여 구문 구성

AWS CDK 블루프린트를 사용하여 조직 전체에 L2 구성 구성을 표준화하고 배포합니다. 블루프린트를 사용하면 AWS 리소스가 조직 표준 및 모범 사례에 따라 일관되게 구성되도록 할 수 있습니다. 예를 들어 모든 Amazon S3 버킷에 대해 암호화를 자동으로 활성화하거나, 모든 AWS Lambda 함수에 특정 로깅 구성을 적용하거나, 모든 보안 그룹에 표준 보안 규칙을 적용할 수 있습니다.

블루프린트는 인스턴스화 시 구문 속성을 수정할 수 있도록 AWS CDK v2.196.0에 도입된 메커니즘인 속성 주입으로 구동됩니다. 블루프린트는 속성 인젝터의 모음으로, 각 속성 인젝터는 특정 L2 구문에 대한 최적의 구성을 지정합니다. 블루프린트는 조직의 전반적인 모범 사례를 나타냅니다.

블루프린트는 규정 준수 적용 메커니즘이 아닙니다. 개발자는 필요한 경우 기본값을 재정의할 수 있습니다. 엄격한 규정 준수를 위해 블루프린트 외에도 AWS CloudFormation Guard, 서비스 제어 정책 또는 CDK 측면을 사용하는 것이 좋습니다.

자세한 구현 정보는 속성 주입 RFC를 참조하세요.

블루프린트의 주요 구성 요소

블루프린트는 인스턴스화될 때 구문에 기본 속성을 적용하는 속성 인젝터 모음입니다. 속성 인젝터는 IPropertyInjector 인터페이스를 구현하는 구성 요소로, 구문 생성을 가로채고 구문이 생성되기 전에 속성을 수정하거나 추가합니다.

블루프린트의 일반적인 사용 사례

CDK 블루프린트를 사용하여 AWS 리소스의 여러 측면을 표준화할 수 있습니다. 다음은 몇 가지 일반적인 사용 사례입니다.

블루프린트 시작하기

다음은 속성 인젝터를 생성하고 사용하는 방법에 대한 간단한 예입니다.

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

그런 다음 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');

또는 메서드를 사용할 수 있습니다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');

모범 사례

구현 세부 정보, 문제 해결 팁 및 참조 정보를 포함하여 속성 주입에 대한 자세한 내용은 속성 주입 RFC를 참조하세요.