kubectl을 사용하여 Azure Stack Edge Pro GPU 디바이스에서 StorageClass로 Kubernetes 상태 저장 애플리케이션 실행
적용 대상: 
Azure Stack Edge Pro - GPUAzure Stack Edge Pro 2Azure Stack Edge Pro RAzure Stack Edge Mini R
이 문서에서는 StorageClass를 통해 스토리지 및 배포를 동적으로 프로비저닝하여 Kubernetes에 단일 인스턴스 상태 저장 애플리케이션을 배포하는 방법을 보여 줍니다. 배포는 기존 Kubernetes 클러스터에서 kubectl 명령을 사용하고 MySQL 애플리케이션을 배포합니다.
이 절차는 Azure Stack Edge Pro 디바이스의 Kubernetes 스토리지를 검토했으며 Kubernetes 스토리지의 개념에 대해 잘 알고 있는 사용자를 위해 제공됩니다.
필수 조건
상태 저장 애플리케이션을 배포하기 전에 디바이스에 액세스하는 데 사용할 디바이스 및 클라이언트에 대한 다음 필수 구성 요소를 완료합니다.
디바이스의 경우
- 1노드 Azure Stack Edge Pro 디바이스에 대한 로그인 자격 증명이 있어야 합니다.
디바이스에 액세스하는 클라이언트의 경우
- Azure Stack Edge Pro 디바이스에 액세스하는 데 사용되는 Windows 클라이언트 시스템이 있습니다.
클라이언트에서 Windows PowerShell 5.0 이상을 실행하고 있습니다. 최신 버전의 Windows PowerShell을 다운로드하려면 Windows Powershell 설치로 이동합니다.
지원되는 운영 체제를 사용하는 다른 클라이언트도 있을 수 있습니다. 이 문서에서는 Windows 클라이언트를 사용하는 절차에 대해 설명합니다.
Azure Stack Edge Pro 디바이스에서 Kubernetes 클러스터에 액세스에 설명된 절차를 완료했습니다. 수행한 작업은 다음과 같습니다.
New-HcsKubernetesNamespace명령을 통해userns1네임스페이스를 만들었습니다.New-HcsKubernetesUser명령을 통해user1사용자를 만들었습니다.Grant-HcsKubernetesNamespaceAccess명령을 통해userns1에 대한user1액세스 권한을 부여했습니다.- 클라이언트에
kubectl을 설치하고 사용자 구성이 포함된kubeconfig파일을 C:\Users\<username>\.kube에 저장했습니다.
kubectl클라이언트 버전이 Azure Stack Edge Pro 디바이스에서 실행되는 Kubernetes 마스터 버전보다 두 버전 이상 차이 나지 않는지 확인합니다.kubectl version을 사용하여 클라이언트에서 실행되는 kubectl의 버전을 확인합니다. 전체 버전을 기록해 둡니다.- Azure Stack Edge Pro 디바이스의 로컬 UI에서 개요로 이동하여 Kubernetes 소프트웨어 번호를 확인합니다.
- 이 두 개의 버전이 지원되는 Kubernetes 버전에서 제공되는 매핑과 호환되는지 확인합니다.
Azure Stack Edge Pro 디바이스에 상태 저장 애플리케이션을 배포할 준비가 되었습니다.
MySQL 배포
이제 Kubernetes 배포를 만들고 PVC(PersistentVolumeClaim)를 통해 기본 제공 StorageClass에 연결하여 상태 저장 애플리케이션을 실행합니다.
상태 저장 애플리케이션 배포를 만들고 관리하는 데 사용하는 모든 kubectl 명령은 구성과 연결된 네임스페이스를 지정해야 합니다. kubectl 명령에서 네임스페이스를 지정하려면 kubectl <command> -n <your-namespace>를 사용합니다.
네임스페이스의 Kubernetes 클러스터에서 실행되는 Pod 목록을 가져옵니다. Pod는 Kubernetes 클러스터에서 실행되는 애플리케이션 컨테이너 또는 프로세스입니다.
kubectl get pods -n <your-namespace>다음은 명령 사용의 예입니다.
C:\Users\user>kubectl get pods -n "userns1" No resources found in userns1 namespace. C:\Users\user>클러스터에서 실행 중인 애플리케이션이 없기 때문에 리소스(Pod)가 없다는 내용이 출력에 표시되어야 합니다.
다음 YAML 파일을 사용하게 됩니다.
mysql-deployment.yml파일은 MySQL을 실행하고 PVC를 참조하는 배포를 설명합니다. 이 파일은/var/lib/mysql의 볼륨 탑재를 정의한 후 20GB 볼륨을 검색하는 PVC를 만듭니다. 동적 PV가 프로비저닝되고 PVC가 이 PV에 바인딩됩니다.Azure Stack Edge Pro 디바이스에 액세스하는 데 사용하는 Windows 클라이언트의 폴더에 다음
mysql-deployment.yml파일을 복사하여 저장합니다.apiVersion: v1 kind: Service metadata: name: mysql spec: ports: - port: 3306 selector: app: mysql clusterIP: None --- apiVersion: apps/v1 # for versions before 1.9.0 use apps/v1beta2 kind: Deployment metadata: name: mysql spec: selector: matchLabels: app: mysql strategy: type: Recreate template: metadata: labels: app: mysql spec: containers: - image: mysql:5.6 name: mysql env: # Use secret in real usage - name: MYSQL_ROOT_PASSWORD value: password ports: - containerPort: 3306 name: mysql volumeMounts: - name: mysql-persistent-storage mountPath: /var/lib/mysql volumes: - name: mysql-persistent-storage persistentVolumeClaim: claimName: mysql-pv-claim-scmysql-deployment.yml을 저장한 폴더와 동일한 폴더에mysql-pvc.yml파일을 복사하고 저장합니다. 연결된 데이터 디스크의 Azure Stack Edge Pro 디바이스에 기본 제공 StorageClass를 사용하려면 PVC 개체의storageClassName필드를ase-node-local로 설정하고 accessModes는ReadWriteOnce여야 합니다.참고 항목
YAML 파일의 들여쓰기가 올바른지 확인합니다. YAML lint로 확인하여 유효성을 검사한 후 저장할 수 있습니다.
apiVersion: v1 kind: PersistentVolumeClaim metadata: name: mysql-pv-claim-sc spec: storageClassName: ase-node-local accessModes: - ReadWriteOnce resources: requests: storage: 20Gimysql-pvc.yaml파일을 배포합니다.kubectl apply -f <URI path to the mysql-pv.yml file> -n <your-user-namespace>배포의 샘플 출력은 다음과 같습니다.
C:\Users\user>kubectl apply -f "C:\stateful-application\mysql-pvc.yml" -n userns1 persistentvolumeclaim/mysql-pv-claim-sc created C:\Users\user>생성된 PVC의 이름을 기록해 둡니다(이 예제에서는
mysql-pv-claim-sc). 이후 단계에서 사용하게 됩니다.mysql-deployment.yml파일의 콘텐츠를 배포합니다.kubectl apply -f <URI path to mysql-deployment.yml file> -n <your-user-namespace>배포의 샘플 출력은 다음과 같습니다.
C:\Users\user>kubectl apply -f "C:\stateful-application\mysql-deployment.yml" -n userns1 service/mysql created deployment.apps/mysql created C:\Users\user>사용자에 대한 정보를 표시합니다.
kubectl describe deployment <app-label> -n <your-user-namespace>C:\Users\user>kubectl describe deployment mysql -n userns1 Name: mysql Namespace: userns1 CreationTimestamp: Thu, 20 Aug 2020 11:14:25 -0700 Labels: <none> Annotations: deployment.kubernetes.io/revision: 1 kubectl.kubernetes.io/last-applied-configuration: {"apiVersion":"apps/v1","kind":"Deployment","metadata":{"annotations":{},"name":"mysql","namespace":"userns1"},"spec":{"selector":{"matchL... Selector: app=mysql Replicas: 1 desired | 1 updated | 1 total | 1 available | 0 unavailable StrategyType: Recreate MinReadySeconds: 0 Pod Template: Labels: app=mysql Containers: mysql: Image: mysql:5.6 Port: 3306/TCP Host Port: 0/TCP Environment: MYSQL_ROOT_PASSWORD: password Mounts: /var/lib/mysql from mysql-persistent-storage (rw) Volumes: mysql-persistent-storage: Type: PersistentVolumeClaim (a reference to a PersistentVolumeClaim in the same namespace) ClaimName: mysql-pv-claim-sc ReadOnly: false Conditions: Type Status Reason ---- ------ ------ Available True MinimumReplicasAvailable Progressing True NewReplicaSetAvailable OldReplicaSets: <none> NewReplicaSet: mysql-695c4d9dcd (1/1 replicas created) Events: Type Reason Age From Message ---- ------ ---- ---- ------- Normal ScalingReplicaSet 24s deployment-controller Scaled up replica set mysql-695c4d9dcd to 1 C:\Users\user>배포에 의해 생성된 Pod를 나열합니다.
kubectl get pods -l <app=label> -n <your-user-namespace>샘플 출력은 다음과 같습니다.
C:\Users\user>kubectl get pods -l app=mysql -n userns1 NAME READY STATUS RESTARTS AGE mysql-695c4d9dcd-rvzff 1/1 Running 0 40s C:\Users\user>PersistentVolumeClaim을 조사합니다.
kubectl describe pvc <your-pvc-name>샘플 출력은 다음과 같습니다.
C:\Users\user>kubectl describe pvc mysql-pv-claim-sc -n userns1 Name: mysql-pv-claim-sc Namespace: userns1 StorageClass: ase-node-local Status: Bound Volume: pvc-dc48253c-82dc-42a4-a7c6-aaddc97c9b8a Labels: <none> Annotations: kubectl.kubernetes.io/last-applied-configuration: {"apiVersion":"v1","kind":"PersistentVolumeClaim","metadata":{"annotations":{},"name":"mysql-pv-claim-sc","namespace":"userns1"},"spec":{"... pv.kubernetes.io/bind-completed: yes pv.kubernetes.io/bound-by-controller: yes volume.beta.kubernetes.io/storage-provisioner: rancher.io/local-path volume.kubernetes.io/selected-node: k8s-3q7lhq2cl-3q7lhq2 Finalizers: [kubernetes.io/pvc-protection] Capacity: 20Gi Access Modes: RWO VolumeMode: Filesystem Mounted By: mysql-695c4d9dcd-rvzff Events: Type Reason Age From Message ---- ------ ---- ---- ------- Normal WaitForFirstConsumer 71s (x2 over 77s) persistentvolume-controller waiting for first consumer to be created before binding Normal ExternalProvisioning 62s persistentvolume-controller waiting for a volume to be created, either by external provisioner "rancher.io/local-path" or manually created by system administrator Normal Provisioning 62s rancher.io/local-path_local-path-provisioner-6b84988bf9-tx8mz_1896d824-f862-4cbf-912a-c8cc0ca05574 External provisioner is provisioning volume for claim "userns1/mysql-pv-claim-sc" Normal ProvisioningSucceeded 60s rancher.io/local-path_local-path-provisioner-6b84988bf9-tx8mz_1896d824-f862-4cbf-912a-c8cc0ca05574 Successfully provisioned volume pvc-dc48253c-82dc-42a4-a7c6-aaddc97c9b8a C:\Users\user>
MySQL이 실행 중인지 확인
애플리케이션이 실행 중인지 확인하려면 다음을 입력합니다.
kubectl exec <your-pod-with-the-app> -i -t -n <your-namespace> -- mysql -p
메시지가 표시되면 암호를 입력합니다. 암호는 mysql-deployment 파일에 있습니다.
샘플 출력은 다음과 같습니다.
C:\Users\user>kubectl exec mysql-695c4d9dcd-rvzff -i -t -n userns1 -- mysql -p
Enter password:
Welcome to the MySQL monitor. Commands end with ; or \g.
Your MySQL connection id is 3
Server version: 5.6.49 MySQL Community Server (GPL)
Copyright (c) 2000, 2020, Oracle and/or its affiliates. All rights reserved.
Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective
owners.
Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
mysql>
배포 삭제
배포를 삭제하려면 배포된 개체를 이름으로 삭제합니다. 이러한 개체에는 배포, 서비스 및 PVC가 포함됩니다.
kubectl delete deployment <deployment-name>,svc <service-name> -n <your-namespace>
kubectl delete pvc <your-pvc-name> -n <your-namespace>
배포 및 서비스를 삭제하는 경우의 샘플 출력은 다음과 같습니다.
C:\Users\user>kubectl delete deployment,svc mysql -n userns1
deployment.apps "mysql" deleted
service "mysql" deleted
C:\Users\user>
다음은 PVC를 삭제할 때의 샘플 출력입니다.
C:\Users\user>kubectl delete pvc mysql-pv-claim-sc -n userns1
persistentvolumeclaim "mysql-pv-claim-sc" deleted
C:\Users\user>
다음 단계
kubectl을 통해 네트워킹을 구성하는 방법을 이해하려면 Azure Stack Edge Pro 디바이스에 상태 비저장 애플리케이션 배포를 참조하세요.