`、`lib`)。この例では Amazon S3 を選択しますが、どのサービスを使用しても動作します。そのパッケージのメイン [index.ts ファイル](https://github.com/aws/aws-cdk/blob/main/packages/aws-cdk-lib/aws-s3/lib/index.ts)を確認すると、次の行があります。
```
export * from './s3.generated';
```
ただし、対応するディレクトリのどこにも、`s3.generated` ファイルはありません。なぜなら、L1 コンストラクトは、AWS CDK ビルドプロセス中に [CloudFormation リソース仕様](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-resource-specification.html)に基づいて自動生成されるからです。そのため、対象のパッケージに AWS CDK ビルドコマンドを実行した後にのみ、パッケージ内に `s3.generated` が存在することになります。
## AWS CloudFormation リソース仕様
AWS CloudFormation リソース仕様は、AWS の Infrastructure as Code (IAC) を定義するとともに、この仕様によって、CloudFormation テンプレート内のコードをどのように AWS アカウントのリソースに変換するかを決定するものです。この仕様には、リージョンごとのレベルで、[JSON 形式](https://www.json.org/json-en.html)の AWS リソースが定義されています。各リソースには、`provider::service::resource` の形式に従い、一意の[リソースタイプ名](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html)が付与されます。例えば、Amazon S3 バケットのリソースタイプには `AWS::S3::Bucket` という名前付き、Amazon S3 アクセスポイントのリソースタイプには `AWS::S3::AccessPoint` という名前が付きます。こうしたリソースタイプは、AWS CloudFormation リソース仕様で定義されている構文を使用して CloudFormation テンプレート内にレンダリングすることもできます。AWS CDK ビルドプロセスを実行すると、各リソースタイプも L1 コンストラクトに変換されます。
したがって、各 L1 コンストラクトは、対応する CloudFormation リソースがプログラムによってそのまま反映されたものです。CloudFormation テンプレートに適用するどのプロパティも、L1 コンストラクトのインスタンス化に使用でき、対応する L1 コンストラクトをインスタンス化する際にも、必要なすべての CloudFormation プロパティを引数に指定しなければなりません。次の表は、CloudFormation テンプレートに表された S3 バケットと、AWS CDK L1 コンストラクトとして定義した同じ S3 バケットを比較したものです。
|
|
| **CloudFormation テンプレート** | **L1 コンストラクト** |
| --- |--- |
| "amzns3demobucket": {
"Type": "AWS::S3::Bucket",
"Properties": {
"BucketName": "amzn-s3-demo-bucket",
"BucketEncryption": {
"ServerSideEncryptionConfiguration": [
{
"ServerSideEncryptionByDefault": {
"SSEAlgorithm": "AES256"
}
}
]
},
"MetricsConfigurations": [
{
"Id": "myConfig"
}
],
"OwnershipControls": {
"Rules": [
{
"ObjectOwnership": "BucketOwnerPreferred"
}
]
},
"PublicAccessBlockConfiguration": {
"BlockPublicAcls": true,
"BlockPublicPolicy": true,
"IgnorePublicAcls": true,
"RestrictPublicBuckets": true
},
"VersioningConfiguration": {
"Status": "Enabled"
}
}
} | new CfnBucket(this, "amzns3demobucket", {
bucketName: "amzn-s3-demo-bucket",
bucketEncryption: {
serverSideEncryptionConfiguration: [
{
serverSideEncryptionByDefault: {
sseAlgorithm: "AES256"
}
}
]
},
metricsConfigurations: [
{
id: "myConfig"
}
],
ownershipControls: {
rules: [
{
objectOwnership: "BucketOwnerPreferred"
}
]
},
publicAccessBlockConfiguration: {
blockPublicAcls: true,
blockPublicPolicy: true,
ignorePublicAcls: true,
restrictPublicBuckets: true
},
versioningConfiguration: {
status: "Enabled"
}
}); |
ご覧のとおり、L1 コンストラクトは、CloudFormation リソースのコードを正確に示すマニフェストであり、ショートカットや単純化が行われないため、記述が必要なボイラープレートテキストの量はほぼ同じです。ただし、AWS CDK を使用する大きな利点の 1 つは、こうした CloudFormation 構文ボイラープレートの多くを排除しやすくなることです。これを可能にするために、有用なのが、L2 コンストラクトです。