배치 작성

PVC 및 배치 구성 파일을 작성한 후 클러스터에서 배치를 작성하십시오.

1. 배치를 작성하십시오.

   oc apply -f <local_yaml_path>
   

2. PV가 성공적으로 마운트되었는지 확인하십시오.

   oc describe deployment <deployment_name>
   

   마운트 지점은 Volume Mounts 필드에 있고 볼륨은 Volumes 필드에 있습니다.

   Volume Mounts:
         /var/run/secrets/kubernetes.io/serviceaccount from default-token-tqp61 (ro)
         /volumemount from myvol (rw)
   ...
   Volumes:
       myvol:
       Type:    PersistentVolumeClaim (a reference to a PersistentVolumeClaim in the same namespace)
       ClaimName:    mypvc
       ReadOnly:    false
   

3. 앱 팟(pod)에 로그인하고 데이터를 작성하여 IBM Cloud Object Storage 서비스 인스턴스에 데이터를 쓸 수 있는지 확인하십시오. PV를 마운트하는 팟(Pod)에 로그인하십시오.

   oc exec <pod_name> -it bash
   

4. 앱 배치에서 정의한 볼륨 마운트 경로로 이동하십시오.

5. 텍스트 파일을 작성하십시오.

   echo "This is a test" > test.txt
   

6. IBM Cloud 콘솔에서 IBM Cloud Object Storage 서비스 인스턴스로 이동합니다.

7. 메뉴에서 버킷을 선택하십시오.

8. 버킷을 열고 작성된 test.txt가 나타나는지 확인하십시오.

Stateful 세트에서의 오브젝트 스토리지 사용

데이터베이스와 같은 stateful 앱이 있는 경우에는 앱의 데이터를 저장하기 위해 IBM Cloud Object Storage를 사용하는 Stateful 세트를 작성할 수 있습니다. 또는, IBM Cloud와 같은 IBM Cloudant DBaaS(Database-as-a-Service)를 사용하여 데이터를 클라우드에 저장할 수 있습니다.

시작하기 전에, 이 항목의 시작 부분에 있는 필수 단계를 완료하십시오.

오브젝트 스토리지를 사용하는 Stateful 세트를 배치하려면 다음을 수행하십시오.

1. Stateful 세트에 대한 구성 파일과 이 Stateful 세트를 노출하는 데 사용하는 서비스를 작성하십시오. 다음 예는 NGINX를 세 개의 복제본을 포함하는 Stateful 세트(동일한 버킷을 공유하거나 별도의 버킷이 있는 각 복제본)로 배치하는 방법을 보여줍니다.

   각각 별도의 버킷을 사용하는 세 개의 복제본이 있는 상태 저장 세트를 작성하는 예.

   apiVersion: v1
   kind: Service
   metadata:
     name: nginx-v01
     namespace: default
     labels:
       app: nginx-v01 # must match spec.template.metadata.labels and spec.selector.matchLabels in stateful set YAML
   spec:
     ports:
     - port: 80
       name: web
     clusterIP: None
     selector:
       app: nginx-v01 # must match spec.template.metadata.labels and spec.selector.matchLabels in stateful set YAML
   ---
   apiVersion: apps/v1
   kind: StatefulSet
   metadata:
     name: web-v01
     namespace: default
   spec:
     selector:
       matchLabels:
         app: nginx-v01 # must match spec.template.metadata.labels in stateful set YAML and metadata.labels in service YAML
     serviceName: "nginx-v01"
     replicas: 3
     template:
       metadata:
         labels:
           app: nginx-v01 # must match spec.selector.matchLabels in stateful set YAML and metadata.labels in service YAML
       spec:
         terminationGracePeriodSeconds: 10
         containers:
         - name: nginx
           image: registry.k8s.io/nginx-slim:0.8
           ports:
           - containerPort: 80
             name: web
           volumeMounts:
           - name: mypvc
             mountPath: /usr/share/nginx/html
     volumeClaimTemplates:
     - metadata:
         name: mypvc
         annotations:
           ibm.io/auto-create-bucket: "true"
           ibm.io/auto-delete-bucket: "true"
           ibm.io/bucket: ""
           ibm.io/secret-name: mysecret
           volume.beta.kubernetes.io/storage-class: ibmc-s3fs-standard-perf-cross-region
           volume.beta.kubernetes.io/storage-provisioner: ibm.io/ibmc-s3fs
       spec:
         accessModes: [ "ReadWriteOnce" ]
         storageClassName: "ibmc-s3fs-standard-perf-cross-region"
         resources:
           requests:
             storage: 1Gi
   

   동일한 버킷 mybucket을 공유하는 세 개의 복제본이 있는 상태 저장 세트를 작성하는 예.

   apiVersion: v1
   kind: Service
   metadata:
     name: nginx-v01
     namespace: default
     labels:
       app: nginx-v01 # must match spec.template.metadata.labels and spec.selector.matchLabels in stateful set YAML
   spec:
     ports:
     - port: 80
       name: web
     clusterIP: None
     selector:
       app: nginx-v01 # must match spec.template.metadata.labels and spec.selector.matchLabels in stateful set YAML
   ---
   apiVersion: apps/v1
   kind: StatefulSet
   metadata:
     name: web-v01
     namespace: default
   spec:
     selector:
       matchLabels:
         app: nginx-v01 # must match spec.template.metadata.labels in stateful set YAML and metadata.labels in service YAML
     serviceName: "nginx-v01"
     replicas: 3
     template:
       metadata:
         labels:
           app: nginx-v01 # must match spec.selector.matchLabels in stateful set YAML and metadata.labels in service YAML
       spec:
         terminationGracePeriodSeconds: 10
         containers:
         - name: nginx
           image: registry.k8s.io/nginx-slim:0.8
           ports:
           - containerPort: 80
             name: web
           volumeMounts:
           - name: mypvc
             mountPath: /usr/share/nginx/html
     volumeClaimTemplates:
     - metadata:
         name: mypvc
         annotations:
           ibm.io/auto-create-bucket: "false"
           ibm.io/auto-delete-bucket: "false"
           ibm.io/bucket: mybucket
           ibm.io/secret-name: mysecret
           volume.beta.kubernetes.io/storage-class: ibmc-s3fs-standard-perf-cross-region
           volume.beta.kubernetes.io/storage-provisioner: ibm.io/ibmc-s3fs
       spec:
         accessModes: [ "ReadOnlyMany" ]
         storageClassName: "ibmc-s3fs-standard-perf-cross-region"
         resources:
           requests:
             storage: 1Gi
   

