Amazon ECS Anywhere 문제 해결
Amazon ECS Anywhere 문제 해결
Amazon ECS Anywhere에서 외부 인스턴스를 등록·사용할 때 발생할 수 있는 일반적인 문제와 문제 해결 권장 사항을 알아봐요.
출처: 문서
본문
Amazon ECS Anywhere는 온프레미스 서버나 가상 머신(VM) 같은 외부 인스턴스를 Amazon ECS 클러스터에 등록하는 것을 지원해요. 다음은 발생할 수 있는 일반적인 문제와 그에 대한 문제 해결 권장 사항이에요.
- 외부 인스턴스 등록 문제
- 외부 인스턴스 네트워크 문제
- 외부 인스턴스에서 태스크 실행 문제
외부 인스턴스 등록 문제 (External instance registration issues)
외부 인스턴스를 Amazon ECS 클러스터에 등록할 때 다음 요구 사항이 충족되어야 해요:
- AWS Systems Manager 활성화(activation) - 활성화 ID와 활성화 코드로 구성되는 Systems Manager activation을 검색해야 해요. 이를 사용해 외부 인스턴스를 Systems Manager 관리형 인스턴스로 등록해요. Systems Manager activation을 요청할 때 등록 한도(registration limit)와 만료 날짜를 지정해요. 등록 한도는 활성화를 사용해 등록할 수 있는 최대 인스턴스 수를 지정해요. 등록 한도의 기본값은 인스턴스 1개예요. 만료 날짜는 활성화가 만료되는 시점을 지정해요. 기본값은 24시간이에요. 외부 인스턴스를 등록하는 데 사용하는 Systems Manager activation이 유효하지 않으면 새로 요청해요. 자세한 내용은 Registering an external instance to an Amazon ECS cluster 참고.
- IAM 정책 - 외부 인스턴스가 AWS API 작업과 통신하는 데 필요한 권한을 제공하는 IAM 정책이 사용돼요. 이 관리형 정책이 제대로 생성되지 않았거나 필요한 권한을 포함하지 않으면 외부 인스턴스 등록이 실패해요. 자세한 내용은 Amazon ECS Anywhere IAM role 참고.
- 설치 스크립트 - Amazon ECS는 외부 인스턴스에 Docker, Amazon ECS container agent, Systems Manager Agent를 설치하는 설치 스크립트를 제공해요. 설치 스크립트가 실패하면 같은 인스턴스에서 스크립트를 오류 없이 다시 실행하지 못할 가능성이 높아요. 이 경우 정리(cleanup) 프로세스를 따라 인스턴스에서 AWS 리소스를 제거해 설치 스크립트를 다시 실행할 수 있게 해요. 자세한 내용은 Deregistering an Amazon ECS external instance 참고.
- 참고 — 설치 스크립트가 Systems Manager activation을 성공적으로 요청·사용했다면 설치 스크립트를 두 번째로 실행할 때 Systems Manager activation을 다시 사용하게 돼요. 이로 인해 그 활성화의 등록 한도에 도달할 수 있어요. 이 한도에 도달하면 새 활성화를 만들어야 해요.
- GPU 워크로드 - GPU 워크로드에 외부 인스턴스에서 설치 스크립트를 실행할 때 NVIDIA 드라이버가 감지되지 않거나 제대로 구성되지 않으면 오류가 발생해요. 설치 스크립트는
nvidia-smi명령을 사용해 NVIDIA 드라이버의 존재를 확인해요.
외부 인스턴스 네트워크 문제 (External instance network issues)
외부 인스턴스는 AWS에 변경 사항을 통신하기 위해 AWS에 대한 네트워크 연결이 필요해요. 외부 인스턴스가 AWS에 대한 네트워크 연결을 잃으면 인스턴스에서 실행 중인 태스크는 수동으로 중지되지 않는 한 계속 실행돼요. AWS에 대한 연결이 복원된 후 외부 인스턴스의 Amazon ECS container agent와 Systems Manager Agent가 사용하는 AWS 자격 증명이 자동으로 갱신돼요.