피드로 돌아가기
Why ECS Exec Fails on ECS Managed Instance and How to Fix It
Dev.toDev.to
Infrastructure

ECS Managed Instance의 Public Subnet 네트워크 제약 해결을 통한 ECS Exec 연결 확보

Why ECS Exec Fails on ECS Managed Instance and How to Fix It

Kosuke Ozawa2026년 5월 8일1intermediate

Context

ECS Managed Instance를 Public Subnet에 배치 시 assignPublicIp=ENABLE 설정이 적용되지 않는 네트워크 제약 발생. 이로 인해 Task Container가 AWS 관리 평면과 통신하지 못해 TargetNotConnectedException 에러가 발생하는 구조적 한계 확인.

Technical Solution

  • VPC Endpoint 도입을 통한 AWS 서비스 간 프라이빗 통신 경로 확보로 TargetNotConnected 이슈 해결
  • NAT Gateway를 통한 아웃바운드 트래픽 라우팅으로 Public Subnet 내 Task의 외부 통신 가능성 확보
  • awsvpc 네트워크 모드 기반의 설계에서 발생하는 IP 할당 제약을 인프라 계층의 라우팅 변경으로 대응
  • 비용 효율성을 고려한 VPC Endpoint와 NAT Gateway의 선택적 적용으로 환경별 최적 경로 구성
  • 필요 시 네트워크 모드를 bridge로 전환하여 호스트 네트워크 인터페이스를 공유하는 대체 방안 검토

1. ECS Managed Instance 사용 시 Public IP 할당 가능 여부를 우선 확인

2. ECS Exec 실패 시 VPC Endpoint의 SSM 관련 설정 및 라우팅 테이블 점검

3. 운영 환경의 비용 최적화를 위해 NAT Gateway와 VPC Endpoint의 TCO 비교 분석

4. `awsvpc` 모드 사용 시 Task의 외부 연결성을 보장하는 네트워크 토폴로지 설계

원문 읽기