AWS CDK 프로젝트

npm 레지스트리에 패키지를 게시할 때 무시할 파일과 폴더를 지정하는 파일입니다. 이 파일은 .gitignore와 비슷하지만 npm 패키지에만 해당합니다.

애플리케이션 파일이 CDK 앱을 정의합니다. CDK 프로젝트는 하나 이상의 애플리케이션 파일을 포함할 수 있습니다. 애플리케이션 파일은 bin 폴더에 저장됩니다.

다음은 CDK 앱을 정의하는 기본 애플리케이션 파일의 예입니다.

#!/usr/bin/env node
import 'source-map-support/register';
import * as cdk from 'aws-cdk-lib';
import { MyCdkTsProjectStack } from '../lib/my-cdk-ts-project-stack';

const app = new cdk.App();
new MyCdkTsProjectStack(app, 'MyCdkTsProjectStack');

Jest의 구성 파일입니다. Jest는 인기 있는 JavaScript 테스트 프레임워크입니다.

스택 파일이 CDK 스택을 정의합니다. 스택 내에서 구문을 사용하여 AWS 리소스와 속성을 정의합니다.

다음은 CDK 스택을 정의하는 기본 스택 파일의 예입니다.

import * as cdk from 'aws-cdk-lib';
import { Construct } from 'constructs';

export class MyCdkTsProjectStack extends cdk.Stack {
 constructor(scope: Construct, id: string, props?: cdk.StackProps) {
  super(scope, id, props);
    
  // code that defines your resources and properties go here
 }
}

Node.js 프로젝트의 종속성이 있는 프로젝트의 공통 폴더입니다.

종속성의 버전을 관리하기 위해 package.json 파일과 함께 작동하는 메타데이터 파일입니다.

Node.js 프로젝트에 일반적으로 사용되는 메타데이터 파일입니다. 이 파일에는 프로젝트 이름, 스크립트 정의, 종속성 및 기타 가져오기 프로젝트 수준 정보와 같은 CDK 프로젝트에 대한 정보가 포함되어 있습니다.

CDK 프로젝트에 대한 테스트를 구성하기 위해 테스트 폴더가 생성됩니다. 샘플 테스트 파일도 생성됩니다.

TypeScript로 테스트를 작성하고, 테스트를 실행하기 전에 Jest를 사용하여 TypeScript 코드를 컴파일할 수 있습니다.

컴파일러 옵션과 프로젝트 설정을 지정하는 TypeScript 프로젝트에 사용되는 구성 파일입니다.

npm 레지스트리에 패키지를 게시할 때 무시할 파일과 폴더를 지정하는 파일입니다. 이 파일은 .gitignore와 비슷하지만 npm 패키지에만 해당합니다.

애플리케이션 파일이 CDK 앱을 정의합니다. CDK 프로젝트는 하나 이상의 애플리케이션 파일을 포함할 수 있습니다. 애플리케이션 파일은 bin 폴더에 저장됩니다.

다음은 CDK 앱을 정의하는 기본 애플리케이션 파일의 예입니다.

#!/usr/bin/env node

const cdk = require('aws-cdk-lib');
const { MyCdkJsProjectStack } = require('../lib/my-cdk-js-project-stack');

const app = new cdk.App();
new MyCdkJsProjectStack(app, 'MyCdkJsProjectStack');

Jest의 구성 파일입니다. Jest는 인기 있는 JavaScript 테스트 프레임워크입니다.

스택 파일이 CDK 스택을 정의합니다. 스택 내에서 구문을 사용하여 AWS 리소스와 속성을 정의합니다.

다음은 CDK 스택을 정의하는 기본 스택 파일의 예입니다.

const { Stack, Duration } = require('aws-cdk-lib');

class MyCdkJsProjectStack extends Stack {
 constructor(scope, id, props) {
  super(scope, id, props);
    
  // code that defines your resources and properties go here
 }
}

module.exports = { MyCdkJsProjectStack }

