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()

스택 파일이 들어 있는 디렉터리 CLICDK는 여기에 다음을 생성합니다.

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

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프로젝트에서 프로젝트 종속성을 지정하고 관리하는 데 사용되는 공통 파일입니다.

Windows이를 위한 Batch 파일은 Python 가상 환경을 설정하는 데 사용됩니다.

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