버킷 생성 및 제거에 대한 이해

• PVC에 버킷 이름을 지정하여 기존 버킷을 사용할 수 있습니다.
• 버킷 이름을 입력했는데 해당 버킷이 존재하지 않으면 해당 이름의 버킷이 만들어집니다.
• 버킷 이름을 지정하지 않으면, 마운터 유형에 따라 s3fs-<timestamp>-xxx 또는 rclone-<timestamp>-xxx 형식의 버킷이 생성됩니다.
• 버킷은 스토리지 클래스에 정의된 회수 정책에 따라 삭제됩니다.
  • reclaimPolicy: Delete 설정하면 PVC가 삭제될 때 버킷이 삭제됩니다.
  • reclaimPolicy: Retain 설정하면 PVC가 삭제된 후에도 버킷이 유지됩니다.

노드 서버 포드 스케줄링 제한

기본적으로 COS CSI 드라이버 노드 서버 파드는 클러스터 내의 모든 노드에 스케줄링됩니다. restrictNodeServerScheduling 매개변수를 사용하면 노드 서버 포드의 스케줄링을 cos.csi.ibm.io/csi-node=true 레이블이 지정된 노드로만 제한할 수 있습니다.

restrictNodeServerScheduling 는 애드온을 활성화할 때 구성할 수 있으며, 나중에 ConfigMap 파일을 수정하여 업데이트할 수도 있습니다.

• 애드온을 활성화할 때 restrictNodeServerScheduling 를 설정하려면, 활성화 명령어에 --param 플래그를 포함시키십시오.

  ibmcloud oc cluster addon enable ibm-object-csi-driver --cluster CLUSTER --param "restrictNodeServerScheduling=true"
  

• 애드온이 이미 활성화된 상태에서 restrictNodeServerScheduling 을 업데이트하려면 다음 단계를 따르세요.

1. 클러스터에 있는 노드를 나열하고, COS 드라이버 포드를 실행할 위치를 결정하십시오.

   oc get nodes
   

   출력 예

   NAME            STATUS   ROLES    AGE    VERSION
   10.241.0.11     Ready    <none>   5d2h   v1.35.5+IKS
   10.241.0.12     Ready    <none>   5d2h   v1.35.5+IKS
   10.241.0.13     Ready    <none>   5d2h   v1.35.5+IKS
   10.241.128.10   Ready    <none>   5d2h   v1.35.5+IKS
   10.241.128.11   Ready    <none>   5d2h   v1.35.5+IKS
   10.241.128.9    Ready    <none>   5d2h   v1.35.5+IKS
   10.241.65.12    Ready    <none>   5d2h   v1.35.5+IKS
   10.241.65.13    Ready    <none>   5d2h   v1.35.5+IKS
   10.241.65.14    Ready    <none>   5d2h   v1.35.5+IKS
   

2. 모든 노드에서 노드 서버 포드가 현재 실행 중인지 확인하십시오.

   oc get pods -n ibm-object-csi-operator -l app.kubernetes.io/component=node -o wide
   

   출력 예

   NAME                        READY   STATUS    RESTARTS   AGE    IP              NODE            NOMINATED NODE   READINESS GATES
   ibm-object-csi-node-2pj2j   3/3     Running   0          145m   172.17.14.10    10.241.0.12     <none>           <none>
   ibm-object-csi-node-7bhwh   3/3     Running   0          145m   172.17.1.72     10.241.65.12    <none>           <none>
   ibm-object-csi-node-7l9hc   3/3     Running   0          145m   172.17.17.6     10.241.128.9    <none>           <none>
   ibm-object-csi-node-cxzt7   3/3     Running   0          145m   172.17.39.72    10.241.0.11     <none>           <none>
   ibm-object-csi-node-dw6qs   3/3     Running   0          145m   172.17.46.77    10.241.128.10   <none>           <none>
   ibm-object-csi-node-rpcvr   3/3     Running   0          145m   172.17.32.198   10.241.65.13    <none>           <none>
   ibm-object-csi-node-swqtg   3/3     Running   0          145m   172.17.16.69    10.241.0.13     <none>           <none>
   ibm-object-csi-node-sxbbs   3/3     Running   0          145m   172.17.26.7     10.241.65.14    <none>           <none>
   ibm-object-csi-node-xm8bt   3/3     Running   0          145m   172.17.20.200   10.241.128.11   <none>           <none>
   

