aws-env (CLI)

ECS 환경 변수 추출

–task-definition-container 및 –task-definition-version 옵션을 사용하여 특정 ECS 태스크 정의의 컨테이너 환경 변수를 가져올 수 있습니다. 버전이 지정되지 않으면 최신 버전을 자동으로 사용합니다.

Lambda 환경 변수 추출

–lambda 옵션을 통해 특정 Lambda 함수 이름과 연관된 환경 변수를 추출할 수 있습니다.

자격 증명 처리

–credentials 플래그를 사용하면 액세스 토큰만 가져올 수 있으며, –only-credentials 플래그는 자격 증명 갱신에만 집중하여 다른 처리를 건너뜁니다.

출력 및 오버라이드 제어

–output 옵션으로 결과가 저장될 파일 이름을 지정할 수 있으며, –override-file 로 기존 .env 파일을 제공하여 fetched 값을 덮어쓸 수 있습니다.

다운로드·설치 방법

공식 실행 파일(.exe)을 다운로드한 후, 해당 파일의 경로를 시스템 환경 변수에 추가하여 어디서든 aws-env 명령을 실행할 수 있도록 설정해야 합니다. 또는 소스 코드를 클론한 후 cargo build --release 명령으로 직접 빌드하여 생성된 .exe 파일을 사용할 수 있습니다.

기본 사용법/명령어

도움말을 보려면 aws-env --help 명령을 실행합니다. 기본 사용법은 aws-env를 입력한 후 프롬프트에 따라 프로파일, 출력 파일, 대상 리소스 유형 등을 차례대로 입력하는 방식입니다. 이때 사용하려는 AWS 프로파일은 사전에 aws sso login --profile Foo와 같은 명령으로 로그인되어 있어야 합니다.

이런 경우에 유용합니다

로컬에서 AWS 기반 애플리케이션을 개발하거나 테스트할 때, 클라우드에 배포된 ECS 태스크 또는 Lambda 함수와 동일한 환경 변수 설정을 재현해야 하는 개발자에게 유용합니다. 이를 통해 환경 차이로 인한 디버깅 시간을 줄이고 일관된 개발 환경을 유지할 수 있습니다.

제한 사항·확인 사항

• 이 도구는 AWS CLI가 v2.34.41 이상으로 설치되어 있고, 해당 프로파일로 로그인된 상태에서만 정상 동작합니다.
• 현재 버전은 작업 중인 상태이며, 오류 처리 방식이 개선되지 않아 예외 발생 시 프로그램이 중단될 수 있습니다.
• AWS_REGION을 명시적으로 지정하는 옵션은 아직 지원되지 않아, 기본 설정 또는 AWS CLI의 지역 설정에 의존합니다.