Node.js 프로젝트의 종속성이 있는 프로젝트의 공통 폴더입니다.

종속성의 버전을 관리하기 위해 package.json 파일과 함께 작동하는 메타데이터 파일입니다.

Node.js 프로젝트에 일반적으로 사용되는 메타데이터 파일입니다. 이 파일에는 프로젝트 이름, 스크립트 정의, 종속성 및 기타 가져오기 프로젝트 수준 정보와 같은 CDK 프로젝트에 대한 정보가 포함되어 있습니다.

CDK 프로젝트에 대한 테스트를 구성하기 위해 테스트 폴더가 생성됩니다. 샘플 테스트 파일도 생성됩니다.

JavaScript로 테스트를 작성하고, 테스트를 실행하기 전에 Jest를 사용하여 JavaScript 코드를 컴파일할 수 있습니다.

CDK CLI는 프로젝트에 대한 가상 환경을 자동으로 생성합니다. .venv 디렉터리는 이 가상 환경을 나타냅니다.

애플리케이션 파일이 CDK 앱을 정의합니다. CDK 프로젝트는 하나 이상의 애플리케이션 파일을 포함할 수 있습니다.

다음은 CDK 앱을 정의하는 기본 애플리케이션 파일의 예입니다.

#!/usr/bin/env python3
import os

import aws_cdk as cdk

from my_cdk_py_project.my_cdk_py_project_stack import MyCdkPyProjectStack

app = cdk.App()
MyCdkPyProjectStack(app, "MyCdkPyProjectStack")

app.synth()

스택 파일이 있는 디렉터리입니다. CDK CLI는 여기에 다음을 생성합니다.

다음은 스택 파일의 예입니다.

from aws_cdk import Stack

from constructs import Construct

class MyCdkPyProjectStack(Stack):
 def __init__(self, scope: Construct, construct_id: str, **kwargs) -> None:
  super().__init__(scope, construct_id, **kwargs)
        
  # code that defines your resources and properties go here

requirements.txt와 비슷하지만 프로덕션보다는 개발 목적으로 종속성을 관리하는 데 사용되는 파일입니다.

Python 프로젝트에서 프로젝트 종속성을 지정하고 관리하는 데 사용되는 공용 파일입니다.

Python 가상 환경을 설정하는 데 사용되는 Windows용 배치 파일입니다.

CDK 프로젝트에 대한 테스트가 있는 디렉터리입니다.

다음은 유닛 테스트의 예입니다.

import aws_cdk as core
import aws_cdk.assertions as assertions

from my_cdk_py_project.my_cdk_py_project_stack import MyCdkPyProjectStack

def test_sqs_queue_created():
 app = core.App()
 stack = MyCdkPyProjectStack(app, "my-cdk-py-project")
 template = assertions.Template.from_stack(stack)

 template.has_resource_properties("AWS::SQS::Queue", {
  "VisibilityTimeout": 300
 })

CDK 프로젝트에 대한 구성 정보와 메타데이터가 들어 있는 파일입니다. 이 파일은 Maven의 일부입니다.

애플리케이션 및 스택 파일이 있는 디렉터리입니다.

다음은 예제 애플리케이션 파일입니다.

package com.myorg;

import software.amazon.awscdk.App;
import software.amazon.awscdk.Environment;
import software.amazon.awscdk.StackProps;

import java.util.Arrays;

public class MyCdkJavaProjectApp {
 public static void main(final String[] args) {
  App app = new App();

  new MyCdkJavaProjectStack(app, "MyCdkJavaProjectStack", StackProps.builder()
   .build());

  app.synth();
 }
}

다음은 예제 스택 파일입니다.

package com.myorg;

import software.constructs.Construct;
import software.amazon.awscdk.Stack;
import software.amazon.awscdk.StackProps;

public class MyCdkJavaProjectStack extends Stack {
 public MyCdkJavaProjectStack(final Construct scope, final String id) {
  this(scope, id, null);
 }

