Microsoft MVP성태의 닷넷 이야기
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
 

Docker Desktop for Windows에서 DockerDesktopVM 기반의 Kubernetes 구성

Docker Desktop for Windows 환경에서 k8s 클러스터를 구성하는 것은 다음의 단계만으로 쉽게 이뤄질 수 있습니다.

  1. docker desktop for window 설치
  2. "Use the WSL 2 based engine" 옵션은 (기본값 Off) 끄고,
  3. "Enable Kubernetes" 옵션을 활성화

이렇게 구성하면 docker와 k8s가 Hyper-V에 생성된 DockerDesktopVM에 구성되고, 윈도우 측에는 위의 인스턴스로 kubectl.exe로 접근이 가능하도록 %USERPROFILE%\.kube 디렉터리에 다음의 내용으로 config 파일이 생성됩니다.

apiVersion: v1
clusters:
- cluster:
    certificate-authority-data: LS0...[생략]...LQo=
    server: https://kubernetes.docker.internal:6443
  name: docker-desktop
contexts:
- context:
    cluster: docker-desktop
    user: docker-desktop
  name: docker-desktop
current-context: docker-desktop
kind: Config
preferences: {}
users:
- name: docker-desktop
  user:
    client-certificate-data: LS0tLS...[생략]...LS0K
    client-key-data: LS0tL...[생략]...LQo=

따라서, 이후 윈도우 측에서 kubectl.exe를 실행해도 config 파일의 내용에 따라 자연스럽게 DockerDesktopVM에 실행 중인 k8s API 서버와 연동하게 됩니다.




k8s 기본 Dashboard 구성은 이전 글에서 설명했고,

Docker for Windows를 위한 k8s 대시보드 활성화
; https://www.sysnet.pe.kr/2/0/12567

REST API 통신 방법도 설명했었습니다.

Kubernetes - kube-apiserver와 REST API 통신하는 방법 (Docker Desktop for Windows 환경)
; https://www.sysnet.pe.kr/2/0/12566

아울러, 처음 구성했을 때의 기본 상태를 대략 다음과 같은 명령어로 확인할 수 있습니다.

c:\temp> kubectl config view
apiVersion: v1
clusters:
- cluster:
    certificate-authority-data: DATA+OMITTED
    server: https://kubernetes.docker.internal:6443
  name: docker-desktop
contexts:
- context:
    cluster: docker-desktop
    user: docker-desktop
  name: docker-desktop
current-context: docker-desktop
kind: Config
preferences: {}
users:
- name: docker-desktop
  user:
    client-certificate-data: REDACTED
    client-key-data: REDACTED

c:\temp> kubectl get pods --all-namespaces
NAMESPACE     NAME                                     READY   STATUS    RESTARTS   AGE
kube-system   coredns-f9fd979d6-bqvqp                  1/1     Running   7          50d
kube-system   coredns-f9fd979d6-nxl7x                  1/1     Running   7          50d
kube-system   etcd-docker-desktop                      1/1     Running   7          50d
kube-system   kube-apiserver-docker-desktop            1/1     Running   9          50d
kube-system   kube-controller-manager-docker-desktop   1/1     Running   7          50d
kube-system   kube-proxy-52sck                         1/1     Running   7          50d
kube-system   kube-scheduler-docker-desktop            1/1     Running   59         50d
kube-system   storage-provisioner                      1/1     Running   58         50d
kube-system   vpnkit-controller                        1/1     Running   7          50d

C:\temp> kubectl get nodes -o wide
NAME             STATUS   ROLES    AGE   VERSION   INTERNAL-IP    EXTERNAL-IP   OS-IMAGE         KERNEL-VERSION      CONTAINER-RUNTIME
docker-desktop   Ready    master   50d   v1.19.3   192.168.65.4   <none>        Docker Desktop   4.19.121-linuxkit   docker://20.10.5

c:\temp> kubectl get namespace
NAME              STATUS   AGE
kube-node-lease   Active   50d
kube-public       Active   50d
kube-system       Active   50d

c:\temp> kubectl describe nodes
Name:               docker-desktop
Roles:              master
Labels:             beta.kubernetes.io/arch=amd64
                    beta.kubernetes.io/os=linux
                    kubernetes.io/arch=amd64
                    kubernetes.io/hostname=docker-desktop
                    kubernetes.io/os=linux
                    node-role.kubernetes.io/master=
Annotations:        kubeadm.alpha.kubernetes.io/cri-socket: /var/run/dockershim.sock
                    node.alpha.kubernetes.io/ttl: 0
                    volumes.kubernetes.io/controller-managed-attach-detach: true
CreationTimestamp:  Mon, 25 Jan 2021 15:01:42 +0900
Taints:             <none>
Unschedulable:      false
Lease:
  HolderIdentity:  docker-desktop
  AcquireTime:     <unset>
  RenewTime:       Tue, 16 Mar 2021 23:43:14 +0900
