선택사항: IBM Cloud Object Storage 서비스 인스턴스 설정

스토리지 클러스터에서 IBM Cloud Object Storage를 기본 백업 저장소로 설정하려는 경우 IBM Cloud Object Storage의 인스턴스를 작성하십시오. 그런 다음 Object Storage HMAC 인증 정보를 사용하는 HMAC 인증 정보 및 Kubernetes 시크릿 세트를 작성하십시오. 설치 중에 IBM Cloud Object Storage 인증 정보를 지정하지 않으면 스토리지 클러스터의 기본 백업 저장소가 클러스터에서 PV를 사용하여 작성됩니다. ODF를 배치한 후 추가 백업 저장소를 설정할 수 있지만 기본 백업 저장소를 변경할 수는 없습니다.

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

1. 클러스터에서 openshift-storage 네임스페이스를 작성하십시오. 드라이버 팟(Pod)이 이 네임스페이스에 배치됩니다. 다음 YAML을 복사하여 로컬 시스템에 os-namespace.yaml로 저장하십시오.

   apiVersion: v1
   kind: Namespace
   metadata:
     labels:
       openshift.io/cluster-monitoring: "true"
     name: openshift-storage
   

2. 저장한 YAML 파일을 사용하여 openshift-storage 네임스페이스를 작성하십시오.

   oc create -f os-namespace.yaml
   

3. 네임스페이스가 작성되었는지 확인하십시오.

   oc get namespaces | grep storage
   

4. IBM Cloud Object Storage 서비스 인스턴스를 작성하십시오.

   ibmcloud resource service-instance-create noobaa-store cloud-object-storage standard global
   

5. HMAC 인증 정보를 작성하십시오. 인증 정보를 기록해 두십시오.

   ibmcloud resource service-key-create cos-cred-rw Writer --instance-name noobaa-store --parameters '{"HMAC": true}'
   

6. Object Storage HMAC 인증 정보를 사용하는 ibm-cloud-cos-creds 네임스페이스의 Kubernetes 시크릿 openshift-storage를 작성하십시오. 명령을 실행할 때 Object Storage HMAC 액세스 키 ID 및 시크릿 액세스 키를 지정하십시오. 시크릿 이름이 ibm-cloud-cos-creds여야 합니다.

   oc -n 'openshift-storage' create secret generic 'ibm-cloud-cos-creds' --type=Opaque --from-literal=IBM_COS_ACCESS_KEY_ID=<access_key_id> --from-literal=IBM_COS_SECRET_ACCESS_KEY=<secret_access_key>
   

7. 시크릿이 작성되었는지 확인하십시오.

   oc get secrets -A | grep cos
   

선택사항: Hyper Protect Crypto Services 를 사용하여 암호화 설정

암호화를 설정하려면 Hyper Protect Crypto Services 또는 Key Protect의 인스턴스를 작성하십시오. 그런 다음 Hyper Protect Crypto Services 또는 Key Protect 인증 정보를 사용하는 루트 키 및 Kubernetes 시크릿을 작성하십시오.

IBM Cloud는 전용 키 관리 서비스를 Hyper Protect Crypto Services에서 Key Protect Dedicated로 변경하고 있습니다.

Hyper Protect Crypto Services 또는 Key Protect 에 대한 API키에는 다음과 같은 최소 필수 권한이 있어야 합니다.

Reader

Reader Plus

클러스터 전체 암호화 및 스토리지 클래스 암호화를 사용하는 경우 API키에 다음과 같은 필수 권한이 있어야 합니다.

Reader

Reader Plus

Writer

1. Hyper Protect Crypto Services 또는 Key Protect 서비스 인스턴스를 작성하십시오.

2. 루트 키 작성

   • Hyper Protect Crypto Services.
   • Key Protect.

3. 인스턴스 및 루트 키를 작성한 후 Hyper Protect Crypto Services 또는 Key Protect 인스턴스 이름, 인스턴스 ID, 루트 키 ID및 공용 엔드포인트를 기록해 두십시오.

4. Hyper Protect Crypto Services 및 Red Hat OpenShift on IBM Cloud 또는 Key Protect 및 Red Hat OpenShift on IBM Cloud에 대한 액세스를 허용하는 서비스 ID, API키 및 액세스 정책 을 작성하십시오. 생성한 API를 기록해 두세요.

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