name

Stateful 세트의 이름을 입력하십시오. 입력하는 이름은 <volume_name>-< statefulset_name>-<replica_number> 형식으로 PVC의 이름을 작성하는 데 사용됩니다.

serviceName

Stateful 세트를 노출하는 데 사용할 서비스의 이름을 입력하십시오.

replicas

Stateful 세트의 복제본 수를 입력하십시오.

matchLabels

spec selector matchLabels 섹션에서, Stateful 세트 및 PVC에 포함시킬 모든 레이블을 입력하십시오. Stateful 세트의 volumeClaimTemplates에 포함하는 레이블은 Kubernetes가 인식하지 않습니다. 대신 Stateful 세트 YAML의 spec.selector.matchLabels 및 spec.template.metadata.labels 섹션에서 이러한 레이블을 정의해야 합니다. 서비스의 로드 밸런싱에 모든 Stateful 세트 복제본이 포함되도록 하려면 서비스 YAML의 spec.selector 섹션에서 사용한 것과 동일한 레이블을 포함하십시오.

labels

스펙 메타데이터 레이블 섹션에 Stateful 세트 YAML의 spec.selector.matchLabels 섹션에 추가한 동일한 레이블을 입력하십시오.

terminationGracePeriodSeconds

kubelet 가 스테이트풀 세트 복제본을 실행하는 포드를 안전하게 종료할 수 있도록 허용할 시간(초)을 입력하세요. 자세한 정보는 팟(Pod)삭제를 참조하십시오.

VolumeClaimTemplates.name

spec volumeClaimTemplates metadata 섹션에서, 볼륨의 이름을 입력하십시오. spec.containers.volumeMount.name 섹션에 정의한 것과 동일한 이름을 사용하십시오. 여기에 입력하는 이름은 <volume_name>-<statefulset_name>-<replica_number> 형식으로 PVC의 이름을 작성하는 데 사용됩니다.

ibm.io/auto-create-bucket

spec volumeClaimTemplates metadata 섹션에서, 버킷이 작성되는 방식을 구성하는 어노테이션을 설정하십시오. 다음 선택사항 중 하나를 선택하십시오.