Conditions:
  Type             Status  LastHeartbeatTime                 LastTransitionTime                Reason                       Message
  ----             ------  -----------------                 ------------------                ------                       -------
  MemoryPressure   False   Tue, 16 Mar 2021 23:43:12 +0900   Mon, 25 Jan 2021 15:01:42 +0900   KubeletHasSufficientMemory   kubelet has sufficient memory available
  DiskPressure     False   Tue, 16 Mar 2021 23:43:12 +0900   Mon, 25 Jan 2021 15:01:42 +0900   KubeletHasNoDiskPressure     kubelet has no disk pressure
  PIDPressure      False   Tue, 16 Mar 2021 23:43:12 +0900   Mon, 25 Jan 2021 15:01:42 +0900   KubeletHasSufficientPID      kubelet has sufficient PID available
  Ready            True    Tue, 16 Mar 2021 23:43:12 +0900   Mon, 25 Jan 2021 15:02:13 +0900   KubeletReady                 kubelet is posting ready status
Addresses:
  InternalIP:  192.168.65.4
  Hostname:    docker-desktop
Capacity:
  cpu:                2
  ephemeral-storage:  61255652Ki
  hugepages-1Gi:      0
  hugepages-2Mi:      0
  memory:             2036632Ki
  pods:               110
Allocatable:
  cpu:                2
  ephemeral-storage:  56453208790
  hugepages-1Gi:      0
  hugepages-2Mi:      0
  memory:             1934232Ki
  pods:               110
System Info:
  Machine ID:                 397443a7-b161-4423-bee8-724eb7dd7ae5
  System UUID:                9f4fbf1d-b728-49c2-94b2-79e01d3bf8d2
  Boot ID:                    d193b323-269a-44a8-a188-a56022ed91e3
  Kernel Version:             4.19.121-linuxkit
  OS Image:                   Docker Desktop
  Operating System:           linux
  Architecture:               amd64
  Container Runtime Version:  docker://20.10.5
  Kubelet Version:            v1.19.3
  Kube-Proxy Version:         v1.19.3
Non-terminated Pods:          (10 in total)
  Namespace                   Name                                      CPU Requests  CPU Limits  Memory Requests  Memory Limits  AGE
  ---------                   ----                                      ------------  ----------  ---------------  -------------  ---
  kube-system                 coredns-f9fd979d6-bqvqp                   100m (5%)     0 (0%)      70Mi (3%)        170Mi (8%)     50d
  kube-system                 coredns-f9fd979d6-nxl7x                   100m (5%)     0 (0%)      70Mi (3%)        170Mi (8%)     50d
  kube-system                 etcd-docker-desktop                       0 (0%)        0 (0%)      0 (0%)           0 (0%)         50d
  kube-system                 kube-apiserver-docker-desktop             250m (12%)    0 (0%)      0 (0%)           0 (0%)         50d
  kube-system                 kube-controller-manager-docker-desktop    200m (10%)    0 (0%)      0 (0%)           0 (0%)         50d
  kube-system                 kube-proxy-52sck                          0 (0%)        0 (0%)      0 (0%)           0 (0%)         50d
  kube-system                 kube-scheduler-docker-desktop             100m (5%)     0 (0%)      0 (0%)           0 (0%)         50d
  kube-system                 storage-provisioner                       0 (0%)        0 (0%)      0 (0%)           0 (0%)         50d
  kube-system                 vpnkit-controller                         0 (0%)        0 (0%)      0 (0%)           0 (0%)         50d
Allocated resources:
  (Total limits may be over 100 percent, i.e., overcommitted.)
  Resource           Requests    Limits
  --------           --------    ------
  cpu                750m (37%)  0 (0%)
  memory             140Mi (7%)  340Mi (17%)
  ephemeral-storage  0 (0%)      0 (0%)
  hugepages-1Gi      0 (0%)      0 (0%)
  hugepages-2Mi      0 (0%)      0 (0%)
Events:              <none>




아울러 클러스터 사용을 위한 간단한 명령어 실습을 다음과 같이 할 수 있습니다.

C:\temp> kubectl run nginx-app --image nginx --port=80
pod/nginx-app created

C:\temp> kubectl get pods
NAME        READY   STATUS              RESTARTS   AGE
nginx-app   0/1     ContainerCreating   0          24s

c:\temp> kubectl get namespace
NAME              STATUS   AGE
default           Active   50d
kube-node-lease   Active   50d
kube-public       Active   50d
kube-system       Active   50d

C:\temp> kubectl get pods
NAME        READY   STATUS    RESTARTS   AGE
nginx-app   1/1     Running   0          111s

C:\temp> kubectl expose pod nginx-app --type=NodePort
service/nginx-app exposed

C:\temp> kubectl get service
NAME         TYPE        CLUSTER-IP    EXTERNAL-IP   PORT(S)        AGE
kubernetes   ClusterIP   10.96.0.1     <none>        443/TCP        50d
nginx-app    NodePort    10.99.8.202   <none>        80:30486/TCP   11s

정상적으로 서비스가 올라갔다면 다음과 같이 nginx로의 요청을 테스트할 수 있고,

c:\temp> curl localhost:30486
<!DOCTYPE html>
<html>
<head>
<title>Welcome to nginx!</title>
...[생략]...
<p><em>Thank you for using nginx.</em></p>
</body>
</html>

