콘솔에서 OpenShift Data Foundation 추가 기능 설치

클러스터에 ODF를 설치하려면 다음 단계를 완료하십시오.

애드온을 활성화하기 전에, 최신 버전 정보를 확인하려면 변경 내역을 살펴보십시오. 또한 매개변수 참조를 검토하여 설치 옵션을 이해하세요.

1. 콘솔 에서 애드온을 설치할 클러스터를 선택하십시오.
2. OpenShift Data Foundation 카드에서 설치를 클릭하십시오. ODF 설치 패널이 열립니다.
3. ODF 설치 패널에서 ODF 배치에 사용하려는 구성 매개변수를 입력하십시오.

비용 청구 유형

에센셜 또는 고급을 청구 플랜으로 선택하세요. 청구 유형에 대한 자세한 정보는 청구 유형별 기능 지원 을 참조하십시오.

스토리지 클래스

사용하려는 스토리지 클래스를 입력하십시오.

• 가상 머신을 사용하는 VPC 클러스터의 경우 원격 프로비저닝을 선택하여 Block Storage for VPC 을 사용하여 ODF용 볼륨을 동적으로 프로비저닝합니다.
• Bare Metal Servers for VPC 워커 노드를 사용하는 VPC 클러스터의 경우 로컬 스토리지를 선택합니다. 워커 노드에서 사용 가능한 저장 장치를 자동으로 검색하여 ODF에서 사용하려면 로컬 디스크 검색을 선택합니다.

OSD 스토리지 클래스 이름

스토리지 볼륨을 프로비저닝하는 데 사용할 스토리지 클래스의 이름을 입력하십시오.

• Bare Metal Servers for VPC 작업자 노드가 있는 VPC 클러스터의 경우 localblock 을 선택합니다.
• 멀티존 클러스터의 경우 WaitForFirstConsumer 의 VolumeBindingMode 와 함께 스토리지 클래스를 사용합니다.
• 스토리지 클래스 목록은 스토리지 클래스 참조를 참조하세요.

OSD 포드 크기

프로비저닝할 볼륨의 크기를 입력하십시오. 512Gi 을 입력합니다.

작업자 노드

ODF를 배포할 워커 노드의 이름을 입력하십시오. 3개이상의 작업자 노드 이름을 입력해야 합니다. 노드 이름을 찾으려면 클러스터에서 oc get nodes 명령을 실행하세요. Node 이름은 쉼표로 구분하고 이름 사이에 공백을 두지 않아야 합니다. 예: 10.240.0.24,10.240.0.26,10.240.0.25. 모든 워커 노드에 ODF를 배포하려면 이 필드를 비워 두세요.

필요한 OSD 디스크 수

각 워커 노드에서 프로비저닝할 OSD 디스크(앱 스토리지)의 수를 입력합니다.

클러스터 암호화 사용

ODF 시스템 파드에서 사용하는 OSD 볼륨(클러스터 전체 암호화)을 암호화하려면 이 옵션을 선택합니다.

볼륨 암호화 사용

애플리케이션 볼륨(앱 저장소)에 대한 암호화를 사용하려면 이 옵션을 선택합니다.

• 인스턴스 이름 필드에 Hyper Protect Crypto Services 또는 Key Protect 인스턴스의 고유 이름을 입력하십시오.
• 인스턴스 유형 필드에 암호화 인스턴스의 유형을 입력하십시오.
• 인스턴스 ID 필드에 Hyper Protect Crypto Services 또는 Key Protect 인스턴스 ID를 입력하십시오. 예: d11a1a43-aa0a-40a3-aaa9-5aaa63147aaa.
• 시크릿 이름 필드에 Hyper Protect Crypto Services 또는 Key Protect 신임 정보를 사용하여 작성한 시크릿의 이름을 입력하십시오. 예: ibm-hpcs-secret.
• 기본 URL 필드에 Hyper Protect Crypto Services 또는 Key Protect 인스턴스의 공개 엔드포인트를 입력합니다. 예: https://api.eu-gb.hs-crypto.cloud.ibm.com:8389.
• 토큰 URL 칸에 https://iam.cloud.ibm.com/identity/token 를 입력합니다.

1. 사용하려는 매개변수를 입력한 후 설치를 클릭하십시오.

2. 추가 기능 배치가 완료될 때까지 몇 분 정도 기다리십시오. 배치가 완료되면 추가 기능 상태는 Normal - Addon Ready입니다.

