ODF의 전제 조건

로컬 NVME 스토리지가 있는 베어 메탈 워커 노드

로컬 NVME 디스크가 포함된 d 접미사가 붙은 플레이버를 사용합니다.

워커 노드 요구 사항

고가용성 및 데이터 이중화를 위해 ODF에는 최소 3개의 작업자 노드가 필요합니다.

영역 구성

• OpenShift 가상화 배포: VM 워크로드의 스토리지 지연 시간을 최소화하려면 단일 영역 클러스터를 사용하는 것이 좋습니다. 다중 영역 배포는 더 나은 고가용성을 제공하지만, 영역 간 스토리지 복제는 VM 성능에 영향을 줄 수 있습니다.
• 일반 ODF 배포: 고가용성 및 재해 복구를 위해 최소 3개의 영역이 권장됩니다.

콘솔에서 ODF 설치하기

1. IBM Cloud 계정에 로그인하고 클러스터로 이동합니다.

2. 클러스터 탐색에서 추가 기능을 클릭합니다.

3. OpenShift Data Foundation 카드에서 ‘설치’를 클릭합니다.

4. 로컬 저장소 옵션을 선택합니다.

   VPC 베어 메탈 노드에는 원격 블록 볼륨 연결이 지원되지 않습니다.

5. 다음 탐색 방법 중 하나를 선택하세요:

   자동 검색(권장)

   베어 메탈 워커 노드에서 사용 가능한 디스크를 자동으로 검색하고 사용하려면 자동 검색을 선택합니다.

   수동 디스크 사양

   디스크를 수동으로 지정하려면 다음 단계를 따르세요:

   1. 각 워커 노드에 로그인하여 사용 가능한 디스크를 식별합니다.

      oc debug node/<node-name>
      

   2. 호스트 바이너리를 허용하십시오.

      chroot /host
      

   3. 사용 가능한 디바이스를 나열합니다.

      lsblk
      

   4. 각 디스크의 바이아이디를 찾습니다.

      ls -l /dev/disk/by-id/
      

   5. OSD 포드 디스크 ID 매개변수에 디스크 ID를 추가합니다.

6. 필요에 따라 추가 매개변수를 구성합니다:

   • 리소스 프로필: 워크로드에 따라 balanced 또는 performance 선택
   • 암호화: 필요한 경우 Hyper Protect Crypto Services 으로 암호화 사용
   • OSD 디스크 수입니다: 작업자 노드당 디스크 수를 지정합니다

7. 설치를 클릭하여 ODF를 배포합니다.

ODF 매개변수에 대한 자세한 내용은 OpenShift 데이터 재단 매개변수 참조를 참조 하세요.

CLI를 통해 ODF 설치하기

1. 사용 가능한 추가 기능 옵션을 확인해 보세요.

   ibmcloud oc cluster addon options --addon openshift-data-foundation --version 4.20.0
   

2. 자동 디스크 검색 및 가상화 지원 기능이 있는 OpenShift Data Foundation 애드온을 사용하도록 설정합니다.

   ibmcloud oc cluster addon enable openshift-data-foundation \
     -c <cluster-name> \
     --version 4.20.0 \
     --param "odfDeploy=true" \
     --param "osdStorageClassName=localblock" \
     --param "autoDiscoverDevices=true" \
     --param "resourceProfile=performance" \
     --param "setDefaultStorageClassForVirtualization=true"
   

3. 애드온의 상태가 ‘준비됨’인지 확인하십시오.

   oc get storagecluster -n openshift-storage
   

   출력 예:

   NAME                 AGE   PHASE   EXTERNAL   CREATED AT             VERSION
   ocs-storagecluster   53m   Ready              2025-03-10T12:20:52Z   4.20.0
   

ODF 설치 확인

1. 스토리지 클러스터 상태를 확인합니다.

   oc get storagecluster -n openshift-storage
   

2. 스토리지 클래스를 사용할 수 있는지 확인합니다.

   oc get storageclass | grep ocs
   

3. ODF 파드가 실행 중인지 확인합니다.

   oc get pods -n openshift-storage
   

ODF 배포에 대한 자세한 내용은 VPC 클러스터에 OpenShift Data Foundation 배포를 참조하세요.

VPC의 전제 조건 File Storage

• 지원되는 모든 베어 메탈 환경
• VPC 인프라

1단계: VPC의 기본 Block Storage 비활성화

1. VPC Block CSI 드라이버의 configmap을 편집합니다.

   oc edit cm addon-vpc-block-csi-driver-configmap -n kube-system
   

