AWS CDK 라이브러리 작업

TypeScript 는 네임스페이스에서 전체 네임스페이스 또는 개별 객체를 가져올 수 있도록 지원합니다. 각 네임스페이스에는 지정된 AWS 서비스와 함께 사용할 수 있는 구성 및 기타 클래스가 포함되어 있습니다.

// Import main CDK library as cdk
import * as cdk from 'aws-cdk-lib';   // ES6 import preferred in TS
const cdk = require('aws-cdk-lib');   // Node.js require() preferred in JS

// Import specific core CDK classes
import { Stack, App } from 'aws-cdk-lib';
const { Stack, App } = require('aws-cdk-lib');

// Import AWS S3 namespace as s3 into current namespace
import { aws_s3 as s3 } from 'aws-cdk-lib';   // TypeScript
const s3 = require('aws-cdk-lib/aws-s3');     // JavaScript

// Having imported cdk already as above, this is also valid
const s3 = cdk.aws_s3;

// Now use s3 to access the S3 types
const bucket = s3.Bucket(...);

// Selective import of s3.Bucket
import { Bucket } from 'aws-cdk-lib/aws-s3';        // TypeScript
const { Bucket } = require('aws-cdk-lib/aws-s3');   // JavaScript

// Now use Bucket to instantiate an S3 bucket
const bucket = Bucket(...);

와 마찬가지로 TypeScriptPython은 네임스페이스 모듈 가져오기 및 선택적 가져오기를 지원합니다. Python의 네임스페이스는 aws_cdk.xxx 와 같습니다. 여기서 xxx는 Amazon S3의 s3와 같은 AWS 서비스 이름을 나타냅니다. (이 예제에서는 Amazon S3를 사용합니다).

# Import main CDK library as cdk
import aws_cdk as cdk

# Selective import of specific core classes
from aws_cdk import Stack, App
            
# Import entire module as s3 into current namespace
import aws_cdk.aws_s3 as s3

# s3 can now be used to access classes it contains
bucket = s3.Bucket(...)

# Selective import of s3.Bucket into current namespace
from aws_cdk.s3 import Bucket

# Bucket can now be used to instantiate a bucket
bucket = Bucket(...)

Java의 가져오기는 TypeScript와 다르게 작동합니다. 각 가져오기 문은 지정된 패키지에서 단일 클래스 이름을 가져오거나 해당 패키지에 정의된 모든 클래스를 가져옵니다( 사용*). 클래스를 가져온 경우 클래스 이름 자체 또는 패키지를 포함한 적격 클래스 이름을 사용하여 클래스에 액세스할 수 있습니다.

라이브러리의 이름은 AWS Construct Librarysoftware.amazon.awscdk.services.xxx와 같습니다(기본 라이브러리는 임software.amazon.awscdk). AWS CDK 패키지의 Maven 그룹 ID는 입니다software.amazon.awscdk.

// Make certain core classes available
import software.amazon.awscdk.Stack;
import software.amazon.awscdk.App;

// Make all Amazon S3 construct library classes available
import software.amazon.awscdk.services.s3.*;

// Make only Bucket and EventType classes available
import software.amazon.awscdk.services.s3.Bucket;
import software.amazon.awscdk.services.s3.EventType;

// An imported class may now be accessed using the simple class name (assuming that name
// does not conflict with another class)
Bucket bucket = Bucket.Builder.create(...).build();

// We can always use the qualified name of a class (including its package) even without an
// import directive
software.amazon.awscdk.services.s3.Bucket bucket = 
    software.amazon.awscdk.services.s3.Bucket.Builder.create(...)
        .build();
          
// Java 10 or later can use var keyword to avoid typing the type twice
var bucket = 
    software.amazon.awscdk.services.s3.Bucket.Builder.create(...)
        .build();

C#에서는 using 지시문을 사용하여 유형을 가져옵니다. 두 가지 스타일이 있습니다. 하나는 일반 이름을 사용하여 지정된 네임스페이스의 모든 유형에 액세스할 수 있는 권한을 부여합니다. 다른 별칭을 사용하여 네임스페이스 자체를 참조할 수 있습니다.

패키지의 이름은 AWS Construct Library 패키지Amazon.CDK.AWS.xxx와 같습니다. (코어 모듈은 입니다Amazon.CDK.)