3. 노드서버 파드가 스케줄링되기를 원하는 노드에 레이블을 지정하세요.

   oc label nodes NODE-NAME-1 NODE-NAME-2 cos.csi.ibm.io/csi-node=true
   

   출력 예

   node/10.241.0.11 labeled
   node/10.241.0.12 labeled
   

4. ConfigMap 를 업데이트하여 제한 기능을 활성화하십시오.

   oc patch cm managed-addon-ibm-object-csi-driver -n kube-system \
     --type merge -p '{"data":{"restrictNodeServerScheduling":"true"}}'
   

   출력 예

   configmap/managed-addon-ibm-object-csi-driver patched
   

5. 노드 서버 파드가 라벨이 지정된 노드에만 스케줄링되는지 확인하십시오.

   oc get pods -n ibm-object-csi-operator -l app.kubernetes.io/component=node -o wide
   

   출력 예

   NAME                        READY   STATUS    RESTARTS   AGE    IP             NODE           NOMINATED NODE   READINESS GATES
   ibm-object-csi-node-cxzt7   3/3     Running   0          145m   172.17.39.72   10.241.0.11    <none>           <none>
   ibm-object-csi-node-7bhwh   3/3     Running   0          145m   172.17.1.72    10.241.65.12   <none>           <none>
   

노드별 최대 볼륨 수 설정

기본적으로 COS CSI 드라이버는 단일 노드에 마운트할 수 있는 볼륨의 수를 제한하지 않습니다. maxVolumesPerNode 매개변수를 사용하여 노드당 볼륨의 최대 개수를 설정할 수 있습니다.

maxVolumesPerNode 는 애드온을 활성화할 때 구성할 수 있으며, 나중에 ConfigMap 파일을 수정하여 업데이트할 수도 있습니다.

• 애드온을 활성화할 때 maxVolumesPerNode 를 설정하려면, 활성화 명령어에 --param 플래그를 포함시키십시오.

  ibmcloud oc cluster addon enable ibm-object-csi-driver --cluster CLUSTER --param "maxVolumesPerNode=VALUE"
  

• 애드온이 이미 활성화된 상태에서 maxVolumesPerNode 을 업데이트하려면, 관리형 애드온 ConfigMap 에 패치를 적용하십시오.

  oc patch cm managed-addon-ibm-object-csi-driver -n kube-system --type merge -p '{"data":{"maxVolumesPerNode":"VALUE"}}'
  

  출력 예

  configmap/managed-addon-ibm-object-csi-driver patched
  

다음 기능을 사용하는 앱을 배포하려면 IBM Cloud Object Storage

cos.csi.driver/secret: "<custom-secret>"

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: cos-secret-1 # Give your PVC the same name as the secret you created in the previous step.
  namespace: <namespace> # The namespace where you want to create the PVC.
spec:
  accessModes:
  - ReadWriteMany
  resources:
    requests:
      storage: 10Gi
  storageClassName: <storage_class_name> # The storage class you want to use.

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: cos-csi-pvc1
  namespace: <namespace> # The namespace where you want to create the PVC.
  annotations:
    cos.csi.driver/secret: "<custom-secret>"
spec:
  accessModes:
  - ReadWriteOnce
  resources:
    requests:
      storage: 256Mi
  storageClassName: <storage_class_name> # The storage class you want to use.

IBM Cloud Object Storage 애드온 비활성화하기

기존 비밀, PVC 및 배포는 애드온을 비활성화하거나 패치를 업데이트해도 삭제되지 않습니다. 기존 고객 워크로드에는 중단이 없습니다.

