버전 비교

  • 이 줄이 추가되었습니다.
  • 이 줄이 삭제되었습니다.
  • 서식이 변경되었습니다.

...

펼치기
title목록 펼쳐서 보기...


패널
borderColor#6699ff
bgColor#ffffff
titleColorwhite
titleBGColor#6699ff
borderStylesolid
title목차


목차 영역

목차
maxLevel3
outlinetrue
stylenone
separatorpipe




펼치기
title버전 정보 업데이트

2022-02-17 ~ 02-22(예정)

  • 관리콘솔 업데이트 화면에 맞추어 업데이트 진행중
  • CDK v1에서 v2로 변경되면서 하단의 패키지 및 소스 코드에 대하여 수정을 진행합니다.

2020-06-01

  • Docker 이미지를 ECR에 등록시 에러 나는 부분 수정
  • 스크린샷 이미지 교체
  • URL cdk.awsdemokr.com 에서 cdk.awsdemo.kr 로 수정 배포

2019-11-14

  • 짧은 URL을 만들고, 통계 분석으로 미연에 장애를 인지할 수 있는 환경을 CDK 기반으로 구축 (Custom Domain 배포 되는 부분 삭제)

...

이 애플리케이션은 Seoul  리전에서 개발합니다. AWS 관리 콘솔 우측 하단에 Seoul 를 선택합니다. 화면에 표시되는 언어는 English 를 기본으로 진행합니다.

Image RemovedImage Added

Elastic IP 생성

VPC의 NAT Gateway가 사용할 EIP를 생성합니다. AWS 관리콘솔에서 VPC 서비스로 이동한 후, Elastic IPs 메뉴를 선택하고, 상단의 Allocate new Elastic IP address 버튼을 클릭합니다.

Image RemovedImage Added

다음 화면에서 IPfmf gkfekd qkedmf Group을 확인하고, Tags에 Key에는 Name 을 Value에는 ShortUrl 을 입력 후 Allocate 버튼을 클릭하면 고정 IP를 한 개 할당 받을 수 있습니다.

Image Removed

Image RemovedImage Added

VPC 생성하기

부하 테스트를 위해서, Docker 이미지를 ECR에 올리고, Fargate를 통해 서버리스 형태로 배포하기 위해서 VPC와 Private subnet 이 필요합니다.
VPC 서비스의 Dashboard 화면에서 Launch VPC Wizard 버튼을 클릭하여 Public subnet과 Private subnet을 포함하고, NAT Gateway를 포함하는 VPC를 생성합니다.

AWS 관리콘솔에서 관리 콘솔에서 VPC 서비스로 이동한 후, VPC Dashboard 화면에서,  Launch VPC Wizard 버튼을 클릭합니다.
Image RemovedImage Added

VPC 설정 Step 1에서 2번째에 있는 VPC with Public and Private Subnets 을 선택 후, Select 버튼을 클릭합니다.
Image RemovedImage Added

VPC 설정 Step 2에서 VPC name 에는 CDK-TEST 라는 ShortUrl 라는 이름을 입력하고, NAT Gateway 설정의 Elastic IP Allocation ID 는 위 단계에서 할당 받은 EIP를 클릭하고 하단의 Create VPC 버튼을 클릭합니다.
Image RemovedImage Added

VPC 생성 작업이 진행되고, 아래와 같이 새로운 VPC가 생성됩니다. 해당 VPC ID 를 사용하므로 메모장에 복사 해 놓습니다.
Image RemovedImage Added

AWS Cloud9 시작하기

...

AWS Cloud9의 Name cdkenv 로 주고, 우측 하단의 Next step 버튼을 클릭합니다.
Image RemovedImage Added

기본 설정 그대로 Next step 버튼을 클릭합니다.
Image RemovedImage Added

Review에서 설정된 상태(EC2의 t2.micro 타입)를 확인하고 하단의 Create environment 버튼을 클릭합니다.
Image RemovedImage Added

Cloud9 환경이 준비되는 것을 볼 수 있습니다. Cloud9이 가용해질 때까지 잠시 기다립니다. (약 1분 내외면 웹 상에서 개발을 할 수 있는 환경을 구축할 수 있습니다.)
Image Removed

AWS-CDK 설치

Cloud 9 최신 환경에는 AWS CDK가 설치되어 있습니다.

코드 블럭
languagebash
themeDJango
cdk --version

만약 설치가 안되어 있다면 아래와 같이 설치하세요.

...

Image Added


...

작업 진행중 (2022-02-17)

Cloud9 구동 화면

다음과 같이 구동이 되면, 하단의 Terminal 환경을 통해 아래와 같은 CLI 명령을 수행할 수 있습니다.

Image Added

AWS-CDK 설치

Cloud 9 최신 환경에는 AWS CDK가 설치되어 있습니다. 아래 버전은 지속적으로 업데이트 되므로 보이는 것이 다를 수 있습니다.

title
코드 블럭
languagebash
themeDJango
npm을 이용한 aws-
cdk
설치 명령npm
 
install
-
g aws
-
cdk
version
Image Removed

Image Added


프로젝트 시작

프로젝트 생성

프로젝트 디렉토리를 생성하고 이동합니다.

...

코드 블럭
languagebash
themeDJango
titleCDK 개발 언어 설정
cdk init --language python

Image RemovedImage Added


CDK 개발 환경 확인

URL Short Demo 환경이 설치되었습니다. Cloud9의 좌측 폴더 구조를 확인합니다.
Image RemovedImage Added

virtualenv 환경 진입

...

