Updated at : Mon Oct 19 2026
이 포스팅은 AWS Skill Builder의 AWS Developer 과정을 학습하며 남긴 기록입니다.
이 챕터는 어떤 방식으로 학습이 진행될지 소개하는 내용이 주를 이룬다. 따라서 따로 기록하지 않으려 하였으나, 개발 환경구성에 관한 내용도 다루기에 이는 기록하기로 한다.
Environment Setup
Development runtimes
- Node.js 및 Python 설치
설치는 각각의 공식사이트에 접속하여 진행하면 된다.
[Verificatin]
node --version (should show v20.x or higher; use an active LTS release)
npm --version (should show v8.x or higher)
python --version (should show v3.12 or higher)
pip --version (should show pip package manager)
AWS CDK(Cloud Development Kit)
- npm install -g aws-cdk
앞서 설치한 Node.js를 활용해 설치하면 된다.
[Verificatin]
cdk --version
AWS CLI (Command Line Interface)
위 사이트를 참조하여 설치하도록 하자. os별로 설치방법이 다르며 window는 다음과 같다.
1. irm https://awscli.amazonaws.com/v2/install.ps1 | iex
- 현재 유저용 설치, 여기서 유저라함은 컴퓨터 접속시 나오는 사용자인 듯함
- 모든 유저용 설치 명령어는 링크에서 확인 가능함. 하지만 굳이..?
2. aws update
- 안해도 무방하지 싶은데.. 공식문서에 나와있길래 진행함
- tip. CLI 설치 후 터미널 재실행해야 aws 명령어 인식함
[Verificatin]
aws --version
Code editor and Git
- Kiro or Visual Studio Code 설치
- Git 설치
Kiro는 AWS에서 제공하는 AI통합 개발환경이라고 한다. 익숙한 VSC를 사용하는게 좋을 수 있겠지만, AWS는 Kiro를 더 권유하고 있다. 개인적으로는 뭐.. 마음대로 해도 좋지 싶다. Git은... 알아서 설치하자.
CLI login & CDK Bootstrap
앞서 설치 단계에서 CDK를 처음 구성하였다면 bootstrap을 먼저 진행할 것을 권장하고 있다. 그러나 이를 바로 진행하면 높은 확율로 NoCredentials 오류가 발생할 것이다. 왜냐하면 로그인이 선행되었어야 하기 때문이다. 그리고 CDK 문서는 로그인은 CLI를 이용하여 로그인하는 것을 권장하고 있다.
CLI 로그인에는 두 가지 방식이 있다. 첫번째는 IAM 사용자 생성 후 access key를 활용해 로그인하는 것이고, 두번째는 IAM Identity Center 구성 후 sso(single sign on) 로그인하는 방법이다. 그러나 보안 문제 때문에 AWS에서는 access key를 활용하는 것은 지양하라고 한다. 따라서 나는 IAM Identity Center를 사용할 생각이나, 편의성 때문에 개인적인 개발 환경에서는 여전히 access key가 사용되는 듯도 하다. 이를 활용해보고자 한다면 여기를 참조하자.
IAM Identity Center
나는 당시 Identity Center를 처음 사용하였기에, 다음과 같은 과정을 거쳐야 했다. 더 자세한 내용은 공식문서에서 확인 가능하다.
- Identity Center 활성화 및 그룹/유저 생성
- 로그인에 사용할 계정을 만든다고 생각하면 된다.
- 권한을 부여하는 단계를 거치게 되는데, 이 권한을 그룹에 부여하는 편이 향후 활용에 용이하다고 안내한다. (유저가 속한 그룹만 이동시키면 되기 때문에)
- 콘솔 로그인
- 사용자를 만드는 과정에서 활용한 메일 주소로 초대 메일이 발송되어 온다. 이를 활용해 초대 수락 및 로그인을 진행하자.
- CLI 로그인
- 다음의 과정을 순차적으로 진행하도록 한다.
aws configure sso
SSO session name (Recommended): {세션 이름 임의지정}
SSO start URL [None]: https://{sso-포탈}.awsapps.com/start
SSO region [None]: {지역, e.g. ap-northeast-2}
SSO registration scopes [sso:account:access]: sso:account:access
{브라우저를 활용한 credential 검증}
Default client Region [None]: {지역, e.g. ap-northeast-2}
CLI default output format (json if not specified) [None]: json
Profile name [{권한}-{계정ID}]: {profile 이름 임의지정}
위의 과정을 거치면 로그인이 이루어진다. aws sts get-caller-identity --profile {profile 이름} 명령어를 활용하면 로그인이 잘 되어 있는지 검증해볼 수도 있다.
공식문서에서는 SSO start URL을 위에 작성한 것과 같은 값을 넣으라고 알려주며, 이 값은 콘솔 로그인된 URI 주소에서 찾을 수 있다. 그러나 콘솔 창에서 확인되는 엑세스 키를 확인해 보면, SSO 시작 URL이라는 항목으로 https://identitycenter.amazonaws.com/ssoins-{세션 ID} 라는 정보를 안내해준다. 둘의 차이점은 아직 모르겠으나, 이를 활용하더라도 정상적으로 로그인되는 것을 확인하였다.
aws configure sso은 첫 로그인시 환경 구성을 위해 사용한 것이다. 다음 로그인 시에는 aws sso login --profile {profile 이름} 명령어를 사용하면 된다.
이 sso 로그인 방식의 단점은 역시 불편함이라고 생각된다. 보안을 위해 매일 로그인하는 것은 하루 한번만 진행하면 되니 감내해줄만 하나, 대부분의 명령어에 --profile {profile 이름} 을 추가해서 호출해야한다는 점은 상당히 번거롭다. 이를 해결할 방법이 있으니, 환경변수를 지정하는 것이다. 다음은 window 환경의 power shell을 활용해 환경변수를 영구 지정하는 방법이다. 그 외의 방법은 여기를 확인해 보자.
[Environment]::SetEnvironmentVariable("AWS_PROFILE", "{profile 이름}", "User")
위 명령어를 활용시 환경변수가 영구히 저장되어, 명령어 기입시 --profile 추가를 하지 않아도 된다. 여기서 "User"는 컴퓨터 접속시 사용된 유저를 의미한다. 모든 유저가 사용케 하려면 "Machine"으로 입력하면 된다. 명령어 실행 후, 다음 power shell 세션부터 환경변수가 적용되니 주의토록 하자. 환경변수 지정이 잘 이루어졌는지 확인하고 싶거나, 지정을 해제하고 싶다면 다음 명령어들을 활용하면 된다.
해제: [Environment]::SetEnvironmentVariable("AWS_PROFILE", "", "User")
환경변수 전체 목록 확인: [Environment]::GetEnvironmentVariables("User")
CLI 로그인이 된 것을 확인하였다면, 이제 cdk bootstrap을 진행할 수 있다.
- cdk bootstrap aws://ACCOUNT-NUMBER/REGION --profile {profile 이름}
이는 CDK가 활용할 리소스들을 미리 준비해놓는 작업으로 다음과 같은 리소소들을 생성한다.
- IAM roles: CDK가 배포를 진행할 수 있도록 권한 부여
- S3 bucket: 람다코드 및 에셋 등의 CDK 프로젝트 파일의 저장
- ECR repository: 주로 사용되는 도커 이미지 저장
좀 더 자세한 내용을 원한다면, 공식문서를 참조하도록 하자.