1. 다음 명령을 실행하여 애드온을 비활성화하십시오.

    ibmcloud oc cluster addon disable ibm-object-csi-driver --cluster CLUSTER
   

   출력 예

   Data and resources that you created for the add-on might be deleted when the add-on is disabled. Continue? [y/N]> y
   Disabling add-on ibm-object-csi-driver for cluster XXX...
   OK
   

2. 애드온이 제거되었는지 확인하십시오.

   ibmcloud oc cluster addon ls --cluster CLUSTER
   

Helm 플러그인에서 클러스터 애드온으로 마이그레이션하기

1. Red Hat OpenShift 클러스터에 액세스하십시오.

2. PVC의 세부 정보를 확인하고 마이그레이션할 PVC를 선택합니다.

   oc get pvc --all-namespaces -o custom-columns='NAMESPACE:.metadata.namespace,NAME:.metadata.name' | tail -n +2 | while read namespace pvc; do kubectl describe pvc "$pvc" -n "$namespace" | grep 'volume.kubernetes.io/storage-provisioner: ibm.io/ibmc-s3fs' > /dev/null ; if [ $? -eq 0 ]; then echo "PVC: $pvc in Namespace: $namespace uses ibm.io/ibmc-s3fs storage provisioner"; fi; done
   

   출력 예

   PVC: pvc-test in Namespace: default uses ibm.io/ibmc-s3fs storage provisioner
   

3. PVC를 설명하고 버킷 이름을 가져옵니다.

   oc describe pvc <pvc_name> | grep ibm.io/bucket:
   

   출력 예

   ibm.io/bucket: test-s3
   

4. 버킷 이름을 포함하여 비밀을 다시 생성하세요.

   apiVersion: v1
   kind: Secret
   type: cos-s3-csi-driver
   metadata:
       name: cos-secret-1 # Name your secret.
       namespace: <namespace> # Specify the namespace where you want to create the secret.
   data:
       accessKey: <base64-encoded-HMAC-access-key>
       secretKey: <base64-encoded-HMAC-secret-key>
   stringData:
       bucketName: <bucket-name>
       mountOptions: |
           # uid=3000  # Optional: Run as non-root user. Must match runAsUser in SecurityContext of pod spec.
           key1=value1
           key2=value2
   

5. PVC에 사용된 스토리지 클래스를 찾습니다.

   oc describe pvc <pvc_name> | grep StorageClass:
   

   test-s3 PVC에 대한 명령 예제입니다.

   oc describe pvc test-s3 | grep StorageClass:
   

   출력 예

   StorageClass:  ibmc-s3fs-smart-perf-regional
   

6. 추가 기능에서 사용할 수 있는 새로운 스토리지 클래스를 검토하고 대체 클래스를 선택합니다.

   • flex 클래스를 사용했다면 새로운 smart 클래스 중 하나를 선택하세요.
   • standard 클래스를 사용했다면 새로운 standard 클래스 중 하나를 선택하세요.
   • 추가 기능에서는 cold 및 vault 클래스를 더 이상 사용할 수 없으므로 대신 smart 또는 standard 클래스를 선택하세요.

7. PVC의 세부 정보를 검토합니다.

   oc describe pvc test-s3
   

   출력 예

   Name:          pvc-test
   Namespace:     default
   StorageClass:  ibmc-s3fs-smart-perf-regional
   Status:        Bound
   Volume:        pvc-c625474d-31f0-4929-bc3e-feace1fb42fb
   Labels:        <none>
   Annotations:   ibm.io/auto-create-bucket: true
               ibm.io/auto-delete-bucket: true
               ibm.io/bucket: bha-test-s23
               ibm.io/secret-name: satstoragesecret
               pv.kubernetes.io/bind-completed: yes
               pv.kubernetes.io/bound-by-controller: yes
               volume.kubernetes.io/storage-provisioner: ibm.io/ibmc-s3fs
   Finalizers:    [kubernetes.io/pvc-protection]
   Capacity:      3Gi
   Access Modes:  RWO
   VolumeMode:    Filesystem
   Used By:       test-pod
   Events:        <none>
   

