이 문서에서는 Google Distributed Cloud에서 애플리케이션을 배포하는 방법을 설명합니다.
시작하기 전에
워크로드를 배포하려면 워크로드를 실행할 수 있는 사용자, 하이브리드, 독립형 클러스터가 있어야 합니다.
배포 만들기
다음 단계에서는 클러스터에 배포를 만듭니다.
다음 매니페스트를
my-deployment.yaml
이라는 파일에 복사합니다.apiVersion: apps/v1 kind: Deployment metadata: name: my-deployment spec: selector: matchLabels: app: metrics department: sales replicas: 3 template: metadata: labels: app: metrics department: sales spec: containers: - name: hello image: "us-docker.pkg.dev/google-samples/containers/gke/hello-app:2.0"
kubectl apply
를 사용하여 배포를 만듭니다.kubectl apply -f my-deployment.yaml --kubeconfig CLUSTER_KUBECONFIG
CLUSTER_KUBECONFIG를 클러스터의 kubeconfig 파일 경로로 바꿉니다.
성공적으로 생성되었는지 확인하기 위해 배포에 대한 기본 정보를 확인합니다.
kubectl get deployment my-deployment --kubeconfig CLUSTER_KUBECONFIG
출력은 배포에 사용 가능한 pod가 3개 있음을 보여줍니다.
NAME READY UP-TO-DATE AVAILABLE AGE my-deployment 3/3 3 3 27s
배포에서 포드가 나열됩니다.
kubectl get pods --kubeconfig CLUSTER_KUBECONFIG
출력은 배포에 3개의 포드가 실행 중임을 보여줍니다.
NAME READY STATUS RESTARTS AGE my-deployment-869f65669b-5259x 1/1 Running 0 34s my-deployment-869f65669b-9xfrs 1/1 Running 0 34s my-deployment-869f65669b-wn4ft 1/1 Running 0 34s
배포에 대한 자세한 정보를 확인하세요.
kubectl get deployment my-deployment --output yaml --kubeconfig CLUSTER_KUBECONFIG
출력은 배포 사양 및 상태에 대한 세부정보를 보여줍니다.
apiVersion: apps/v1 kind: Deployment metadata: ... generation: 1 name: my-deployment namespace: default ... spec: ... replicas: 3 revisionHistoryLimit: 10 selector: matchLabels: app: metrics department: sales ... spec: containers: - image: us-docker.pkg.dev/google-samples/containers/gke/hello-app:2.0 imagePullPolicy: IfNotPresent name: hello resources: {} terminationMessagePath: /dev/termination-log terminationMessagePolicy: File dnsPolicy: ClusterFirst restartPolicy: Always schedulerName: default-scheduler securityContext: {} terminationGracePeriodSeconds: 30 status: availableReplicas: 3 conditions: - lastTransitionTime: "2023-06-29T16:17:17Z" lastUpdateTime: "2023-06-29T16:17:17Z" message: Deployment has minimum availability. reason: MinimumReplicasAvailable status: "True" type: Available - lastTransitionTime: "2023-06-29T16:17:12Z" lastUpdateTime: "2023-06-29T16:17:17Z" message: ReplicaSet "my-deployment-869f65669b" has successfully progressed. reason: NewReplicaSetAvailable status: "True" type: Progressing observedGeneration: 1 readyReplicas: 3 replicas: 3 updatedReplicas: 3
배포를 설명합니다.
kubectl describe deployment my-deployment --kubeconfig CLUSTER_KUBECONFIG
출력은 연결된 ReplicaSet을 포함하여 배포에 대한 잘 정돈된 세부정보를 보여줍니다.
Name: my-deployment Namespace: default CreationTimestamp: Thu, 29 Jun 2023 16:17:12 +0000 Labels: <none> Annotations: deployment.kubernetes.io/revision: 1 Selector: app=metrics,department=sales Replicas: 3 desired | 3 updated | 3 total | 3 available | 0 unavailable StrategyType: RollingUpdate MinReadySeconds: 0 RollingUpdateStrategy: 25% max unavailable, 25% max surge Pod Template: Labels: app=metrics department=sales Containers: hello: Image: us-docker.pkg.dev/google-samples/containers/gke/hello-app:2.0 Port: <none> Host Port: <none> Environment: <none> Mounts: <none> Volumes: <none> Conditions: Type Status Reason ---- ------ ------ Available True MinimumReplicasAvailable Progressing True NewReplicaSetAvailable OldReplicaSets: <none> NewReplicaSet: my-deployment-869f65669b (3/3 replicas created) Events: Type Reason Age From Message ---- ------ ---- ---- ------- Normal ScalingReplicaSet 6m50s deployment-controller Scaled up replica set my-deployment-869f65669b to 3
LoadBalancer
유형의 서비스 만들기
클러스터 외부의 클라이언트에 배포를 노출하는 한 가지 방법은 LoadBalancer
유형의 Kubernetes 서비스를 만드는 것입니다.
LoadBalancer
유형의 서비스를 만들려면 다음 안내를 따르세요.
다음 매니페스트를
my-service.yaml
이라는 파일에 복사합니다.apiVersion: v1 kind: Service metadata: name: my-service spec: selector: app: metrics department: sales type: LoadBalancer ports: - port: 80 targetPort: 8080
이 연습에서 서비스에 대해 꼭 알아야 할 점은 다음과 같습니다.
app: metrics
라벨과department: sales
라벨이 모두 있는 Pod는 서비스의 구성원입니다.my-deployment
의 포드에 이러한 라벨이 있습니다.클라이언트가 TCP 포트
80
에서 서비스로 요청을 보내면 TCP 포트8080
의 구성원 포드로 요청이 전달됩니다.모든 구성원 포드에는 TCP 포트
8080
에서 리슨하는 컨테이너가 있어야 합니다.
기본적으로
hello-app
컨테이너는 TCP 포트8080
에서 리슨합니다. 앱의 Dockerfile 및 소스 코드를 보면 이 포트 설정을 확인할 수 있습니다.kubectl apply
를 사용해서 클러스터에 서비스를 만듭니다.kubectl apply -f my-service.yaml --kubeconfig CLUSTER_KUBECONFIG
CLUSTER_KUBECONFIG를 클러스터의 kubeconfig 파일 경로로 바꿉니다.
서비스를 확인합니다.
kubectl get service my-service --output yaml --kubeconfig CLUSTER_KUBECONFIG
출력은 다음과 비슷합니다.
apiVersion: v1 kind: Service metadata: ... name: my-service namespace: default ... spec: allocateLoadBalancerNodePorts: true clusterIP: 10.96.2.165 clusterIPs: - 10.96.2.165 externalTrafficPolicy: Cluster internalTrafficPolicy: Cluster ipFamilies: - IPv4 ipFamilyPolicy: SingleStack ports: - nodePort: 31565 port: 80 protocol: TCP targetPort: 8080 selector: app: metrics department: sales sessionAffinity: None type: LoadBalancer status: loadBalancer: ingress: - ip: 192.168.1.13
앞의 출력에서 서비스에
clusterIP
와 외부 IP 주소가 있는 것을 확인할 수 있습니다. 또한nodePort
,port
,targetPort
도 가졌습니다.clusterIP
는 이 연습과 관련이 없습니다. 외부 IP 주소(status.loadBalancer.ingress.ip
)는 클러스터 구성 파일에서 부하 분산기 주소 풀(spec.loadBalancer.addressPools
)을 정의할 때 지정한 주소 범위에 포함됩니다.예를 들어 서비스의 이전 출력에 표시된 값을 보겠습니다.
- 외부 IP 주소:
192.168.1.13
port
:80
nodePort
:31565
targetPort
:8080
클라이언트가 TCP 포트
80
의192.168.1.13
으로 요청을 전송합니다. 요청은 부하 분산기로 라우팅되고 여기에서 TCP 포트8080
의 구성원 포드로 전달됩니다.- 외부 IP 주소:
서비스를 호출합니다.
curl INGRESS_IP_ADDRESS
INGRESS_IP_ADDRESS를 이전 단계에서 검색한 서비스의
status
섹션에 있는 인그레스 IP 주소로 바꿉니다(status.loadBalancer.ingress
).출력에
Hello, world!
메시지가 표시됩니다.Hello, world! Version: 2.0.0 Hostname: my-deployment-869f65669b-wn4ft
LoadBalancer 포트 한도
LoadBalancer
유형은 NodePort
유형의 확장입니다. 따라서 LoadBalancer
유형의 서비스에 클러스터 IP 주소 및 하나 이상의 nodePort
값이 포함됩니다.
기본적으로 Kubernetes는 노드 포트를 LoadBalancer
유형의 서비스에 할당합니다.
이러한 할당은 클러스터에 할당된 2,768개의 사용 가능한 노드 포트를 빠르게 소진할 수 있습니다. 노드 포트를 저장하려면 LoadBalancer
서비스 사양에서 allocateLoadBalancerNodePorts
필드를 false
로 설정하여 부하 분산기 노드 포트 할당을 사용 중지합니다. 이렇게 설정하면 Kubernetes가 LoadBalancer 서비스에 노드 포트를 할당할 수 없습니다. 자세한 내용은 Kubernetes 문서의 부하 분산기 NodePort 할당 중지를 참조하세요.
다음은 노드 포트를 사용하지 않는 서비스를 만들기 위한 매니페스트입니다.
apiVersion: v1
kind: Service
metadata:
name: service-does-not-use-nodeports
spec:
selector:
app: my-app
type: LoadBalancer
ports:
- port: 8000
# Set allocateLoadBalancerNodePorts to false
allocateLoadBalancerNodePorts: false
서비스 삭제
서비스를 삭제하려면 다음 안내를 따르세요.
kubectl delete
를 사용해서 클러스터에서 서비스를 삭제합니다.kubectl delete service my-service --kubeconfig CLUSTER_KUBECONFIG
서비스가 삭제되었는지 확인합니다.
kubectl get services --kubeconfig CLUSTER_KUBECONFIG
출력에
my-service
가 더 이상 표시되지 않습니다.
배포 삭제
배포를 삭제하려면 다음 안내를 따르세요.
kubectl delete
를 사용해서 클러스터에서 배포를 삭제합니다.kubectl delete deployment my-deployment --kubeconfig CLUSTER_KUBECONFIG
배포가 삭제되었는지 확인합니다.
kubectl get deployments --kubeconfig CLUSTER_KUBECONFIG
출력에
my-deployment
가 더 이상 표시되지 않습니다.