AWS CDK로 Amazon ECS Anywhere를 설정하여 온프레미스 컨테이너 애플리케이션을 관리 - AWS 권장 가이드
요약사전 조건 및 제한 사항아키텍처도구에픽관련 리소스

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

AWS CDK로 Amazon ECS Anywhere를 설정하여 온프레미스 컨테이너 애플리케이션을 관리

작성자: Dr. Rahul Sharad Gaikwad(AWS)

코드 amazon-ecs-anywhere-cdk리포지토리: -샘플

환경: PoC 또는 파일럿

기술: 현대화, 컨테이너 및 마이크로서비스, 하이브리드 클라우드 DevOps, 인프라

워크로드: 기타 모든 워크로드

AWS 서비스: AWS CDK, Amazon ECS, AWS Identity and Access Management

요약

Amazon ECS Anywhere는 Amazon Elastic Container Service(Amazon ECS)의 확장입니다. ECS Anywhere를 사용하여 온프레미스 또는 고객 관리형 환경에 네이티브 Amazon ECS 작업을 배포할 수 있습니다. 이 기능은 비용을 절감하고 복잡한 로컬 컨테이너 오케스트레이션 및 운영을 완화하는 데 도움이 됩니다. ECS Anywhere를 사용하여 온프레미스와 클라우드 환경 모두에서 컨테이너 애플리케이션을 배포하고 실행할 수 있습니다. 따라서 팀이 여러 도메인과 기술을 배우거나 복잡한 소프트웨어를 자체적으로 관리할 필요가 없습니다.

이 패턴은 AWS Cloud Development Kit(AWS CDK) 스택을 사용하여 ECS Anywhere를 설정하는 단계를 보여줍니다.

사전 조건 및 제한 사항

사전 조건 

제한 사항 

제품 버전

  • AWS CDK 툴킷 버전 2

  • npm 버전 7.20.3 이상

  • Node.js 버전 16.6.1 이상

아키텍처

대상 기술 스택

  • AWS CloudFormation

  • AWS CDK

  • Amazon ECS Anywhere

  • Identity and Access Management(IAM)

대상 아키텍처 

다음 다이어그램은 이 패턴으로 구현된 AWS CDK를 사용하여 ECS Anywhere를 설정하는 상위 수준 시스템 아키텍처를 보여줍니다. TypeScript

  1. AWS CDK 스택을 배포하면 AWS에 CloudFormation 스택이 생성됩니다.

  2. CloudFormation 스택은 Amazon ECS 클러스터 및 관련 AWS 리소스를 프로비저닝합니다.

  3. Amazon ECS 클러스터에 외부 인스턴스를 등록하려면 가상 머신(VM)에 AWS Systems Manager Agent(SSM Agent)를 설치하고 해당 VM을 AWS Systems Manager 관리형 인스턴스로 등록해야 합니다. 

  4. 또한 VM을 Amazon ECS 클러스터에 외부 인스턴스로 등록하려면 VM에 Amazon ECS 컨테이너 에이전트와 Docker를 설치해야 합니다.

  5. Amazon ECS 클러스터에 외부 인스턴스를 등록하고 구성하면, 외부 인스턴스로 등록된 VM에서 여러 컨테이너를 실행할 수 있습니다.

AWS CDK를 사용하여 ECS Anywhere를 설정합니다. TypeScript

자동화 및 규모 조정

이 패턴으로 제공되는 GitHub 리포지토리는 AWS CDK를 코드형 인프라 (IaC) 도구로 사용하여 이 아키텍처에 대한 구성을 생성합니다. AWS CDK를 사용하면 리소스를 오케스트레이션하고 ECS Anywhere를 설정할 수 있습니다.

도구

코드

이 패턴의 소스 코드는 Amazon ECS Anywhere CDK 샘플 리포지토리에서 사용할 수 있습니다. GitHub 리포지토리를 복제하여 사용하려면 다음 섹션의 지침을 따르세요.

에픽

작업설명필요한 기술

AWS CDK 버전을 확인합니다.

다음 명령을 실행하여 AWS CDK Toolkit 버전을 확인하세요.

cdk --version

이 패턴에는 AWS CDK 버전 2가 필요합니다. 이전 버전의 AWS CDK를 사용 중이면 AWS CDK 문서에 있는 지침에 따라 업데이트하세요.

DevOps 엔지니어

AWS 보안 인증 정보를 설정합니다.

보안 인증 정보를 설정하려면 aws configure 명령을 실행하고 프롬프트를 따릅니다.

$aws configure
AWS Access Key ID [None]: <your-access-key-ID>
AWS Secret Access Key [None]: <your-secret-access-key>
Default region name [None]: <your-Region-name>
Default output format [None]:
DevOps 엔지니어
작업설명필요한 기술

AWS CDK 코드 리포지토리를 복제합니다.

