로컬 PC에서 EKS 클러스터 환경 구성하는 방법

* 이 가이드는 로컬 PC(macOS 및 Windows 환경 기준)에서 Amazon EKS 클러스터를 관리하기 위해 필요한 모든 도구를 설치하고 설정하는 과정을 안내합니다.

 

1단계: 필수 명령줄 도구(CLI) 설치

[macOS (Terminal) 환경]

macOS 환경에서는 Homebrew 패키지 관리자를 사용하는 것이 가장 간편합니다.

(참고: Homebrew가 설치되어 있지 않다면, 먼저 터미널을 열고 아래 명령어를 실행하여 설치하세요.)

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

 

 

 

AWS CLI 설치

brew install awscli

 

kubectl 설치

brew install kubectl

 

eksctl 설치

brew install eksctl

 

---

[Windows (PowerShell) 환경]

Windows 환경에서는 Chocolatey 패키지 관리자를 사용하는 것이 가장 간편합니다.

(참고: Chocolatey가 설치되어 있지 않다면, 먼저 PowerShell을 관리자 권한으로 열고 Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1')) 를 실행하여 설치하세요.)

그냥 PowerShell 관리자 권한에서 실행하셔도 무방합니다.

 

AWS CLI 설치

choco install aws-cli

 

kubectl 설치

choco install kubernetes-cli

 

eksctl 설치

choco install eksctl

 

 

설치 후, 터미널(macOS) 또는 PowerShell(Windows) 창을 새로 열어 aws --version, kubectl version, eksctl version 명령어로 각 도구가 잘 설치되었는지 확인하세요.

 

---

2단계: AWS CLI 자격 증명(Credential) 설정

이 단계부터는 macOS와 Windows 모두 동일합니다.

이제 로컬 PC의 AWS CLI가 AWS 계정에 접근할 수 있도록 인증 정보를 설정해야 합니다.

이를 위해 CLI 방식 액세스가 활성화된 IAM 사용자의 액세스 키 ID와 비밀 액세스 키가 필요합니다.

 

터미널 또는 PowerShell에서 아래 명령어를 실행합니다.

aws configure

 

명령어를 실행하면 아래 4가지 정보를 차례대로 입력하라는 프롬프트가 나타납니다.

• AWS Access Key ID: 발급받은 액세스 키 ID를 붙여넣습니다.
• AWS Secret Access Key: 발급받은 비밀 액세스 키를 붙여넣습니다.
• Default region name: 클러스터가 있는 리전 이름을 입력합니다. (예: 서울 리전의 경우, ap-northeast-2)
• Default output format: json을 입력하거나 그냥 Enter를 누릅니다.

이 과정이 완료되면, 로컬 PC는 AWS 계정을 대신하여 EKS 클러스터에 접근할 수 있는 권한을 갖게 됩니다.

---

3단계: kubectl과 EKS 클러스터 연결

kubectl이 어떤 클러스터와 통신해야 하는지 알려주기 위해, 클러스터의 접속 정보가 담긴 설정 파일(kubeconfig)을 생성해야 합니다. AWS CLI는 이 과정을 자동으로 처리해주는 편리한 명령어를 제공합니다.

1. 터미널 또는 PowerShell에서 아래 명령어를 실행합니다.
   • <your-cluster-name> 부분은 실제 EKS 클러스터 이름으로 변경해 주세요.
   • <your-region> 부분은 클러스터가 있는 리전으로 변경해 주세요. (예: sa-east-1)

   aws eks update-kubeconfig --name <your-cluster-name> --region <your-region>

   Updated context ... 메시지가 나타나면 성공적으로 연결된 것입니다. 이 명령어는 macOS에서는 ~/.kube/config, Windows에서는 C:\Users\사용자이름\.kube\config 경로에 클러스터 접속 정보를 자동으로 추가하거나 업데이트합니다.

 

---

4단계: 연결 확인

이제 모든 설정이 완료되었습니다. kubectl 명령어를 사용하여 로컬 PC에서 원격 EKS 클러스터의 정보를 조회할 수 있는지 확인합니다.

1. 클러스터의 노드(서버) 목록 확인노드 목록과 상태(Ready)가 보이면 성공입니다.
2. kubectl get nodes
3. 특정 네임스페이스의 파드(애플리케이션) 목록 확인해당 네임스페이스에서 실행 중인 파드 목록이 보이면 완벽하게 설정이 완료된 것입니다.
4. # 이전에 테스트했던 app-monitoring-test 네임스페이스를 확인하는 예시입니다. kubectl get pods -n app-monitoring-test

이제 로컬 PC의 터미널에서 kubectl을 사용하여 EKS 클러스터의 모든 리소스를 관리할 수 있습니다.