• **true: **각 Stateful 세트 복제본에 대해 자동으로 버킷을 작성하려면 이 옵션을 선택하십시오. 버킷을 자동으로 작성하려면 서비스 인증 정보에 작성자 권한이 있어야 합니다.
• **false: **전체 Stateful 세트 복제본이 기존 버킷을 공유하도록 하려면 이 옵션을 선택하십시오. Stateful 세트 YAML의 spec.volumeClaimTemplates.metadata.annotions.ibm.io/bucket 섹션에 버킷의 이름을 반드시 정의해야 합니다.

ibm.io/auto-delete-bucket

spec volumeClaimTemplates metadata 섹션에서, 버킷이 삭제되는 방식을 구성하는 어노테이션을 설정하십시오. 다음 선택사항 중 하나를 선택하십시오.

• **true: **PVC를 삭제할 때 데이터, 버킷 및 PV가 자동으로 제거됩니다. IBM Cloud Object Storage 서비스 인스턴스는 그대로 유지되며 삭제되지 않습니다. 이 옵션을 true로 설정하도록 선택한 경우에는 ibm.io/auto-create-bucket: true 형식의 이름으로 버킷이 자동 작성되도록 ibm.io/bucket: "" 및 tmp-s3fs-xxxx을 설정해야 합니다.
• **false: **PVC를 삭제하면 PV는 자동으로 삭제되지만 IBM Cloud Object Storage 서비스 인스턴스의 데이터와 버킷은 그대로 유지됩니다. 데이터에 액세스하려면 기존 버킷의 이름으로 새 PVC를 작성해야 합니다.

ibm.io/bucket

spec volumeClaimTemplates metadata 섹션에서, 버킷 세부사항에 대한 어노테이션을 설정하십시오. 다음 선택사항 중 하나를 선택하십시오.

• ibm.io/auto-create-bucket이 true로 설정된 경우: IBM Cloud Object Storage에서 작성한 버킷의 이름을 입력하십시오. 또한 ibm.io/auto-delete-bucket이 true로 설정된 경우, 사용자는 버킷에 tmp-s3fs-xxxx 형식의 이름을 자동으로 지정할 수 있도록 이 필드를 공백 상태로 두어야 합니다. 이름은 IBM Cloud Object Storage에서 고유해야 합니다.
• ibm.io/auto-create-bucket이 false로 설정된 경우: 클러스터에서 액세스할 기존 버킷의 이름을 입력하십시오.

ibm.io/secret-name

spec volumeClaimTemplates metadata annotations 섹션에서, 이전에 작성한 IBM Cloud Object Storage 인증 정보를 포함하는 시크릿의 이름을 입력하십시오. IBM Cloud Object Storage 인증 정보를 기본 스토리지 클래스에 추가하는 경우에는 PVC에서 시크릿을 나열해서는 안됩니다.

kubernetes.io/storage-class

spec volumeClaimTemplates metadata annotations 섹션에서, 사용할 스토리지 클래스를 입력하십시오. 다음 선택사항 중 하나를 선택하십시오.

• ibm.io/auto-create-bucket: "true"인 경우: 새 버킷에 사용할 스토리지 클래스를 입력하십시오.
• ibm.io/auto-create-bucket: "false"인 경우: 기존 버킷을 작성하는 데 사용한 스토리지 클래스를 입력하십시오.

기존 스토리지 클래스를 나열하려면 oc get sc | grep s3을 실행하십시오. 스토리지 클래스를 지정하지 않으면 클러스터에 설정된 기본 스토리지 클래스를 사용하여 PVC가 작성됩니다. Stateful 세트가 오브젝트 스토리지를 사용하여 프로비저닝되도록 기본 스토리지 클래스가 ibm.io/ibmc-s3fs 프로비저너를 사용하는지 확인하십시오.

storageClassName

스펙 볼륨 청구 템플리트의 스펙 섹션에 Stateful 세트 YAML의 spec.volumeClaimTemplates.metadata.annotations.volume.beta.kubernetes.io/storage-class 섹션에 입력한 동일한 스토리지 클래스를 입력하십시오.

storage

spec volumeClaimTemplates spec resources requests 섹션에서, IBM Cloud Object Storage 버킷의 가상 크기를 기가바이트 단위로 입력하십시오. Kubernetes에서는 이 크기가 필요하지만, IBM Cloud Object Storage에서는 무시됩니다. 원하는 크기를 입력할 수 있습니다. IBM Cloud Object Storage 에서 실제로 사용하는 공간은 다를 수 있으며, 가격표 에 따라 요금이 청구됩니다.