1. 네임스페이스를 나열하여 openshift-storage 네임스페이스가 있는지 여부를 판별하십시오. openshift-storage 네임스페이스가 없는 경우 작성하십시오.

   oc get namespaces | grep openshift-storage
   

   1. 클러스터에서 openshift-storage 네임스페이스를 작성하십시오. 드라이버 팟(Pod)이 이 네임스페이스에 배치됩니다. 다음 YAML을 복사하여 로컬 시스템에 os-namespace.yaml로 저장하십시오.

       apiVersion: v1
       kind: Namespace
       metadata:
         labels:
           openshift.io/cluster-monitoring: "true"
         name: openshift-storage
       ```
   1. 저장한 YAML 파일을 사용하여 `openshift-storage` 네임스페이스를 작성하십시오.
   ```sh {: pre}
       oc create -f os-namespace.yaml
       ```
   1. 네임스페이스가 작성되었는지 확인하십시오.
   ```sh {: pre}
       oc get namespaces | grep storage
       ```
   

2. base64로 작성한 서비스 ID의 API키 및 루트 키의 ID를 모두 인코딩하십시오.

   printf "ROOT-KEY-ID" | base64
   

   printf "SERVICE-ID-API-KEY" | base64
   

3. openshift-storage 네임스페이스에서 Hyper Protect Crypto Services 자격 증명을 사용하는 ‘ Kubernetes ’ 시크릿을 생성합니다.
   1. 다음 시크릿을 ibm-hpcs-secret.yaml 라는 YAML 파일로 저장하십시오.

       apiVersion: v1
       data:
         IBM_KP_CUSTOMER_ROOT_KEY: AaAAAaZAAAAy11AAAyAAkaAaQtAAk0AAA2AzY5AjYaaa67aa # your base64 encoded root key ID
         IBM_KP_SERVICE_API_KEY: AAAaaajAAAAAncmAAaaaaAAAAdAAId1AtVjBJRU1aAAaAeTh1aEw=AaaaA # your base64 encoded API
       kind: Secret
       metadata:
         name: ibm-hpcs-secret
         namespace: openshift-storage
       type: Opaque
       ```
   1. 클러스터의 시크릿을 작성하십시오.
   ```sh {: pre}
       oc apply -f ibm-hpcs-secret.yaml
       ```
   

4. 시크릿이 작성되었는지 확인하십시오.

   oc get secrets -A | grep ibm-hpcs-secret
   

OpenShift Data Foundation 설치를 위한 클러스터 준비

OpenShift Data Foundation을 설치하기 전에 클러스터를 준비하십시오.

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

