6.6. 볼륨 팝업기

프로세스

1. 다음 예제 YAML 파일을 사용하여 팝업기 및 관련 리소스의 논리 그룹화 및 작업에 대한 네임스페이스를 생성합니다.

   네임스페이스 YAML 파일의 예

   apiVersion: v1
   kind: Namespace
   metadata:
     name: hello

2. 다음 예제 YAML 파일을 사용하여 데이터 소스에 대한 CRD를 생성합니다.

   CRD YAML 파일의 예

   apiVersion: apiextensions.k8s.io/v1
   kind: CustomResourceDefinition
   metadata:
     name: hellos.hello.example.com
   spec:
     group: hello.example.com
     names:
       kind: Hello
       listKind: HelloList
       plural: hellos
       singular: hello
     scope: Namespaced
     versions:
     - name: v1alpha1
       schema:
         openAPIV3Schema:
           description: Hello is a specification for a Hello resource
           properties:
             apiVersion:
               description: 'APIVersion defines the versioned schema of this representation
                 of an object. Servers should convert recognized schemas to the latest
                 internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources'
               type: string
             kind:
               description: 'Kind is a string value representing the REST resource this
                 object represents. Servers may infer this from the endpoint the client
                 submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds'
               type: string
             spec:
               description: HelloSpec is the spec for a Hello resource
               properties:
                 fileContents:
                   type: string
                 fileName:
                   type: string
               required:
               - fileContents
               - fileName
               type: object
           required:
           - spec
           type: object
       served: true
       storage: true

3. ServiceAccount, ClusterRole ,ClusterRole Bindering, Deployment 를 생성하여 컨트롤러를 배포하여 채우기를 구현하는 논리를 실행합니다.

   1. 다음 예제 YAML 파일을 사용하여 팝업기에 대한 서비스 계정을 생성합니다.

      서비스 계정 YAML 파일의 예

      apiVersion: v1
      kind: ServiceAccount
      metadata:
        name: hello-account
        namespace: hello 

      1

      1

      이전에 생성한 네임스페이스를 참조합니다.

   2. 다음 예제 YAML 파일을 사용하여 팝업기에 대한 클러스터 역할을 생성합니다.

      클러스터 역할 YAML 파일의 예

      kind: ClusterRole
      apiVersion: rbac.authorization.k8s.io/v1
      metadata:
        name: hello-role
      rules:
        - apiGroups: [hello.example.com]
          resources: [hellos]
          verbs: [get, list, watch]

   3. 다음 예제 YAML 파일을 사용하여 클러스터 역할 바인딩을 생성합니다.

      클러스터 역할 바인딩 YAML 파일의 예

      kind: ClusterRoleBinding
      apiVersion: rbac.authorization.k8s.io/v1
      metadata:
        name: hello-binding 

      1

      
      subjects:
        - kind: ServiceAccount
          name: hello-account 

      2

      
          namespace: hello 

      3

      
      roleRef:
        kind: ClusterRole
        name: hello-role 

      4

      
        apiGroup: rbac.authorization.k8s.io

      1

      역할 바인딩 이름입니다.

      2

      이전에 생성한 서비스 계정의 이름을 참조합니다.

      3

      이전에 생성한 서비스 계정의 네임스페이스 이름을 참조합니다.

      4

      이전에 생성한 클러스터 역할을 참조합니다.

   4. 다음 예제 YAML 파일을 사용하여 팝업기에 대한 배포를 생성합니다.

      배포 YAML 파일의 예

      kind: Deployment
      apiVersion: apps/v1
      metadata:
        name: hello-populator
        namespace: hello 

      1

      
      spec:
        selector:
          matchLabels:
            app: hello
        template:
          metadata:
            labels:
              app: hello
          spec:
            serviceAccount: hello-account 

      2

      
            containers:
              - name: hello
                image: registry.k8s.io/sig-storage/hello-populator:v1.0.1
                imagePullPolicy: IfNotPresent
                args:
                  - --mode=controller
                  - --image-name=registry.k8s.io/sig-storage/hello-populator:v1.0.1
                  - --http-endpoint=:8080
                ports:
                  - containerPort: 8080
                    name: http-endpoint
                    protocol: TCP

      1

      이전에 생성한 네임스페이스를 참조합니다.

      2

      이전에 생성한 서비스 계정을 참조합니다.