8. 새 스토리지 클래스를 사용하고 이전에 만든 비밀을 참조하는 대체 PVC를 만듭니다.

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
   name: cos-csi-pvc1
   namespace: <namespace> # The namespace where you want to create the PVC.
   annotations:
       cos.csi.driver/secret: "cos-secret-1"  # Secret created in step 4
   spec:
   accessModes:
   - ReadWriteOnce
   resources:
       requests:
       storage: 256Mi
   storageClassName: <storage_class_name> # The storage class you picked based on old storage class mapping.
   

9. PVC가 Bound 확인합니다.

   oc get pvc
   

10. 앱에 대한 자세한 정보를 확인하세요.

    oc get pods
    

11. 앱 규모를 0으로 축소합니다.

    kubectl scale deployment --replicas=0 my-app
    

12. 이전 단계에서 만든 PVC를 참조하는 대체 배포를 만듭니다.

13. 새 배포가 실행되고 나면 이전 배포를 삭제할 수 있습니다.

14. 마이그레이션하려는 각 PVC에 대해 이 단계를 반복하십시오.

IBM Cloud Object Storage 클러스터 애드온 스토리지 클래스

IBM Cloud Object Storage 클러스터 애드온은 s3fs 및 rclone 마운터를 위한 스토리지 클래스를 제공합니다. 데이터 액세스 요구사항에 맞는 스토리지 클래스를 선택하십시오. 스토리지 클래스는 워크로드에 대해 생성된 버킷의 버킷 클래스, 회수 정책 및 기본 마운트 동작을 결정합니다.

Standard

자주 액세스되는 핫 데이터에 사용하십시오. 공통 유스 케이스는 웹 또는 모바일 앱입니다.

Vault

한 달에 한 번 이하로 접근하는 등, 사용 빈도가 낮은 워크로드나 중요도가 낮은 데이터에 사용하십시오. 공통 유스 케이스는 아카이브, 단기 데이터 보관, 디지털 자산 보존, 테이프 교체 및 재해 복구입니다.

Cold

접근 빈도가 매우 낮은(90일에 한 번 이하) 콜드 데이터나 비활성 데이터에 사용하십시오. 공통 유스 케이스는 아카이브, 장기 백업, 준수용으로 보관되는 히스토리 데이터 또는 거의 액세스되지 않는 워크로드와 앱입니다.

스마트

특정 사용 패턴을 따르지 않거나 사용 패턴을 예측하기 어려운 워크로드 및 데이터에 사용합니다.

버킷에 저장된 데이터의 복원성 레벨을 결정하십시오. 자세한 정보는 지역 및 엔드포인트를 참조하십시오.

교차 지역

최고의 가용성을 보장하기 위해 귀하의 데이터는 특정 지리적 위치 내 세 개의 리전에 걸쳐 저장됩니다. 지역 간에 분산된 워크로드가 있으면 최인접 지역 엔드포인트로 요청이 라우트됩니다. 지리적 위치에 대한 IBM Cloud Object Storage 엔드포인트는 클러스터가 위치한 곳을 기준으로 자동으로 설정됩니다. 예를 들어, 클러스터가 US South 에 있는 경우, 스토리지 클래스는 버킷에 대해 US GEO 엔드포인트를 사용하도록 구성됩니다. 이름에 ‘ cross-region ’가 포함된 스토리지 클래스를 선택하십시오.

지역

귀하의 데이터는 하나의 리전 내 여러 존에 걸쳐 복제됩니다. 동일한 지역에 있는 워크로드가 있는 경우에는 교차 지역 설정보다 낮은 대기 시간과 더 높은 성능이 나타납니다. 지역별 종단점은 클러스터가 위치한 위치를 기준으로 자동으로 설정됩니다. 예를 들어, 클러스터가 US South 에 있는 경우, 스토리지 클래스는 버킷의 지역 엔드포인트로 US South 을 사용하도록 구성됩니다. 이름에 ‘ cross-region ’가 포함되지 않은 스토리지 클래스를 선택하십시오.

스토리지 클래스에 대한 자세한 버킷 구성을 검토하려면 oc describe storageclass <storageclass_name> 또는 oc describe storageclass <storageclass_name> 을 실행하세요.