3. 설치를 확인하십시오. Red Hat OpenShift 클러스터에 액세스하십시오.

4. 다음 명령을 실행하여 ODF 팟(pod)이 실행 중인지 검증하십시오.

   oc get pods -n openshift-storage
   

다음 단계

ODF를 사용하는 앱을 배치하십시오.

CLI에서 추가 기능 설치

ibmcloud oc cluster addon enable 명령을 사용하여 추가 기능을 설치할 수 있습니다.

1. VPC 매개변수 참조 를 검토하십시오. 애드온을 활성화하면, 재정의하려는 각 매개변수에 대해 --param "key=value" 옵션을 지정하여 기본값을 재정의할 수 있습니다.

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

3. openshift-data-foundation 추가 기능 버전을 나열하십시오. 기본 버전을 기록하고 설치할 버전을 판별하십시오.

   ibmcloud ks cluster addon versions
   

4. 애드온을 활성화하기 전에, 최신 버전 정보를 확인하려면 변경 내역을 살펴보십시오. 추가 기능은 n+1 클러스터 버전을 지원합니다. 예를 들어, OCP 4.9 또는 4.11 클러스터에 4.10.0 버전의 애드온을 배포할 수 있습니다. 기본값과 다른 클러스터 버전을 사용하는 경우, 애드온을 활성화할 때 --version 옵션을 지정해야 합니다.

5. 추가 기능 옵션을 검토하십시오.

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

   최상의 성능을 위해, performance 로 지정된 ' resourceProfile ' 옵션을 포함하는 것이 좋습니다. 이 옵션은 배포 시 리소스의 가용성에 따라 향상된 성능 수준을 얻을 수 있도록 도와줍니다. resourceProfile 옵션에 대한 자세한 내용은 Red Hat OpenShift 의 ODF 문서에 있는 ‘성능 프로필’ 항목을 참조하십시오.

   버 4.15.0 의 추가 기능 옵션 예

   Add-on Options
   Option                            Default Value
   osdStorageClassName               ibmc-vpc-block-metro-10iops-tier
   ocsUpgrade                        false
   billingType                       advanced
   autoDiscoverDevices               false
   hpcsBaseUrl                       <Please provide the KMS Base (public) URL>
   taintNodes                        false
   enableNFS                         false
   resourceProfile                   performance
   useCephRBDAsDefaultStorageClass   false
   clusterEncryption                 false
   hpcsEncryption                    false
   hpcsSecretName                    <Please provide the KMS secret name>
   encryptionInTransit               false
   disableNoobaaLB                   false
   osdSize                           512Gi
   numOfOsd                          1
   ignoreNoobaa                      true
   addSingleReplicaPool              false
   prepareForDisasterRecovery        false
   workerPool                        -
   odfDeploy                         true
   osdDevicePaths                    <Please provide IDs of the disks to be used for OSD pods if using local disks or standard classic cluster>
   workerNodes                       all
   hpcsServiceName                   <Please provide the KMS Service instance name>
   hpcsInstanceId                    <Please provide the KMS Service instance ID>
   hpcsTokenUrl                      <Please provide the KMS token URL>
   

6. openshift-data-foundation 추가 기능을 사용으로 설정하십시오. 기본 매개변수 중 어느 것을 재정의하려면, 재정의하려는 각 매개변수에 대해 --param "key=value" 옵션을 지정하십시오. 추가 기능을 사용으로 설정할 때 스토리지 클러스터를 작성하지 않으려는 경우 먼저 추가 기능을 사용하도록 설정한 후 CRD를 작성하여 나중에 스토리지 클러스터를 작성할 수 있습니다.

   추가 기능 버전 4.10 기본 스토리지 클러스터 설정, performance 리소스 프로필, Hyper Protect Crypto Services 암호화 활성화와 함께 배포하는 명령의 예.

   ibmcloud oc cluster addon enable openshift-data-foundation -c CLUSTER_NAME --version 4.15.0 --param "odfDeploy=true" --param "resourceProfile=performance" --param "hpcsTokenUrl=https://iam.cloud.ibm.com/identity/token" --param "hpcsEncryption=true" --param "hpcsBaseUrl=HPCS_INSTANCE_PUBLIC_ENDPOINT" --param "hpcsInstanceId=HPCS_INSTANCE_ID" --param "hpcsServiceName=HPCS_INSTANCE_NAME" --param "hpcsSecretName=HPCS_SECRET_NAME"
   

   ODF 추가 기능만 배치하기 위한 명령 예제입니다.

   ibmcloud oc cluster addon enable openshift-data-foundation -c CLUSTER_NAME --version VERSION --param "odfDeploy=false"
   

   기본 구성 매개변수로 ODF를 배치하고 스토리지 클러스터를 작성하기 위한 명령 예제

   ibmcloud oc cluster addon enable openshift-data-foundation -c CLUSTER_NAME --version VERSION
   

   osdSize 매개변수를 오버라이드하는 중에 ODF를 배치하고 스토리지 클러스터를 작성하기 위한 명령 예제입니다.

   ibmcloud oc cluster addon enable openshift-data-foundation -c CLUSTER_NAME --version VERSION --param "osdSize=500Gi"
   