// Make CDK base classes available under cdk
using cdk = Amazon.CDK;

// Make all Amazon S3 construct library classes available
using Amazon.CDK.AWS.S3;

// Now we can access any S3 type using its name
var bucket = new Bucket(...);

// Import the S3 namespace under an alias
using s3 = Amazon.CDK.AWS.S3;

// Now we can access an S3 type through the namespace alias
var bucket = new s3.Bucket(...);

// We can always use the qualified name of a type (including its namespace) even without a
// using directive
var bucket = new Amazon.CDK.AWS.S3.Bucket(...)

각 AWS Construct Library 모듈은 Go 패키지로 제공됩니다.

import (
    "github.com/aws/aws-cdk-go/awscdk/v2"           // CDK core package
    "github.com/aws/aws-cdk-go/awscdk/v2/awss3"     // AWS S3 construct library module
)

// now instantiate a bucket
bucket := awss3.NewBucket(...)

// use aliases for brevity/clarity
import (
    cdk "github.com/aws/aws-cdk-go/awscdk/v2"           // CDK core package
    s3  "github.com/aws/aws-cdk-go/awscdk/v2/awss3"     // AWS S3 construct library module
)

bucket := s3.NewBucket(...)

// Instantiate default Bucket
const bucket = new s3.Bucket(this, 'amzn-s3-demo-bucket');

// Instantiate Bucket with bucketName and versioned properties
const bucket = new s3.Bucket(this, 'amzn-s3-demo-bucket', {
  bucketName: 'amzn-s3-demo-bucket',
   versioned: true,
});

// Instantiate Bucket with websiteRedirect, which has its own sub-properties
const bucket = new s3.Bucket(this, 'amzn-s3-demo-bucket', {
  websiteRedirect: {host: 'aws.amazon.com'}});

Python은 클래스를 인스턴스화할 때 new 키워드를 사용하지 않습니다. 속성 인수는 키워드 인수를 사용하여 표시되고 인수는 를 사용하여 이름이 지정됩니다snake_case.

프롭 값이 그 자체로 속성 번들인 경우 속성 뒤에 라는 클래스로 표시되며, 하위 속성에 대한 키워드 인수를 허용합니다.

Python에서 현재 인스턴스는 메서드에 첫 번째 인수로 전달되며, 이 인수는 규칙에 self 의해 이름이 지정됩니다.

# Instantiate default Bucket
bucket = s3.Bucket(self, "amzn-s3-demo-bucket")

# Instantiate Bucket with bucket_name and versioned properties
bucket = s3.Bucket(self, "amzn-s3-demo-bucket", bucket_name="amzn-s3-demo-bucket", versioned=true)

# Instantiate Bucket with website_redirect, which has its own sub-properties
bucket = s3.Bucket(self, "amzn-s3-demo-bucket", website_redirect=s3.WebsiteRedirect(
            host_name="aws.amazon.com"))

Java에서 props 인수는 라는 클래스로 표시됩니다XxxxProps(예: BucketProps Bucket 구성 요소의 props). 빌더 패턴을 사용하여 props 인수를 빌드합니다.

각 XxxxProps 클래스에는 빌더가 있습니다. 또한 다음 예제와 같이 한 단계로 소품과 구조를 빌드하는 각 구성 요소에 대한 편리한 빌더가 있습니다.

프롭의 이름은 를 TypeScript사용하여 에서와 동일합니다camelCase.

// Instantiate default Bucket
Bucket bucket = Bucket(self, "amzn-s3-demo-bucket");

// Instantiate Bucket with bucketName and versioned properties
Bucket bucket = Bucket.Builder.create(self, "amzn-s3-demo-bucket")
                      .bucketName("amzn-s3-demo-bucket").versioned(true)
                      .build();

# Instantiate Bucket with websiteRedirect, which has its own sub-properties
Bucket bucket = Bucket.Builder.create(self, "amzn-s3-demo-bucket")
                      .websiteRedirect(new websiteRedirect.Builder()
                          .hostName("aws.amazon.com").build())
                      .build();

C#에서 프롭은 객체 초기화기를 사용하여 라는 클래스로 지정됩니다XxxxProps(예: BucketProps Bucket 구성 요소의 프롭).