다음 명령을 사용하여 이 패턴의 GitHub 코드 저장소를 복제합니다.

git clone https://github.com/aws-samples/amazon-ecs-anywhere-cdk-samples.git
DevOps 엔지니어

환경을 부트스트랩합니다.

사용하려는 계정 및 AWS 지역에 AWS CloudFormation 템플릿을 배포하려면 다음 명령을 실행합니다.

cdk bootstrap <account-number>/<Region>

자세한 내용은 AWS CDK 설명서의 부트스트래핑을 참조하세요.

DevOps 엔지니어
작업설명필요한 기술

패키지 종속 항목을 설치하고 파일을 컴파일합니다 TypeScript .

다음 명령을 실행하여 패키지 종속성을 설치하고 TypeScript 파일을 컴파일합니다.

$cd amazon-ecs-anywhere-cdk-samples
$npm install
$npm fund

이 명령은 샘플 저장소의 모든 패키지를 설치합니다. 

중요: 누락된 패키지와 관련된 오류가 발생하면 다음 명령 중 하나를 사용하세요.

$npm ci

—또는—

$npm install -g @aws-cdk/<package_name>

자세한 내용은 npm 설명서에 있는 npm ci와 npm install을 참조하세요.

DevOps 엔지니어

프로젝트를 빌드합니다.

다음 명령을 실행하여, 프로젝트를 구축합니다.

npm run build

프로젝트 구축 및 배포에 대한 자세한 내용은 AWS CDK 설명서의 첫 AWS CDK 앱을 참조하세요.

DevOps 엔지니어

프로젝트를 배포합니다.

프로젝트 코드를 배포하려면 다음 명령을 실행합니다.

cdk deploy
DevOps 엔지니어

스택 생성 및 출력을 확인합니다.

https://console.aws.amazon.com/cloudformation 에서 AWS CloudFormation 콘솔을 열고 EcsAnywhereStack 스택을 선택합니다. Outputs 탭에는 외부 VM에서 실행할 명령이 표시됩니다.

DevOps 엔지니어
작업설명필요한 기술

Vagrant를 사용하여 VM을 설정하세요.

데모를 위해 HashiCorp Vagrant를 사용하여 VM을 만들 수 있습니다. Vagrant는 휴대용 가상 소프트웨어 개발 환경을 구축하고 유지 관리하기 위한 오픈 소스 유틸리티입니다. Vagrantfile이 있는 루트 디렉터리에서 vagrant up 명령을 실행하여 Vagrant VM을 생성합니다. 자세한 내용은 Vagrant 설명서를 참조하세요.

DevOps 엔지니어

VM을 외부 인스턴스로 등록합니다.

1. vagrant ssh 명령을 사용하여 Vagrant VM에 로그인합니다. 자세한 내용은 Vagrant 설명서를 참조하세요.

2. AWS Systems Manager에 VM을 등록하고 외부 인스턴스를 활성화하는 데 사용할 수 있는 활성화 코드와 ID를 생성합니다. 이 명령의 출력에는 다음과 같이 ActivationId 및 ActivationCode 값이 포함됩니다. 

aws ssm create-activation --iam-role EcsAnywhereInstanceRole | tee ssm-activation.json

3. 활성화 ID 및 코드 값 내보내기:

export ACTIVATION_ID=<activation-ID>
export ACTIVATION_CODE=<activation-code>

4. 온프레미스 서버 또는 VM에서 설치 스크립트를 다운로드합니다.

curl -o "ecs-anywhere-install.sh" "https://amazon-ecs-agent.s3.amazonaws.com/ecs-anywhere-install-latest.sh" && sudo chmod +x ecs-anywhere-install.sh

5. 온프레미스 서버 또는 VM에서 설치 스크립트를 실행합니다.

sudo ./ecs-anywhere-install.sh \
    --cluster test-ecs-anywhere \
     --activation-id $ACTIVATION_ID \
     --activation-code $ACTIVATION_CODE \
    --region <Region>

VM 설정 및 등록에 대한 자세한 내용은 Amazon ECS 설명서의 클러스터에 외부 인스턴스 등록을 참조하세요.

DevOps 엔지니어

ECS Anywhere와 외부 VM의 상태를 확인합니다.

가상 박스가 Amazon ECS 컨트롤 플레인에 연결되어 실행 중인지 확인하려면 다음 명령을 사용하세요.

aws ssm describe-instance-information
aws ecs list-container-instances --cluster $CLUSTER_NAME
DevOps 엔지니어
작업설명필요한 기술

리소스를 정리하고 삭제합니다.

이 패턴을 수행한 다음에는 추가 요금이 발생하지 않도록 생성한 리소스를 제거해야 합니다. 정리하려면 다음 명령을 실행합니다.

cdk destroy
DevOps 엔지니어

관련 리소스