4. 다음 예제 YAML 파일을 사용하여 kind:Hello 리소스를 볼륨의 유효한 데이터 소스로 등록할 볼륨 채우기를 생성합니다.

   볼륨 채우기기 YAML 파일의 예

   kind: VolumePopulator
   apiVersion: populator.storage.k8s.io/v1beta1
   metadata:
     name: hello-populator 

   1

   
   sourceKind:
     group: hello.example.com
     kind: Hello

   1

   볼륨 팝업 이름.

   등록되지 않은 팝업을 사용하는 PVC는 "이 PVC의 데이터 소스가 알 수 없음(등록되지 않은) 팝업기를 사용하므로 PVC가 프로비저닝되지 않을 수 있음을 나타내는 등록된 VolumePopulator와 일치하지 않습니다.

프로세스

1. 다음 명령을 실행하여 fileContents 매개변수로 전달된 텍스트 " Hello, World!"를 사용하여 Hello CRD의 CR(사용자 정의 리소스) 인스턴스를 생성합니다.

   $ oc apply -f  - <<EOF
   apiVersion: hello.example.com/v1alpha1
   kind: Hello
   metadata:
     name: example-hello
   spec:
     fileName: example.txt
     fileContents: Hello, world!
   EOF

2. 다음 예제 파일과 유사한 Hello CR을 참조하는 PVC를 생성합니다.

   PVC YAML 파일의 예

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: example-pvc
   spec:
     accessModes:
     - ReadWriteOnce
     resources:
       requests:
         storage: 10Mi
     dataSourceRef: 

   1

   
       apiGroup: hello.example.com
       kind: Hello
       name: example-hello 

   2

   
     volumeMode: Filesystem

   1

   dataSourceRef 필드는 PVC의 데이터 소스를 지정합니다.

   2

   데이터 소스로 사용하는 CR의 이름입니다. 예에서는 'example-hello'입니다.

검증

1. 몇 분 후에 다음 명령을 실행하여 PVC가 생성되고 Bound 상태에서 있는지 확인합니다.

   $ oc get pvc example-pvc -n hello 

   1

   1

   이 예에서 PVC 이름은 example-pvc 입니다.

   출력 예

   NAME          STATUS    VOLUME        CAPACITY   ACCESS MODES   STORAGECLASS   VOLUMEATTRIBUTESCLASS   AGE
   example-pvc   Bound     my-pv         10Mi       ReadWriteOnce  gp3-csi        <unset>                 14s

2. PVC에서 읽는 작업을 생성하여 다음 예제 파일을 사용하여 데이터 소스 정보가 적용되었는지 확인합니다.

   작업 YAML 파일의 예

   apiVersion: batch/v1
   kind: Job
   metadata:
     name: example-job
   spec:
     template:
       spec:
         containers:
           - name: example-container
             image: busybox:latest
             command:
               - cat
               - /mnt/example.txt 

   1

   
             volumeMounts:
               - name: vol
                 mountPath: /mnt
         restartPolicy: Never
         volumes:
           - name: vol
             persistentVolumeClaim:
               claimName: example-pvc 

   2

   1

   "Hello, world!" 텍스트가 포함된 파일의 위치와 이름입니다.

   2

   2단계에서 생성한 PVC의 이름입니다. 예에서는 example-pvc.

3. 다음 명령을 실행하여 작업을 시작합니다.

   $ oc run example-job --image=busybox --command -- sleep 30 --restart=OnFailure

   출력 예

   pod/example-job created

4. 다음 명령을 실행하여 작업 및 모든 종속 항목이 완료될 때까지 기다립니다.

   $ oc wait --for=condition=Complete pod/example-job

5. 다음 명령을 실행하여 작업에서 수집한 콘텐츠를 확인합니다.

   $ oc logs job/example-job

   예상 출력

   Hello, world!

1. 섹션 볼륨 팝업기를 사용하여 미리 채워진 볼륨 생성.

2. 섹션 볼륨 팝업을 위한 CRD 생성.

   VolumePopulator 인스턴스를 제거해야 합니다.