AWS Cloud9용 AWS Toolkit의 Amazon ECS Exec - AWS Cloud9
Amazon ECS Exec 사전 조건 Amazon ECS Exec 작업

신규 고객은 더 이상 AWS Cloud9를 사용할 수 없습니다. AWS Cloud9의 기존 고객은 정상적으로 서비스를 계속 이용할 수 있습니다. 자세히 알아보기

AWS Cloud9용 AWS Toolkit의 Amazon ECS Exec

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

중요

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

Amazon ECS Exec 사전 조건

Amazon ECS Exec 기능을 사용하려면 먼저 충족해야 하는 몇 가지 사전 조건이 있습니다.

Amazon ECS 사전 조건

작업이 Amazon EC2에서 호스팅되는지 AWS Fargate에서 호스팅되는지에 따라 Amazon ECS Exec의 버전 요구 사항이 다릅니다.

  • Amazon EC2를 사용하는 경우 2021년 1월 20일 이후에 출시된 Amazon ECS 최적화 AMI를 에이전트 버전 1.50.2 이상으로 사용해야 합니다. 자세한 내용은 Amazon ECS 개발자 안내서의 Amazon ECS 최적화 AMI를 참조하세요.

  • AWS Fargate를 사용하는 경우 플랫폼 버전 1.4.0 이상을 사용해야 합니다. 자세한 내용은 Amazon ECS 개발자 안내서의 AWS Fargate 플랫폼 버전을 참조하세요.

AWS 계정 구성 및 IAM 권한

Amazon ECS Exec 기능을 사용하려면 AWS 계정과 연결된 기존 Amazon ECS 클러스터가 있어야 합니다. Amazon ECS Exec은 Systems Manager를 사용하여 클러스터의 컨테이너와 연결을 설정합니다. Amazon ECS에서는 SSM 서비스와 통신하기 위해 특정 작업 IAM 역할 권한이 필요합니다.

Amazon ECS Exec와 관련된 IAM 역할 및 정책에 대한 자세한 내용은 Amazon ECS 개발자 안내서의 ECS Exec에 필요한 IAM 권한을 참조하세요.

Amazon ECS Exec 작업

AWS Toolkit for AWS Cloud9의 AWS Explorer에서 바로 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 Explorer에서 Amazon ECS 메뉴를 찾아 확장합니다.

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

  3. 서비스의 컨텍스트(마우스 오른쪽 버튼 클릭) 메뉴를 열고 Disable Command Execution(명령 실행 비활성화)을 선택합니다.

중요

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

컨테이너에 대한 명령 실행

AWS Explorer를 사용하여 컨테이너에 대해 명령을 실행하려면 Amazon ECS Exec을 활성화해야 합니다. 활성화되지 않은 경우 이 섹션의 Amazon ECS Exec 활성화 절차를 참조하세요.

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

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

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

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

  5. 실행 중인 태스크 목록과 함께 프롬프트가 열립니다. 원하는 태스크 ARN을 선택합니다.

    참고

    실행 중인 작업이 하나뿐이면 프롬프트가 열리지 않습니다. 대신 태스크가 자동으로 선택됩니다.

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