 public MyCdkJavaProjectStack(final Construct scope, final String id, final StackProps props) {
  super(scope, id, props);

  // code that defines your resources and properties go here
 }
}

테스트 파일이 있는 디렉터리입니다. 다음은 그 예제입니다.

package com.myorg;

import software.amazon.awscdk.App;
import software.amazon.awscdk.assertions.Template;
import java.io.IOException;

import java.util.HashMap;

import org.junit.jupiter.api.Test;

public class MyCdkJavaProjectTest {

 @Test
 public void testStack() throws IOException {
  App app = new App();
  MyCdkJavaProjectStack stack = new MyCdkJavaProjectStack(app, "test");

  Template template = Template.fromStack(stack);

  template.hasResourceProperties("AWS::SQS::Queue", new HashMap<String, Number>() {{
   put("VisibilityTimeout", 300);
  }});
 }
}

애플리케이션 및 스택 파일이 있는 디렉터리입니다.

다음은 예제 애플리케이션 파일입니다.

using Amazon.CDK;
using System;
using System.Collections.Generic;
using System.Linq;

namespace MyCdkCsharpProject
{
 sealed class Program
 {
  public static void Main(string[] args)
  {
   var app = new App();
   new MyCdkCsharpProjectStack(app, "MyCdkCsharpProjectStack", new StackProps{});
   app.Synth();
  }
 }
}

다음은 예제 스택 파일입니다.

using Amazon.CDK;
using Constructs;

namespace MyCdkCsharpProject
{
 public class MyCdkCsharpProjectStack : Stack
 {
  internal MyCdkCsharpProjectStack(Construct scope, string id, IStackProps props = null) : base(scope, id, props)
  {
   // code that defines your resources and properties go here
  }
 }
}

이 디렉터리에는 다음 항목도 있습니다.

관련 프로젝트를 구성하고 관리하는 데 사용되는 Microsoft Visual Studio Solution File입니다.

모듈 정보가 들어 있고 Go 프로젝트의 종속성과 버전 관리를 관리하는 데 사용되는 파일입니다.

CDK 애플리케이션과 스택을 정의하는 파일입니다.

다음은 그 예제입니다.

package main
import (
 "github.com/aws/aws-cdk-go/awscdk/v2"
 "github.com/aws/constructs-go/constructs/v10"
 "github.com/aws/jsii-runtime-go"
)

type MyCdkGoProjectStackProps struct {
 awscdk.StackProps
}

func NewMyCdkGoProjectStack(scope constructs.Construct, id string, props *MyCdkGoProjectStackProps) awscdk.Stack {
 var sprops awscdk.StackProps
 if props != nil {
  sprops = props.StackProps
 }
 stack := awscdk.NewStack(scope, &id, &sprops)
 // The code that defines your resources and properties go here

  return stack
}

func main() {
 defer jsii.Close()
 app := awscdk.NewApp(nil)
 NewMyCdkGoProjectStack(app, "MyCdkGoProjectStack", &MyCdkGoProjectStackProps{
  awscdk.StackProps{
   Env: env(),
  },
 })
 app.Synth(nil)
}

func env() *awscdk.Environment {

 return nil
}

샘플 테스트를 정의하는 파일입니다.

다음은 그 예제입니다.

package main

import (
 "testing"

 "github.com/aws/aws-cdk-go/awscdk/v2"
 "github.com/aws/aws-cdk-go/awscdk/v2/assertions"
 "github.com/aws/jsii-runtime-go"
)

func TestMyCdkGoProjectStack(t *testing.T) {
    
 // GIVEN
 app := awscdk.NewApp(nil)
    
 // WHEN
 stack := NewMyCdkGoProjectStack(app, "MyStack", nil)
    
 // THEN
 template := assertions.Template_FromStack(stack, nil)
 template.HasResourceProperties(jsii.String("AWS::SQS::Queue"), map[string]interface{}{
  "VisibilityTimeout": 300,
 })
}