1. oc debug 명령을 사용하여 클러스터에서 각 작업자 노드에 로그인하고 다음 단계를 완료하십시오.

   • 작업자 노드에 로그인하십시오. <worker_node_IP> 을 사용자의 워커 노드 이름으로 바꾸십시오. 워커 노드의 이름을 확인하려면 다음 oc get nodes 명령을 실행하십시오.

       oc debug node/<node name> -- chroot /host rm -rvf /var/lib/rook /mnt/local-storage
       ```
   - 각 디스크 파티션에 대해 작업자 노드에서 `xfs` 파일 시스템을 지우십시오. 파일 시스템을 지우지 않으면 OSD가 작성되지 않습니다.
   ```sh {: pre}
       file -sL /dev/<partition>
       wipefs -a /dev/<partition>
       ```
   - `/etc/kubernetes/kubelet.conf` 파일을 편집하고 `EnableControllerAttachDetach` 매개변수의 값을 `true` 로 변경하십시오.
   ```sh {: pre}
       nano /etc/kubernetes/kubelet.conf
       ```
   - `ctrl + X`를 사용하여 저장한 후 종료하십시오.
   
   - kubelet을 다시 시작하십시오.
   ```sh {: pre}
       systemctl restart kubelet
       ```
   - 작업자 노드에서 로그아웃하십시오.
   ```sh
       exit
       ```
   
   

2. 이전 단계를 반복하여 ODF 배치에 사용할 각 작업자 노드의 파일 시스템을 삭제하십시오.

디바이스 세부사항 가져오기

자동 디스크 감지를 사용하여 ODF에 사용할 수 있는 디바이스를 찾을 수 있습니다. 그러나 ODF에 대한 스토리지 디바이스를 수동으로 지정하려면 다음 단계를 완료하여 스토리지 디바이스 세부사항을 검색하십시오.

ODF를 설치하기 전에 작업자 노드에서 로컬 디스크의 세부 사항을 가져오십시오.

1. 클러스터에 로그인하고 사용 가능한 작업자 노드 목록을 가져오십시오. OCS 배치에 사용할 작업자 노드를 기록해 두십시오.

   oc get nodes
   

2. ODF에 사용할 각 작업자 노드에 로그인하십시오.

   oc debug node/<node-name>
   

3. 디버그 팟(Pod)이 작업자 노드에 배치되면 다음 명령을 실행하여 호스트 2진을 허용하십시오.

   chroot /host
   

4. 작업자 노드의 사용 가능한 디스크를 나열하십시오.

   lsblk
   

5. 사용 가능한 디스크에 대한 명령 출력을 검토하십시오. 다음 예제에서는 ODF 배치에 대해 마운트 해제된 디스크만 사용할 수 있습니다(예: sdc 디스크). ODF 배치의 초기 스토리지 용량은 osd-device-path로 지정한 디스크의 크기와 같습니다. 이 예에서는 sdc 디스크가 마운트 해제되어 있고 두 개의 사용 가능한 파티션 sdc1 및 sdc2가 있습니다.

   NAME   MAJ:MIN RM   SIZE RO TYPE MOUNTPOINT
   sda      8:0    0   931G  0 disk
   |-sda1   8:1    0   256M  0 part /boot
   |-sda2   8:2    0     1G  0 part
    -sda3   8:3    0 929.8G  0 part /
   sdb      8:16   0 744.7G  0 disk
    -sdb1   8:17   0 744.7G  0 part /disk1
   sdc      8:32   0 744.7G  0 disk
   |-sdc1   8:33   0  18.6G  0 part
    -sdc2   8:34   0 260.8G  0 part
   

6. 배치에 사용할 마운트되지 않은 각 디스크에 대해 디스크 ID를 찾으십시오. 다음 예제에서 sdc1 파티션의 ID는 scsi-3600605b00d87b43027b3bc310a64c6c9-part1이며 sdc2 파티션의 ID는 scsi-3600605b00d87b43027b3bc310a64c6c9-part2입니다.

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

   출력 예

   total 0
   lrwxrwxrwx. 1 root root  9 Feb  9 04:15 scsi-3600605b00d87b43027b3bbb603150cc6 -> ../../sda
   lrwxrwxrwx. 1 root root 10 Feb  9 04:15 scsi-3600605b00d87b43027b3bbb603150cc6-part1 -> ../../sda1
   lrwxrwxrwx. 1 root root 10 Feb  9 04:15 scsi-3600605b00d87b43027b3bbb603150cc6-part2 -> ../../sda2
   lrwxrwxrwx. 1 root root 10 Feb  9 04:15 scsi-3600605b00d87b43027b3bbb603150cc6-part3 -> ../../sda3
   lrwxrwxrwx. 1 root root  9 Feb  9 04:15 scsi-3600605b00d87b43027b3bbf306bc28a7 -> ../../sdb
   lrwxrwxrwx. 1 root root 10 Feb  9 04:15 scsi-3600605b00d87b43027b3bbf306bc28a7-part1 -> ../../sdb1
   lrwxrwxrwx. 1 root root  9 Feb  9 04:17 scsi-3600605b00d87b43027b3bc310a64c6c9 -> ../../sdc
   lrwxrwxrwx. 1 root root 10 Feb 11 03:14 scsi-3600605b00d87b43027b3bc310a64c6c9-part1 -> ../../sdc1
   lrwxrwxrwx. 1 root root 10 Feb 11 03:15 scsi-3600605b00d87b43027b3bc310a64c6c9-part2 -> ../../sdc2
   

7. OpenShift Data Foundation 배치에 사용할 각 작업자 노드에 대해 이전 단계를 반복하십시오.

8. 클러스터에 ODF를 설치하십시오.