AncomWiki

두나무 EKS 환경 구축 및 IAM/RBAC 설정 작업 기록

Properties1
description두나무 프로젝트의 EKS 클러스터 초기화 및 운영 환경 설정 과정을 기록한 일일 노트입니다. 주요 작업으로는 EKS 노드 그룹의 Launch Template을 통해 SSM Agent 및 EFS 마운트 스크립트 자동화, 노드 IAM Role에 S3/EFS/ECR 등 필수 서비스 권한 부여, 그리고 Kubernetes 내부의 RBAC(ClusterRole/Binding) 및 IRSA(ServiceAccount)를 통한 S3-EF…

40 min read

두나무 EKS 환경 구축 및 IAM/RBAC 설정 작업 기록

Source

  • Field Notes/ReturnZero/Daily Notes/Day 1322. 2025-02-11.md

Summary

두나무 프로젝트의 EKS 클러스터 초기화 및 운영 환경 설정 과정을 기록한 일일 노트입니다. 주요 작업으로는 EKS 노드 그룹의 Launch Template을 통해 SSM Agent 및 EFS 마운트 스크립트 자동화, 노드 IAM Role에 S3/EFS/ECR 등 필수 서비스 권한 부여, 그리고 Kubernetes 내부의 RBAC(ClusterRole/Binding) 및 IRSA(ServiceAccount)를 통한 S3-EFS 데이터 복사용 Pod 구성이 포함됩니다. 또한 OIDC 로그인 문제 및 kubectl 플러그인 설치 실패 등 초기 접근 장애 사항과 해결 시도 과정이 기술되어 있습니다.

Key Points

  • EKS 노드 초기화: Launch Template User Data를 통해 amazon-ssm-agent 설치 및 EFS 마운트(/etc/fstab) 자동화
  • IAM 권한 설정: EKS 노드 Role(dunamu-stt-ec2)에 S3, EFS, EKS, SSM, Route53, KMS, CloudWatch Logs 정책 추가
  • K8s RBAC 구성: 운영자용 ClusterRole(파드 전체 제어, 배포물 읽기/수정) 및 ClusterRoleBinding 정의
  • IRSA 및 데이터 이동: S3 접근 권한이 부여된 ServiceAccount를 사용하여 S3 버킷에서 EFS로 데이터를 복사하는 Pod 구성
  • 접근성 문제: OIDC 로그인 실패, kubectl 플러그인 미설치, SSM Agent 연결 실패 등 초기 환경 설정 장애 및 대응 기록

그래프 뷰

백링크