AWS Toolkit for Visual Studio Code의 Amazon Elastic Container Service Exec - VS 코드용 AWS 도구 키트
Amazon ECS Exec 필수 조건 Amazon ECS Exec 작업

AWS Toolkit for Visual Studio Code의 Amazon Elastic Container Service Exec

Amazon ECS Exec 기능을 사용하면 AWS Toolkit for Visual Studio Code로 Amazon Elastic Container Service(Amazon ECS) 컨테이너에서 단일 명령을 실행할 수 있습니다.

중요

Amazon ECS Exec을 활성 또는 비활성화하면 AWS 계정의 리소스 상태가 바뀝니다. 서비스 중지 및 재시작을 해도 바뀝니다. Amazon ECS Exec이 활성화된 상태에서 리소스 상태를 변경하면 예상치 못한 결과가 발생할 수 있습니다. Amazon ECS Exec에 대한 자세한 내용은 개발자 안내서의 Using Amazon ECS Exec for Debugging(Amazon ECS Exec로 디버깅하기)을 참조하세요.

Amazon ECS Exec 필수 조건

Amazon ECS Exec 기능을 사용하기 위한 필수 조건을 충족해야 합니다.

Amazon ECS 사전 조건

Amazon EC2 또는 AWS Fargate (Fargate)에서 작업 호스팅 여부에 따라 다른 Amazon ECS Exec 버전이 필요합니다.

  • Amazon EC2를 사용하는 경우 2021년 1월 20일 이후에 출시된 에이전트 버전 1.50.2 이상의 Amazon ECS optimized AMI를 사용하세요. 추가 정보는 개발자 안내서의 Amazon ECS optimized AMIs에서 확인할 수 있습니다.

  • AWS Fargate를 사용하는 경우 플랫폼 버전 1.4.0 이상을 사용해야 합니다. Fargate 요구 사항에 대한 자세한 정보는 개발자 안내서의 AWS Fargate platform versions에서 확인하세요.

AWS 계정 구성 및 IAM 권한

AWS 계정에 연결된 Amazon ECS 클러스터가 있어야 Amazon ECS Exec 기능을 사용할 수 있습니다. Amazon ECS Exec은 Systems Manager를 통해 클러스터의 컨테이너에 연결되며 특정 Task IAM 역할 권한이 있어야 SSM 서비스와 통신할 수 있습니다.

Amazon ECS Exec과 관련된 IAM 역할 및 정책 정보는 개발자 안내서의 IAM permissions required for ECS Exec(ECS Exec에 필요한 IAM 권한)에서 확인할 수 있습니다.

Amazon ECS Exec 작업

VS Code용 도구 키트 AWS 탐색기에서 바로 Amazon ECS Exec을 활성 또는 비활성할 수 있습니다. Amazon ECS Exec을 사용한다면 Amazon ECS 메뉴에서 컨테이너를 선택하고 해당 컨테이너에 대한 명령어를 실행합니다.

Amazon ECS Exec 사용

  1. AWS 탐색기에서 Amazon ECS 메뉴를 찾아 확장합니다.

  2. 수정할 서비스가 포함된 클러스터를 확장합니다.

  3. 서비스의 컨텍스트 메뉴를 열고(마우스 우클릭) Enable Command Execution(명령 실행)을 선택합니다.

중요

새로운 서비스가 설치되며 몇 분 정도 걸릴 수 있습니다. 자세한 내용은 이 섹션의 시작 부분에 나오는 참고를 참조하세요.

Amazon ECS Exec 끄기

  1. AWS 탐색기에서 Amazon ECS 메뉴를 찾아 확장합니다.

  2. 원하는 서비스가 포함된 클러스터를 확장합니다.

  3. 서비스의 컨텍스트 메뉴를 열고(마우스 우클릭) Disable Command Execution(명령 실행 취소)을 선택합니다.

중요

새로운 서비스가 설치되며 몇 분 정도 걸릴 수 있습니다. 자세한 내용은 이 섹션의 시작 부분에 나오는 참고를 참조하세요.

컨테이너에 대한 명령어 실행

Amazon ECS Exec가 활성화되어 있어야 AWS 탐색기에서 컨테이너에 대한 명령어를 실행할 수 있습니다. 활성화되지 않은 경우 이 섹션의 Enabling ECS Exec(ECS Exec 활성화) 방법을 참조하세요.

  1. AWS 탐색기에서 Amazon ECS 메뉴를 찾아 확장합니다.

  2. 원하는 서비스가 포함된 클러스터를 확장합니다.

  3. 서비스를 확장하여 연결된 컨테이너를 나열합니다.

  4. 컨테이너의 컨텍스트 메뉴를 열고(마우스 우클릭) Run Command in Container(컨테이너에서 명령 실행)를 선택합니다.

  5. 실행 중인 작업 목록이 포함된 프롬프트가 나타나면 원하는 Task ARN을 선택합니다.

    참고

    해당 서비스에 Task 한 개만 실행 중이라면 Task가 자동으로 선택되며 이 단계는 생략됩니다.

  6. 프롬프트가 표시되면 실행할 명령어를 입력하고 Enter 키를 눌러 계속 진행합니다.