소개
ekz는 AWS EKS Distro(EKS-D)를 기반으로 한 오픈소스 Kubernetes 배포판으로, 데스크톱 환경에서 EKS 호환 클러스터를 손쉽게 실행할 수 있도록 설계되었습니다. chanwit이 개발한 이 프로젝트는 k0s 및 KinD를 기반으로 한 두 가지 프로바이더를 제공하며, 로컬에서 EKS와 동일한 소프트웨어 스택을 사용하여 애플리케이션 테스트 및 개발 환경을 구축하는 데 유용합니다. Apache-2.0 라이선스로 배포되며, Windows, macOS, Linux를 지원하는 크로스플랫폼 도구입니다.
상세정보
EKZ provider (k0s 기반)
- EKS-D 바이너리 내장
- k0s를 기반으로 한 경량 프로바이더
- Amazon Linux 2를 베이스 이미지로 사용
- Kube-Router를 통한 기본 네트워크 정책 활성화 (Calico는 선택 사항)
- 로컬 스토리지 클래스 및 로드 밸런서 포함
KinD provider
- EKS-D 바이너리 내장
- KinD v0.11을 기반으로 한 프로바이더
- Kubernetes v1.18, v1.19, v1.20, v1.21 노드 이미지 사용
- Calico CNI를 통한 기본 네트워크 정책 활성화
- KinD 기반 로컬 스토리지 클래스 및 로드 밸런서 포함
다운로드·설치 방법
Windows 사용자는 Chocolatey 또는 Scoop을 통해 ekz를 간편하게 설치할 수 있습니다. 공식 문서에서는 다음과 같은 설치 방법을 권장합니다.
Chocolatey를 통한 설치
관리자 권한으로 PowerShell 또는 CMD를 열고 다음 명령을 실행합니다:
choco install -y ekz
Scoop을 통한 설치
먼저 ekz 전용 버킷을 추가한 후 패키지를 설치합니다:
scoop bucket add ekz-io https://github.com/ekz-io/scoop-ekz.git
scoop install ekz-io/ekz
기본 사용법/명령어
설치 후, 터미널에서 다음 명령을 실행하여 기본 EKZ 프로바이더로 클러스터를 생성할 수 있습니다:
ekz create cluster
KinD 프로바이더를 명시적으로 사용하려면 다음과 같이 플래그를 추가합니다:
ekz create cluster –provider=kind
또는 환경 변수를 설정하여 KinD를 기본 프로바이더로 사용할 수 있습니다:
export EKZ_PROVIDER=kind
ekz create cluster
클러스터가 생성되면 몇 분 정도 기다린 후, kubectl을 통해 노드 상태를 확인할 수 있습니다:
kubectl get nodes
이런 경우에 유용합니다
로컬에서 Amazon EKS와 동일한 환경에서 Kubernetes 애플리케이션을 테스트해야 하는 개발자에게 유용합니다. CI/CD 파이프라인 전에 로컬에서 검증하거나, EKS 특정 기능을 시뮬레이션해야 하는 경우에 적합합니다. 클라우드 비용 없이 EKS 호환 환경을 구축하여 학습 및 디버깅 목적으로도 활용할 수 있습니다.
지원 환경·시스템 요구사항
ekz는 Windows 10 이상, macOS, Linux에서 실행 가능하며, Docker가 사전에 설치되어 있어야 합니다. 클러스터는 Docker 컨테이너 내부에서 실행되므로, Docker Desktop 또는 Docker Engine이 필수입니다. Windows에서는 WSL 2 backend를 사용하는 Docker Desktop이 권장됩니다.
최신 버전·업데이트
현재 최신 버전은 0.8.0이며, 2026-09-04에 마지막으로 업데이트되었습니다. 이 버전은 Kubernetes 1.18부터 1.21까지의 EKS-D 릴리스와 호환성을 유지합니다. 자세한 변경 사항은 저장소의 릴리스 노트 또는 커밋 히스토리를 참조하시기 바랍니다.
시스템 요구사항
별도의 시스템 요구사항이 등록되지 않았습니다.