2. IsStorageClassDefault을(를) false(으)로 설정하십시오.

   data:
     IsStorageClassDefault: "false"
   

3. 편집기를 저장 후 종료하십시오.

2단계: VPC 파일 CSI 드라이버 설치

3단계: 기본 스토리지 클래스 설정

1. 사용 가능한 스토리지 클래스를 나열하십시오.

   oc get storageclass | grep vpc-file
   

2. 워크로드에 따라 적절한 스토리지 클래스를 선택하십시오:

   • ibmc-vpc-file-1000-iops: 중간 수준의 워크로드(40GB ~ 2,000 IOPS)
   • ibmc-vpc-file-6000-iops: 더 높은 워크로드(100GB ~ 6,000 IOPS)의 경우
   • ibmc-vpc-file-metro-1000-iops: 다중 구역 배포의 경우

3. VPC 파일 CSI 드라이버 구성 맵을 편집합니다.

   oc edit cm addon-vpc-file-csi-driver-configmap -n kube-system
   

4. ‘ SET_DEFAULT_STORAGE_CLASS ’ 필드를 원하는 스토리지 클래스로 설정하십시오.

   data:
     SET_DEFAULT_STORAGE_CLASS: "ibmc-vpc-file-metro-1000-iops"
   

5. 편집기를 저장 후 종료하십시오.

6. 변경 사항이 적용되도록 몇 분 정도 기다려 주세요.

7. 기본 스토리지 클래스를 확인하십시오.

   oc get storageclass | grep "(default)"
   

4단계: VPC용 스토리지 프로필 구성 File Storage

OpenShift Virtualization Operator를 설치한 후에는, Container Disk Importer(CDI)가 VPC File Storage 속성을 자동으로 인식하지 못하므로 VPC File Storage 에 대한 스토리지 프로필을 구성해야 합니다.

이 단계는 ‘ OpenShift Virtualization Operator’를 설치한 후에 수행해야 합니다.

for sp in $(oc get storageprofile.cdi.kubevirt.io -o json | jq -r '.items[] | select(.status.provisioner == "vpc.file.csi.ibm.io") | .metadata.name'); do
  oc patch storageprofile.cdi.kubevirt.io "$sp" --type=merge -p '{
    "spec": {
      "claimPropertySets": [
        {
          "accessModes": ["ReadWriteMany"],
          "volumeMode": "Filesystem"
        }
      ]
    }
  }'
done

VPC File Storage 설치 확인

1. VPC 파일 CSI 드라이버 포드가 실행 중인지 확인하십시오.

   oc get pods -n kube-system | grep vpc-file
   

2. 기본 스토리지 클래스가 올바르게 설정되어 있는지 확인하십시오.

   oc get storageclass | grep "(default)"
   

3. 테스트용 PVC를 생성하여 스토리지 프로비저닝을 테스트합니다.

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: test-pvc
   spec:
     accessModes:
     - ReadWriteMany
     resources:
       requests:
         storage: 10Gi
   

4. PVC가 제대로 고정되었는지 확인하십시오.

   oc get pvc test-pvc
   

5. 테스트용 PVC를 삭제하십시오.

   oc delete pvc test-pvc
   

ODF 설치 실패

ODF 설치에 실패하면 다음을 확인하세요:

• 베어 메탈 노드에 로컬 NVME 스토리지가 있는지 확인합니다
• 작업자 노드가 최소 3개 이상 있는지 확인하십시오
• 디스크가 마운트 해제되고 포맷되지 않았는지 확인합니다
• ODF 작업자 로그를 검토합니다: oc logs -n openshift-storage -l app=ocs-operator

VPC File Storage 의 PVC는 아직 처리 중입니다

PVC가 보류 상태로 남아 있는 경우:

• VPC 파일 CSI 드라이버 애드온이 설치되어 있고 정상적으로 작동하는지 확인하십시오
• 기본 스토리지 클래스가 올바르게 설정되어 있는지 확인하십시오
• 저장소 프로필이 RWX 액세스 모드로 설정되어 있는지 확인하십시오
• CSI 드라이버 로그 검토: oc logs -n kube-system -l app=ibm-vpc-file-csi-controller

저장 프로필이 업데이트되지 않았습니다

저장소 프로필에 올바른 구성이 표시되지 않는 경우:

• OpenShift 가상화 운영자가 설치되어 있는지 확인하십시오
• 저장 프로필이 자동으로 생성될 때까지 기다리세요
• 제공된 명령어를 사용하여 스토리지 프로필을 수동으로 수정하십시오
• 프로비저너 이름이 일치하는지 확인하십시오 vpc.file.csi.ibm.io