JSCODE Logo
프로그래밍 과외블로그후기멘토진
회사명 : JSCODE대표 : 박재성사업자 등록번호 : 244-22-01557통신판매업 : 제 2023-인천미추홀-0381 호
학원 명칭 : 제이에스코드(JSCODE)원격학원학원설립ㆍ운영 등록번호 : 제6063호

서울특별시 구로구 경인로 20가길 11(오류동, 아델리아)

Copyright ⓒ 2025 JSCODE - 최상위 현업 개발자들의 프로그래밍 교육 All rights reserved.

이용약관개인정보처리방침
← 블로그 목록으로 돌아가기

로컬에서의 쿠버네티스 설치 (Docker Desktop)

JSCODE 박재성
JSCODE 박재성
2025-12-06
author
JSCODE 박재성
category
쿠버네티스
createdAt
Dec 6, 2025
series
비전공자도 이해할 수 있는 쿠버네티스 입문/실전
slug
install-kubernetes-locally-docker-desktop
type
post
updatedAt
Dec 6, 2025 04:46 AM

✅ 로컬에서의 쿠버네티스 설치

여러 책이나 강의를 살펴보면 쿠버네티스를 설치하는 과정이 굉장히 복잡하며 어렵다. 설치하는 과정만 따라가는데도 포기하고 싶은 마음이 여러 번 드는 게 쿠버네티스이다. 하지만 현업으로 가보면 막상 쿠버네티스를 직접 설치할 일은 극히 드물다. Docker Desktop이라는 걸 활용하면 아주 쉽게 쿠버네티스를 설치해서 사용할 수 있다.
 

✅ Docker Desktop을 활용한 쿠버네티스 설치 방법

  1. Docker Desktop 설치 / Docker Desktop에서 Kubernetes 활성화
    1. [Mac]
      [K8S] MacOS M2 환경 쿠버네티스 설치 (Docker Desktop)
      이번 시간에는 Kubernetes를 Docker Desktop를 사용하여 로컬환경에 설치하려고 한다. 이는 Lightweight Kubernetes Distributions 이라고 불리며 보통 개발과 테스트 환경에서 사용된다. Lightweight Kubernetes Distributions에는 Docker Desktop 이외에 Minikube, MicroK8S, Kind, K3S등이 있다. 아래 링크에 들의 비교글이 있다. https://www.baeldung.com/ops/kubernetes-lightweight-distributions#comparison 설치 1. 우선 Docker-desktop을 설치하자. 아래 링크로 들어가 Apple Chip 버전을 다운로드 후 설치하면 된다. Downloa..
      [K8S] MacOS M2 환경 쿠버네티스 설치 (Docker Desktop)
      https://soojae.tistory.com/87
      [K8S] MacOS M2 환경 쿠버네티스 설치 (Docker Desktop)
       
      [Windows]
      [Kubernetes] Window에서 Kubernetes 사용하기 (Docker Desktop으로 MiniKube 설치하기)
      이번 포스팅은 Window 환경에서 Kubernetes를 사용하는 방법에 대해 다뤄보도록 하겠다. Kubernetes란, Docker로 생성한 여러 컨테이너들을 쉽게 관리할 수 있는 도구이다. (이를 컨테이너 오케스트레이션 (Container Orchestration)이라고 한다.) 이전 포스팅에서 Docker Desktop (window 환경에서 도커 사용)을 설치하였다. (만약 설치가 안되었다면, 아래의 포스팅을 참고하면 된다.) https://hong-yp-ml-records.tistory.com/126 [Docker] Window에서 도커 사용하기 (설치하기) 최근 리눅스와 더불어 도커를 공부하고 있다. 아직 추상적으로 알고 있는 개념들이지만, 커맨드를 사용해가며 실용적인 방향으로 공부해보려고 한..
      [Kubernetes] Window에서 Kubernetes 사용하기 (Docker Desktop으로 MiniKube 설치하기)
      https://hong-yp-ml-records.tistory.com/127
      [Kubernetes] Window에서 Kubernetes 사용하기 (Docker Desktop으로 MiniKube 설치하기)
       
       
  1. kubectl 설치
    1. 💡
      kubectl(Kubernetes Control의 줄임말)이란?
      쿠버네티스에 명령어를 입력할 수 있게 해주는 CLI 툴이다.
      [Mac]
      macOS에 kubectl 설치 및 설정
      시작하기 전에 클러스터의 마이너(minor) 버전 차이 내에 있는 kubectl 버전을 사용해야 한다. 예를 들어, v1.31 클라이언트는 v1.30, v1.31, v1.32의 컨트롤 플레인과 연동될 수 있다. 호환되는 최신 버전의 kubectl을 사용하면 예기치 않은 문제를 피할 수 있다. macOS에 kubectl 설치 다음과 같은 방법으로 macOS에 kubectl을 설치할 수 있다. macOS에서 curl을 사용하여 kubectl 바이너리 설치 macOS에서 Homebrew를 사용하여 설치 macOS에서 Macports를 사용하여 설치 macOS에서 curl을 사용하여 kubectl 바이너리 설치 최신 릴리스를 다운로드한다. Intel Apple Silicon curl -LO "https://dl.
      macOS에 kubectl 설치 및 설정
      https://kubernetes.io/ko/docs/tasks/tools/install-kubectl-macos/
      macOS에 kubectl 설치 및 설정
       
      [Windows]
      윈도우에 kubectl 설치 및 설정
      시작하기 전에 클러스터의 마이너(minor) 버전 차이 내에 있는 kubectl 버전을 사용해야 한다. 예를 들어, v1.31 클라이언트는 v1.30, v1.31, v1.32의 컨트롤 플레인과 연동될 수 있다. 호환되는 최신 버전의 kubectl을 사용하면 예기치 않은 문제를 피할 수 있다. 윈도우에 kubectl 설치 다음과 같은 방법으로 윈도우에 kubectl을 설치할 수 있다. 윈도우에서 curl을 사용하여 kubectl 바이너리 설치 Chocolatey, Scoop, 또는 winget을 사용하여 윈도우에 설치 윈도우에서 curl을 사용하여 kubectl 바이너리 설치 최신 패치 릴리스 1.31 다운로드: kubectl 1.
      윈도우에 kubectl 설치 및 설정
      https://kubernetes.io/ko/docs/tasks/tools/install-kubectl-windows/
      윈도우에 kubectl 설치 및 설정
       
       
  1. 잘 작동하는 지 확인
    1. 아래 명령어를 입력했을 때 버전 정보가 정상적으로 출력된다면 쿠버네티스 설치가 완료된 것이다. (버전 정보는 어느 시점에 설치했느냐에 따라 달라질 수 있다.)
      $ kubectl version
      notion image
 
 
author
category
쿠버네티스
createdAt
Dec 6, 2025
series
비전공자도 이해할 수 있는 쿠버네티스 입문/실전
slug
type
series-footer
updatedAt
Dec 6, 2025 04:46 AM
📎
이 글은 비전공자도 이해할 수 있는 쿠버네티스 입문/실전 강의의 수업 자료 중 일부입니다.