Visual Studio로 개발 시 기본 등록하는 dev tag 이미지로 Docker Desktop k8s에서 실행하는 방법
아래의 과정에서 설명했지만,
ASP.NET Core 프로젝트를 AKS/k8s에 올리는 과정
; https://www.sysnet.pe.kr/2/0/12931
Docker Desktop + k8s 환경에서 local 이미지를 사용하는 방법
; https://www.sysnet.pe.kr/2/0/12938
닷넷 응용 프로그램을 Visual Studio로 개발해 Kubernetes에 올리는 경우 (기본 생성된 Dockerfile의 경우) 반드시
--target final 옵션을 추가해 docker build를 해야 합니다.
만약 그렇지 않고 Visual Studio 환경에서 디버깅 과정 중 빌드된 이미지가 local registry에 올라간 상태라면 k8s의 pod로 띄우려는 경우 다양한 오류가 발생합니다.
그랬을 때, 오류에 대한 현상을 분석해 볼까요? ^^ 우선,
yaml 파일을 아래와 같이 생성한 경우,
apiVersion: apps/v1
kind: Deployment
metadata:
name: net-webapp1-sample
spec:
replicas: 1
selector:
matchLabels:
app: net-webapp1-sample
template:
metadata:
labels:
app: net-webapp1-sample
spec:
containers:
- name: net-webapp1-sample
image: webapplication1
imagePullPolicy: Never
ports:
- containerPort: 8080
env:
- name: ASPNETCORE_URLS
value: "http://+:8080"
---
apiVersion: v1
kind: Service
metadata:
name: net-webapp1-sample
spec:
type: LoadBalancer
ports:
- port: 18000
targetPort: 8080
protocol: TCP
name: http
selector:
app: net-webapp1-sample
이 상태로는 쿠버네티스에서 적용 시 ErrImageNeverPull 오류가 발생합니다.
C:\temp> kubectl apply -f webapp1.yaml
deployment.apps/net-webapp1-sample created
service/net-webapp1-sample created
C:\temp> kubectl get pods
NAME READY STATUS RESTARTS AGE
net-webapp1-sample-7945fbd788-r5zz4 0/1 ErrImageNeverPull 0 4s
"imagePullPolicy: Never"로 지정했고 webapplication1 이미지도 등록돼 있지만,
C:\temp> docker images | findstr webapp
webapplication1 dev 5e4f15c593d6 2 hours ago 217MB
보는 바와 같이 tag가 "dev"로 등록되기 때문에 기본적으로 찾는 "latest"가 아니어서 ErrImageNeverPull 오류에 빠집니다. 그리하여 dev로 바꿔서 실행하면,
...[생략]...
spec:
containers:
- name: net-webapp1-sample
image: webapplication1:dev
imagePullPolicy: Never
ports:
- containerPort: 8080
env:
- name: ASPNETCORE_URLS
value: "http://+:8080"
...[생략]...
이제는 이미지를 찾을 수는 있지만 역시나 오류 상태에 빠집니다.
C:\temp> kubectl get po
NAME READY STATUS RESTARTS AGE
net-webapp1-sample-6996f7ddc-jtmsk 0/1 CrashLoopBackOff 7 (2m50s ago) 13m
C:\temp> kubectl describe pod net-webapp1-sample
...[생략]...
Events:
Type Reason Age From Message
---- ------ ---- ---- -------
Normal Scheduled 19s default-scheduler Successfully assigned default/net-webapp1-sample-6996f7ddc-jtmsk to docker-desktop
Normal Pulled 1s (x3 over 19s) kubelet Container image "webapplication1:dev" already present on machine
Normal Created 1s (x3 over 19s) kubelet Created container net-webapp1-sample
Normal Started 1s (x3 over 18s) kubelet Started container net-webapp1-sample
Warning BackOff 1s (x3 over 17s) kubelet Back-off restarting failed container net-webapp1-sample in pod net-webapp1-sample-6996f7ddc-jtmsk_default(8047387b-3d31-4e80-93b6-20f3af0bd314)
왜냐하면, Visual Studio에서 기본 생성한 Dockerfile의 경우 개발 시 등록되는 docker image는 "base" 정도만 포함된 상태이기 때문입니다. 이에 대해서는 아래의 글에서 이미 설명한 적이 있습니다.
Visual Studio - ASP.NET Core Web Application의 "Enable Docker Support" 옵션으로 달라지는 점
; https://www.sysnet.pe.kr/2/0/12171
FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS base
USER app
WORKDIR /app
EXPOSE 8080
만약, 이 상태로 k8s에 적용하고 싶다면 관련 볼륨과 entry point를 yaml에 추가로 명시해야 합니다.
실제로 그 과정을 직접 해볼까요? ^^ (어차피 local k8s에서 테스트하는 것도 대부분 개발 시점에 돌려 보는 것일 텐데, 그것을 위해 매번
final 이미지로 빌드하는 것도 꽤나 번거로운 작업일 수 있습니다.)
우선, docker desktop의 경우 기본 등록한 볼륨 서비스는
hostpath 하나입니다.
C:\temp> kubectl get sc
NAME PROVISIONER RECLAIMPOLICY VOLUMEBINDINGMODE ALLOWVOLUMEEXPANSION AGE
hostpath (default) docker.io/hostpath Delete Immediate false 190d
가장 필요한 것은 응용 프로그램의 배포 경로이므로,
-v "D:\temp\WebApplication1:/app"
이것을
WSL 2의 hostPath 경로 양식으로 yaml에 추가합니다.
containers:
- name: net-webapp1-sample
image: webapplication1:dev
imagePullPolicy: Never
ports:
- containerPort: 8080
env:
- name: ASPNETCORE_URLS
value: "http://+:8080"
volumeMounts:
- mountPath: /app
name: local-app
volumes:
- name: local-app
hostPath:
path: /run/desktop/mnt/host/c/temp/WebApplication1
type: Directory
물론, 이 상태에서 실행해도 여전히 CrashLoopBackOff 오류가 발생하는데요, 시작 프로그램이 지정돼 있지 않기 때문입니다. 따라서 이것까지 지정해 줘야,
containers:
- name: net-webapp1-sample
image: webapplication1:dev
imagePullPolicy: Never
command: ["dotnet", "/app/bin/Debug/net8.0/WebApplication1.dll"]
이제 제대로 동작하게 됩니다. ^^
C:\temp> kubectl apply -f webapp1.yaml
deployment.apps/net-webapp1-sample created
service/net-webapp1-sample created
C:\temp> kubectl get po
NAME READY STATUS RESTARTS AGE
net-webapp1-sample-f8c6576c7-6whxl 1/1 Running 0 10s
C:\temp> kubectl get svc
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
net-webapp1-sample LoadBalancer 10.106.177.192 localhost 18000:30961/TCP 4m27s
C:\temp> curl localhost:18000/weatherforecast
[{"date":"2024-06-14","temperatureC":-16,"temperatureF":4,"summary":"Chilly"},
...[생략]...
{"date":"2024-06-18","temperatureC":35,"temperatureF":94,"summary":"Balmy"}]
참고로, hostPath의 path를 일반적인 WSL 2처럼 /mnt/...로 지정하면,
...[생략]...
volumeMounts:
- mountPath: /app
name: local-app
volumes:
- name: local-app
hostPath:
path: /mnt/c/temp/WebApplication1
type: Directory
...[생략]...
ContainerCreating 상태에 빠지게 됩니다.
C:\temp> kubectl get po
NAME READY STATUS RESTARTS AGE
net-webapp1-sample-764d75cbc-j57kh 0/1 ContainerCreating 0 4s
C:\temp> kubectl describe pod net-webapp1-sample
...[생략]...
Events:
Type Reason Age From Message
---- ------ ---- ---- -------
Normal Scheduled 41s default-scheduler Successfully assigned default/net-webapp1-sample-764d75cbc-j57kh to docker-desktop
Warning FailedMount 9s (x7 over 41s) kubelet MountVolume.SetUp failed for volume "local-app" : hostPath type check failed: /mnt/c/temp/WebApplication1 is not a directory
[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]