Amazon ECS 컨테이너 에이전트 설치하기
Amazon ECS 컨테이너 에이전트 설치하기
Amazon EC2 인스턴스를 Amazon ECS 클러스터에 등록하려는데 그 인스턴스가 Amazon ECS-optimized AMI 기반의 AMI를 사용하지 않는다면, 다음 절차로 Amazon ECS 컨테이너 에이전트를 수동으로 설치할 수 있어요. 에이전트는 지역별(regional) Amazon S3 버킷 중 하나에서 다운로드하거나 Amazon Elastic Container Registry Public에서 다운로드할 수 있습니다.
출처: 문서
본문
Amazon EC2 인스턴스를 Amazon ECS 클러스터에 등록하려는데 그 인스턴스가 Amazon ECS-optimized AMI 기반의 AMI를 사용하지 않는다면, Amazon ECS 컨테이너 에이전트를 수동으로 설치할 수 있습니다. 이렇게 하려면 지역별(regional) Amazon S3 버킷 중 하나에서 에이전트를 다운로드하거나, Amazon Elastic Container Registry Public에서 다운로드할 수 있어요. 지역별 Amazon S3 버킷에서 다운로드한다면 PGP 서명으로 컨테이너 에이전트 파일의 유효성을 선택적으로 검증할 수 있습니다.
참고: Amazon ECS와 Docker 서비스에 대한 systemd 유닛에는 두 서비스가 시작되기 전에 cloud-init이 완료되기를 기다리라는 지시문이 있습니다. cloud-init 프로세스는 Amazon EC2 user data 실행이 끝나기 전까지 완료된 것으로 간주되지 않습니다. 따라서 Amazon EC2 user data로 Amazon ECS나 Docker를 시작하면 데드락이 발생할 수 있어요. Amazon EC2 user data로 컨테이너 에이전트를 시작하려면
systemctl enable --now --no-block ecs.service를 사용하세요.
비(非) Amazon Linux EC2 인스턴스에 Amazon ECS 컨테이너 에이전트 설치하기
Amazon EC2 인스턴스에 Amazon ECS 컨테이너 에이전트를 설치하려면, 지역별 Amazon S3 버킷 중 하나에서 에이전트를 다운로드해 설치할 수 있습니다.
참고: 비 Amazon Linux AMI를 사용할 때는 Amazon ECS 에이전트가 태스크 수준의 리소스 한도를 지원하려면 Amazon EC2 인스턴스가 cgroup 드라이버용
cgroupfs를 지원해야 합니다. 자세한 내용은 GitHub의 "Amazon ECS agent"를 참고하세요.
최신 Amazon ECS 컨테이너 에이전트 파일은 시스템 아키텍처별로 Region별로 다음 표에 나열되어 있습니다(참고용).
| Region | Region 이름 | Amazon ECS init deb 파일 | Amazon ECS init rpm 파일 |
|---|---|---|---|
| us-east-2 | US East (Ohio) | Amazon ECS init amd64 (amd64), Amazon ECS init arm64 (arm64) | Amazon ECS init x86_64 (x86_64), Amazon ECS init aarch64 (aarch64) |
| us-east-1 | US East (N. Virginia) | Amazon ECS init amd64 (amd64), Amazon ECS init arm64 (arm64) | Amazon ECS init x86_64 (x86_64), Amazon ECS init aarch64 (aarch64) |
| us-west-1 | US West (N. California) | Amazon ECS init amd64 (amd64), Amazon ECS init arm64 (arm64) | Amazon ECS init x86_64 (x86_64), Amazon ECS init aarch64 (aarch64) |
| us-west-2 | US West (Oregon) | Amazon ECS init amd64 (amd64), Amazon ECS init arm64 (arm64) | Amazon ECS init x86_64 (x86_64), Amazon ECS init aarch64 (aarch64) |
| ap-east-1 | Asia Pacific (Hong Kong) | Amazon ECS init amd64 (amd64), Amazon ECS init arm64 (arm64) | Amazon ECS init x86_64 (x86_64), Amazon ECS init aarch64 (aarch64) |
| ap-northeast-1 | Asia Pacific (Tokyo) | Amazon ECS init amd64 (amd64), Amazon ECS init arm64 (arm64) | Amazon ECS init x86_64 (x86_64), Amazon ECS init aarch64 (aarch64) |
| ap-northeast-2 | Asia Pacific (Seoul) | Amazon ECS init amd64 (amd64), Amazon ECS init arm64 (arm64) | Amazon ECS init x86_64 (x86_64), Amazon ECS init aarch64 (aarch64) |
| ap-south-1 | Asia Pacific (Mumbai) | Amazon ECS init amd64 (amd64), Amazon ECS init arm64 (arm64) | Amazon ECS init x86_64 (x86_64), Amazon ECS init aarch64 (aarch64) |
| ap-southeast-1 | Asia Pacific (Singapore) | Amazon ECS init amd64 (amd64), Amazon ECS init arm64 (arm64) | Amazon ECS init x86_64 (x86_64), Amazon ECS init aarch64 (aarch64) |
| ap-southeast-2 | Asia Pacific (Sydney) | Amazon ECS init amd64 (amd64), Amazon ECS init arm64 (arm64) | Amazon ECS init x86_64 (x86_64), Amazon ECS init aarch64 (aarch64) |
| ca-central-1 | Canada (Central) | Amazon ECS init amd64 (amd64), Amazon ECS init arm64 (arm64) | Amazon ECS init x86_64 (x86_64), Amazon ECS init aarch64 (aarch64) |
| eu-central-1 | Europe (Frankfurt) | Amazon ECS init amd64 (amd64), Amazon ECS init arm64 (arm64) | Amazon ECS init x86_64 (x86_64), Amazon ECS init aarch64 (aarch64) |
| eu-west-1 | Europe (Ireland) | Amazon ECS init amd64 (amd64), Amazon ECS init arm64 (arm64) | Amazon ECS init x86_64 (x86_64), Amazon ECS init aarch64 (aarch64) |
| eu-west-2 | Europe (London) | Amazon ECS init amd64 (amd64), Amazon ECS init arm64 (arm64) | Amazon ECS init x86_64 (x86_64), Amazon ECS init aarch64 (aarch64) |
| eu-west-3 | Europe (Paris) | Amazon ECS init amd64 (amd64), Amazon ECS init arm64 (arm64) | Amazon ECS init x86_64 (x86_64), Amazon ECS init aarch64 (aarch64) |
| sa-east-1 | South America (São Paulo) | Amazon ECS init amd64 (amd64), Amazon ECS init arm64 (arm64) | Amazon ECS init x86_64, Amazon ECS init aarch64 (aarch64) |
| us-gov-east-1 | AWS GovCloud (US-East) | Amazon ECS init amd64 (amd64), Amazon ECS init arm64 (arm64) | Amazon ECS init x86_64 (x86_64), Amazon ECS init aarch64 (aarch64) |
| us-gov-west-1 | AWS GovCloud (US-West) | Amazon ECS init amd64 (amd64), Amazon ECS init arm64 (arm64) | Amazon ECS init x86_64 (x86_64), Amazon ECS init aarch64 (aarch64) |
비 Amazon Linux AMI를 사용하는 Amazon EC2 인스턴스에 Amazon ECS 컨테이너 에이전트 설치하기
- Amazon ECS에 접근할 수 있는 IAM 역할로 Amazon EC2 인스턴스를 시작합니다. 자세한 내용은 "Amazon ECS container instance IAM role"을 참고하세요.
- 인스턴스에 연결합니다.
- 인스턴스에 지원되는 버전의 Docker를 설치합니다. 자세한 내용은 "Docker Support"를 참고하세요.
- Docker 버전을 확인해 시스템이 최소 버전 요구 사항을 충족하는지 검증합니다.
더 알아보기 (Learn more)
- Amazon ECS 컨테이너 에이전트에 대한 자세한 내용은 AWS 공식 문서를 참고해 주세요.