7. 추가 기능이 Ready 상태인지 확인하십시오.

   oc get storagecluster -n openshift-storage
   

   출력 예:

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

8. ibm-ocs-operator-controller-manager-***** 팟(Pod)이 kube-system 네임스페이스에서 실행 중인지 확인하십시오.

   oc get pods -A | grep ibm-ocs-operator-controller-manager
   

9. odfDeploy 가 false 로 설정된 추가 기능을 사용으로 설정한 경우 ODF 사용자 정의 자원 작성 단계를 수행하십시오.

Terraform에서 추가 기능 설치

• Terraform CLI및 IBM Cloud 제공자 플러그인을 설치하십시오.
• IBM Cloud API 키가 있는지 확인하세요.

1. Terraform 프로바이더 파일을 생성합니다. Terraform 디렉토리에 파일을 저장하십시오. 자세한 정보는 Terraform IBM Cloud 제공자 문서를 참조하십시오.

   Terraform 제공자 파일의 예입니다.

   terraform {
   required_providers {
       ibm = {
       source = "IBM-Cloud/ibm"
       version = "1.53.0"
       }
   }
   }
   provider "ibm" {
   region = "us-south"
   ibmcloud_api_key = "<api-key>"
   }
   

2. ODF 추가 기능에 대한 Terraform 구성 파일을 작성하십시오. Terraform 디렉토리에 파일을 저장하십시오.

   구성 파일의 예입니다.

   ibmcloud_api_key = "" # Enter your API Key
   cluster = "" # Enter the Cluster ID
   region = "us-south" # Enter the region
   # For add-on deployment
   odfVersion = "4.12.0"
   # For CRD Creation and Management
   autoDiscoverDevices = "false"
   billingType = "advanced"
   clusterEncryption = "false"
   hpcsBaseUrl = null
   hpcsEncryption = "false"
   hpcsInstanceId = null
   hpcsSecretName = null
   hpcsServiceName = null
   hpcsTokenUrl = null
   ignoreNoobaa = "false"
   numOfOsd = "1"
   ocsUpgrade = "false"
   osdDevicePaths = null
   osdSize = "250Gi"
   osdStorageClassName = "ibmc-vpc-block-metro-10iops-tier"
   workerNodes = null
   

3. CLI에서 Terraform 디렉토리로 이동하십시오.

   cd <terraform_directory>
   

4. 명령을 실행하여 Terraform 조치를 초기화하고 계획하십시오. 계획 출력을 검토하여 올바른 조치가 수행되었는지 확인하십시오.

   terraform init
   

   terraform plan
   

5. Terraform 파일을 적용하여 클러스터를 작성하십시오. 그런 다음 IBM Cloud 콘솔로 이동하여 클러스터가 프로비저닝 중인지 확인하십시오.

   terraform apply
   

ODF 사용자 정의 리소스 작성

스토리지 볼륨에 대한 동적 프로비저닝을 사용하여 VPC 클러스터에서 ODF 스토리지 클러스터를 작성하려면 사용자 정의 리소스를 작성하여 스토리지 디바이스 세부사항을 지정할 수 있습니다.

IBM Cloud Object Storage 서비스 인스턴스를 기본 백업 저장소로 사용하려는 경우 서비스 인스턴스를 작성했고 클러스터에서 Kubernetes 시크릿을 작성했는지 확인하십시오. 클러스터에서 ODF CRD를 작성하는 경우, ODF가 시크릿 ibm-cloud-cos-creds를 찾아 Object Storage HMAC 인증 정보를 사용하는 기본 백업 저장소를 설정합니다.