이후 정리는 이렇게!

c:\temp> kubectl delete pod nginx-app
pod "nginx-app" deleted

c:\temp> kubectl delete svc nginx-app
service "nginx-app" deleted




그외 docker-compose와 유사하게 yaml을 이용한 k8s의 서비스 관리가 가능합니다. 아래는 별도의 namespace 생성을 yaml을 이용하고, 이후 새로운 네임스페이스 하에 pod 구성하는 것을 보여줍니다.

c:\temp> type rndtest-namespace.yml
apiVersion: v1
kind: Namespace
metadata:
  name: rndtest

c:\temp> kubectl apply -f rndtest-namespace.yml
namespace/rndtest created

c:\temp> kubectl get namespace
NAME              STATUS   AGE
default           Active   50d
kube-node-lease   Active   50d
kube-public       Active   50d
kube-system       Active   50d
rndtest           Active   4s

c:\temp> kubectl run nginx-app --image nginx --namespace=rndtest
pod/nginx-app created

c:\temp> kubectl get pod -n rndtest
NAME        READY   STATUS    RESTARTS   AGE
nginx-app   1/1     Running   0          12s

c:\temp> kubectl delete pod nginx-app -n rndtest
pod "nginx-app" deleted

c:\temp> kubectl delete namespace rndtest
namespace "rndtest" deleted




[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]

[연관 글]






[최초 등록일: ]
[최종 수정일: 3/24/2021]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 작성자
 




[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
13116정성태8/4/2022171.NET Framework: 2041. C# - Socket.Close 시 Socket.Receive 메서드에서 예외가 발생하는 문제파일 다운로드1
13115정성태8/3/2022249.NET Framework: 2040. C# - ValueTask와 Task의 성능 비교파일 다운로드1
13114정성태8/2/2022234.NET Framework: 2039. C# - Task와 비교해 본 ValueTask 사용법파일 다운로드1
13113정성태7/31/2022223.NET Framework: 2038. C# 11 - Span 타입에 대한 패턴 매칭 (Pattern matching on ReadOnlySpan<char>)
13112정성태7/30/2022261.NET Framework: 2037. C# 11 - 목록 패턴(List patterns)파일 다운로드1
13111정성태7/29/2022234.NET Framework: 2036. C# 11 - IntPtr/UIntPtr과 nint/nuint의 통합파일 다운로드1
13110정성태7/27/2022260.NET Framework: 2035. C# 11 - 새로운 연산자 ">>>" (Unsigned Right Shift)파일 다운로드1
13109정성태7/27/2022210VS.NET IDE: 177. 비주얼 스튜디오 2022를 이용한 (소스 코드가 없는) 닷넷 모듈 디버깅 - "외부 원본(External Sources)"
13108정성태7/26/2022160Linux: 53. container에 실행 중인 Golang 프로세스를 디버깅하는 방법
13107정성태7/25/2022128Linux: 52. Debian/Ubuntu 계열의 docker container에서 자주 설치하게 되는 명령어
13106정성태7/24/2022110오류 유형: 819. 닷넷 6 프로젝트의 "Conditional compilation symbols" 기본값 오류
13105정성태7/23/2022230.NET Framework: 2034. .NET Core/5+ 환경에서 (프로젝트가 아닌) C# 코드 파일을 입력으로 컴파일하는 방법 - 두 번째 이야기 [1]
13104정성태7/23/2022202Linux: 51. WSL - init에서 systemd로 전환하는 방법
13103정성태7/22/2022112오류 유형: 818. WSL - systemd-genie와 관련한 2가지(systemd-remount-fs.service, multipathd.socket) 에러
13102정성태7/19/2022186.NET Framework: 2033. .NET Core/5+에서는 구할 수 없는 HttpRuntime.AppDomainAppId
13101정성태7/15/2022157[내용 예약] (비어 있는 글)
13100정성태7/15/2022263.NET Framework: 2032. C# 11 - shift 연산자 재정의에 대한 제약 완화 (Relaxing Shift Operator)
13099정성태7/14/2022652.NET Framework: 2031. C# 11 - 사용자 정의 checked 연산자파일 다운로드1
13098정성태7/13/2022194개발 환경 구성: 647. Azure - scale-out 상태의 App Service에서 특정 인스턴스에 요청을 보내는 방법
13097정성태7/12/2022148오류 유형: 817. Golang - binary.Read: invalid type int32
13096정성태7/8/2022435.NET Framework: 2030. C# 11 - UTF-8 문자열 리터럴
13095정성태7/7/2022227Windows: 208. AD 도메인에 참여하지 않은 컴퓨터에서 Kerberos 인증을 사용하는 방법
13094정성태7/6/2022157오류 유형: 816. Golang - "short write" 오류 원인
13093정성태7/5/2022265.NET Framework: 2029. C# - HttpWebRequest로 localhost 접속 시 2초 이상 지연
13092정성태7/3/2022430.NET Framework: 2028. C# - HttpWebRequest의 POST 동작 방식파일 다운로드1
[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...