코드 블럭
languagebash
themeDJango
titlevirtualenv 진입
source .venv/bin/activate

Image RemovedImage Added

패키지 설정

setuprequirements.py txt 파일을 열어 데모에 필요한 패키지를 아래와 같이 추가하고 2줄(cdk-watchful, boto3)을 추가하고 저장 합니다. 저장은 단축키 (Ctrl+S)로도 가능합니다.

코드 블럭
languagepy
themeRDark
firstline21
titlesetup.py cdk 의존성 패키지 지정
linenumberstrue
        install_requires=[
            "aws-cdk.core-lib==12.9712.0",
            "aws-cdk.aws-dynamodb",
            "aws-cdk.aws-events",
            "aws-cdk.aws-events-targets",
            "aws-cdk.aws-lambda",
            "aws-cdk.aws-s3",
            "aws-cdk.aws-ec2",
            "aws-cdk.aws-ecs-patterns",
            "aws-cdk.aws-apigateway",
            "aws-cdk.aws-cloudwatch",
            "cdk-watchful",
            "boto3"
        ],
constructs>=10.0.0,<11.0.0
cdk-watchful
boto3


패키지 설치

virtualenv 안에서 의존성에 맞추어 패키지를 설치합니다.

코드 블럭
languagebash
themeDJango
title의존 패키지 설치
python -m pip install -er requirements.txt


CDK bootstrap

CDK Toolkit Stack을 만들기 위하여 bootstrap을 합니다.  123456789012 본인 AWS 계정 12자리 숫자로 대체하면 됩니다. AWS CDK로 클라우드 애플리케이션을 관리하는 데 필요한 리소스를 관리하는 S3 버킷도 생성합니다.

코드 블럭
languagebash
themeDJango
titleCDK Bootstrap
cdk bootstrap aws://123456789012/ap-northeast-2

Image RemovedImage Added

프로젝트 환경 설정

프로젝트 시작점인 app.py를 열어 봅니다. 직접 Cloud 9 UI의 네비게이션에 있는 파일을 직접 클릭 해서 열 수 있고,  npm install -g c9 과 같이 패키지를 설치한 후에 c9 open app.py 와 같은 형태로 terminal에서도 바로 열 수 있습니다.
Image RemovedImage Added

소스 코드 중에 UrlShortStack 클래스 정의로 커서를 이동하고, 함수 정의로 이동을 위해서 F3를 F3 키를 누릅니다.
Image RemovedImage Added

새로운 탭에 url_short_stack.py 파일이 열립니다. 이제 이 스택에 리소스를 하나씩 만들어 나가겠습니다.
Image RemovedImage Added

리소스 작성

DynamoDB 테이블 리소스 정의

...

url_short_stack.py 파일의 첫 줄을 아래와 같이 변경합니다. (, aws_dynamodb 문자 추가) 

코드 블럭
languagepy
themeRDark
titleurl_shortener_stack.py에 importpy에 import
from aws_cdk import (
    # Duration,
    Stack,
    aws_dynamodb as dynamodb,
)from aws_cdk import core, aws_dynamodb

"# The code that defines your stack goes here" 주석 하단 에 DynamoDB 테이블 추가를 위해 아래에 코드를 추가합니다.
URL Short에서 생성되는 URL을 담아 둘 DynamoDB 테이블의 이름은 'mapping-table'이라 만들고 id에는 Short URL을 위한 코드를 UUID 값으로 넣을 겁니다.

코드 블럭
languagebash
themeDJango
titleurl_shortener_stack.py에서 CDK를 이용한 DynamoDB Table 생성 코드
        table = aws_dynamodb.Table(self, "mapping",
            partition_key = aws_dynamodb.Attribute(name="id",type=aws_dynamodb.AttributeType.STRING))

코드 작성이 완료 되면 아래와 같이 코드가 만들어졌을 것이고 만들어졌고 저장합니다.
image2020-6-1_14-45-54.pngImage RemovedImage Added

CDK deploy로 DynamoDB 테이블 배포

...

코드 블럭
languagebash
themeDJango
titlecdk로 리소스 배포
cdk deploy

Image RemovedImage Added

Lambda 함수 코드 작성

Lambda 함수를 개발하기 위하여 폴더를 하나 생성합니다. UI에서 lambda라는 폴더를 만들고, 폴더 하단에 handler.py 파일을 생성합니다. (terminal에서 cmd로 만드셔도 됩니다.)

Image RemovedImage RemovedImage AddedImage Added

handler.py 파일은 Short URL을 생성하거나, Short URL이 들어올 경우 원래 URL로 Redirect 하는 기능을 제공하는 함수입니다.
다음과 같은 코드를 함수에 넣습니다. 코드를 한 번 읽어보면서 동작되는 원리를 살펴 봅니다.

...

코드 블럭
languagepy
themeRDark
titleurl_shortener_stack.py 파일에 CDK Lambda 정보 import
linenumberstrue
from aws_cdk import core, (
    # Duration,
    Stack,
    aws_dynamodb as dynamodb,
    aws_lambda as lambda_
)

Lambda 함수를 선언합니다. 이때 Python은 lambda 키워드를 이미 가지고 있기 때문에 _를 추가하여 사용합니다.

코드 블럭
languagepy
themeRDark
titleurl_shortener_stack.py 파일에 Lambda 함수에 선언
        function = awslambda_lambda.Function(self, "backend",
            runtime=awslambda_lambda.Runtime.PYTHON_3_79,
            handler="handler.main",
            code=awslambda_lambda.Code.from_asset("./lambda"))

Image RemovedImage Added

Lambda 함수 리소스 배포

...