1. OcsCluster라는 사용자 정의 리소스 정의를 작성하십시오. 다음 사용자 정의 리소스 정의 파일 중 하나를 로컬 컴퓨터에 저장한 다음, 앞서 생성한 스토리지 클래스의 이름을 monStorageClassName 및 osdStorageClassName 매개변수로 포함하도록 파일을 수정하십시오. OcsCluster 매개변수에 대한 자세한 정보는 매개변수 참조를 참조하십시오.

   4.8 클러스터의 모든 작업자 노드에 ODF를 설치하기 위한 사용자 정의 리소스 정의 예제입니다.

   apiVersion: ocs.ibm.io/v1
   kind: OcsCluster
   metadata:
     name: ocscluster-vpc # Kubernetes resource names can't contain capital letters or special characters. Enter a name for your resource that uses only lowercase letters, numbers, `-` or `.`
   spec:
     osdStorageClassName: <osdStorageClassName> # Specify an ODF storage class with a waitForFirstConsumer volume binding mode
     osdSize: <osdSize> # The OSD size is the total storage capacity of your OCS storage cluster. Use at least 250Gi OSDs for production workloads.
     numOfOsd: 1
     billingType: advanced
     ocsUpgrade: false
   

   4.8 클러스터의 지정된 작업자 노드에만 ODF를 설치하기 위한 사용자 정의 리소스 정의 예제입니다.

   apiVersion: ocs.ibm.io/v1
   kind: OcsCluster
   metadata:
     name: ocscluster-vpc # Kubernetes resource names can't contain capital letters or special characters. Enter a name for your resource that uses only lowercase letters, numbers, `-` or `.`
   spec:
     osdStorageClassName: <osdStorageClassName> # Specify an ODF storage class with a waitForFirstConsumer volume binding mode
     osdSize: <osdSize> # The OSD size is the total storage capacity of your OCS storage cluster. Use at least 250Gi OSDs for production workloads.
     numOfOsd: 1
     billingType: advanced
     ocsUpgrade: false
     workerNodes: # Specify the private IP addresses of the worker nodes where you want to install OCS.
       - <workerNodes> # To get a list worker nodes, run `oc get nodes`.
       - <workerNodes>
       - <workerNodes>
   

2. 파일을 저장하고 OcsCluster 사용자 정의 리소스를 클러스터에 작성하십시오.

   oc create -f <ocs-cluster-filename>.yaml
   

3. OcsCluster가 실행 중인지 확인하십시오.

   oc describe ocscluster ocscluster-vpc
   

   출력 예

   Name:         ocscluster-vpc
   Namespace:    
   Labels:       <none>
   Annotations:  <none>
   API Version:  ocs.ibm.io/v1
   Kind:         OcsCluster
   Metadata:
       Creation Timestamp:  2021-03-23T20:56:51Z
   Finalizers:
     finalizer.ocs.ibm.io
   Generation:  1
   Managed Fields:
     API Version:  ocs.ibm.io/v1
     Fields Type:  FieldsV1
     fieldsV1:
       f:spec:
         .:
         f:billingType:
         f:monSize:
         f:monStorageClassName:
         f:numOfOsd:
         f:ocsUpgrade:
         f:osdSize:
         f:osdStorageClassName:
     Manager:      oc
     Operation:    Update
     Time:         2021-03-23T20:56:51Z
     API Version:  ocs.ibm.io/v1
     Fields Type:  FieldsV1
     fieldsV1:
       f:metadata:
         f:finalizers:
           .:
           v:"finalizer.ocs.ibm.io":
       f:status:
         .:
         f:storageClusterStatus:
     Manager:         manager
     Operation:       Update
     Time:            2021-04-09T23:12:02Z
   Resource Version:  11372332
   Self Link:         /apis/ocs.ibm.io/v1/ocsclusters/ocscluster-vpc
   UID:               aa11a1a1-111f-aace-afac-1fa1afe1111a
   Spec:
     Billing Type:            hourly
     Mon Size:                20Gi
     Mon Storage Class Name:  ibmc-vpc-block-10iops-tier
     Num Of Osd:              1
     Ocs Upgrade:             false
     Osd Size:                250Gi
     Osd Storage Class Name:  ibmc-vpc-block-10iops-tier
   Status:
     Storage Cluster Status:  
   Events:                    <none>
   

4. ODF를 사용하는 앱을 배치하십시오.