프롭의 이름은 를 사용하는 경우를 TypeScript제외하고 와 비슷하게 지정됩니다PascalCase.

구성 요소를 인스턴스화할 때 var 키워드를 사용하는 것이 편리하므로 클래스 이름을 두 번 입력할 필요가 없습니다. 그러나 현지 코드 스타일 가이드는 다를 수 있습니다.

// Instantiate default Bucket
var bucket = Bucket(self, "amzn-s3-demo-bucket");

// Instantiate Bucket with BucketName and Versioned properties
var bucket =  Bucket(self, "amzn-s3-demo-bucket", new BucketProps {
                      BucketName = "amzn-s3-demo-bucket",
                      Versioned  = true});

// Instantiate Bucket with WebsiteRedirect, which has its own sub-properties
var bucket = Bucket(self, "amzn-s3-demo-bucket", new BucketProps {
                      WebsiteRedirect = new WebsiteRedirect {
                              HostName = "aws.amazon.com"
                      }});

Go에서 구성 요소를 생성하려면 가 구성 요소의 이름NewXxxxxxXxxxxxx인 함수를 호출합니다. 구성 요소의 속성은 구조로 정의됩니다.

Go에서 모든 구성 파라미터는 숫자, 부울 및 문자열과 같은 값을 포함한 포인터입니다. 와 같은 편의 함수를 사용하여 이러한 포인터jsii.String를 생성합니다.

	// Instantiate default Bucket
	bucket := awss3.NewBucket(stack, jsii.String("amzn-s3-demo-bucket"), nil)

	// Instantiate Bucket with BucketName and Versioned properties
	bucket1 := awss3.NewBucket(stack, jsii.String("amzn-s3-demo-bucket"), &awss3.BucketProps{
		BucketName: jsii.String("amzn-s3-demo-bucket"),
		Versioned:  jsii.Bool(true),
	})

	// Instantiate Bucket with WebsiteRedirect, which has its own sub-properties
	bucket2 := awss3.NewBucket(stack, jsii.String("amzn-s3-demo-bucket"), &awss3.BucketProps{
		WebsiteRedirect: &awss3.RedirectTarget{
			HostName: jsii.String("aws.amazon.com"),
		}})

이름은 입니다camelCase.

bucket.bucketArn

이름은 입니다snake_case.

bucket.bucket_arn

각 속성에 대해 getter 메서드가 제공되며, 이러한 이름은 입니다camelCase.

bucket.getBucketArn()

이름은 입니다PascalCase.

bucket.BucketArn

이름은 입니다PascalCase.

bucket.BucketArn

import { IAspect, IConstruct } from 'aws-cdk-lib';

class MyAspect implements IAspect {
  public visit(node: IConstruct) {
    console.log('Visited', node.node.path);
  }
}

Python에는 인터페이스 기능이 없습니다. 그러나 의 경우 클래스를 로 장식하여 인터페이스 구현을 표시할 AWS CDK 수 있습니다@jsii.implements(interface).

from aws_cdk import IAspect, IConstruct
import jsii

@jsii.implements(IAspect)
class MyAspect():
  def visit(self, node: IConstruct) -> None:
    print("Visited", node.node.path)

import software.amazon.awscdk.IAspect;
import software.amazon.awscdk.IConstruct;

public class MyAspect implements IAspect {
    public void visit(IConstruct node) {
        System.out.format("Visited %s", node.getNode().getPath());
    }
}

using Amazon.CDK;

public class MyAspect : IAspect
{
    public void Visit(IConstruct node)
    {
        System.Console.WriteLine($"Visited ${node.Node.Path}");
    }
}

Go structs는 구현하는 인터페이스를 명시적으로 선언할 필요가 없습니다. Go 컴파일러는 구조에서 사용할 수 있는 메서드 및 속성을 기반으로 구현을 결정합니다. 예를 들어, 다음 코드에서는 가 구성을 수행하는 Visit 메서드를 제공하기 때문에 IAspect 인터페이스를 MyAspect 구현합니다.

type MyAspect struct {
}

func (a MyAspect) Visit(node constructs.IConstruct) {
	fmt.Println("Visited", *node.Node().Path())
}