전제조건

• 클러스터에 대해 관리자 서비스 액세스 역할이 있는지 확인하십시오.
• KMS 제공자를 설정하십시오.
• 다음 항목을 가져옵니다 apikey, 또는 access_key_id 그리고 secret_access_key IBM Cloud Object Storage 서비스 자격 증명을 가져옵니다. 서비스 인증 정보는 앱이 수행해야 하는 버킷 오퍼레이션에 대해 충분해야 합니다. 예를 들어, 앱이 버킷에서 데이터를 읽는 경우, 시크릿에 표시된 서비스 자격 증명에는 최소한 ‘Reader’ 권한이 부여되어 있어야 합니다.

클러스터에서 오브젝트 스토리지 시크릿 작성

다음 단계를 완료하여 IBM Cloud Object Storage에 대한 클러스터에서 시크릿을 작성하십시오.

클러스터의 PVC에서 새 버킷을 작성할 때 Key Protect 암호화를 통합하려면 IBM Cloud Object Storage 시크릿 을 작성할 때 루트 키 CRN을 포함해야 합니다. Key Protect 암호화를 기존 버킷에 추가할 수 없습니다. 새 버킷을 작성하는 경우에만 암호화를 사용할 수 있습니다. 암호화에 사용되는 루트 키가 삭제되면 연관된 버킷의 모든 파일에 액세스할 수 없습니다.

• 계정에 로그인하십시오. If applicable, target the appropriate resource group. 클러스터에 대한 컨텍스트를 설정하십시오.

1. IBM Cloud Object Storage 서비스 인스턴스의 GUID를 가져오십시오.

   ibmcloud resource service-instance <service_name> | grep GUID
   

2. 서비스 인증 정보를 저장하기 위한 Kubernetes 시크릿을 작성하십시오. 다음 예제 중 하나를 선택하여 시크릿을 작성하십시오.

   • API 키를 사용하는 create secret 명령의 예입니다.

       kubectl create secret generic cos-write-access --type=ibm/ibmc-s3fs --from-literal=api-key=<api_key> --from-literal=service-instance-id=<service_instance_guid>
       ```
   * HMAC 인증을 사용하는 `create secret` 명령의 예입니다.
   ```sh {: pre}
       kubectl create secret generic cos-write-access --type=ibm/ibmc-s3fs --from-literal=access-key=<access_key_ID> --from-literal=secret-key=<secret_access_key>    
       ```
   * KMS 제공자를 사용하여 암호화를 사용으로 설정하기 위한 예제 시크릿 구성 파일입니다.
       1. 다음 YAML을 파일에 저장하십시오.
           ```yaml {: codeblock}
           apiVersion: v1
           data:
               access-key: xxx
               secret-key: xxx
               kp-root-key-crn: <CRN> # Key Protect or HPCS root key crn in base64 encoded format
           kind: Secret
           metadata:
               name: cos-write-access
           type: ibm/ibmc-s3fs
           ```
           `api-key`
           :   이전에 IBM Cloud Object Storage 서비스 인증 정보에서 검색한 API 키를 입력하십시오. HMAC 인증을 사용하려면 `access-key` 및 `secret-key`를 대신 지정하십시오.
   
           `access-key`
           :   이전에 IBM Cloud Object Storage 서비스 인증 정보에서 검색한 액세스 키 ID를 입력하십시오. OAuth2 인증을 사용하려면 `api-key`를 대신 지정하십시오.
   
           `secret-key`
           :   이전에 IBM Cloud Object Storage 서비스 인증 정보에서 검색한 시크릿 액세스 키를 입력하십시오. OAuth2 인증을 사용하려면 `api-key`를 대신 지정하십시오.
   
           `service-instance-id`
           :   이전에 검색한 IBM Cloud Object Storage 서비스 인스턴스의 GUID를 입력하십시오.
   
           `kp-root-key-crn`
           :   base64 인코딩된 Key Protect 루트 키 CRN을 입력하여 Key Protect 암호화를 사용하십시오.
   
       1. 이 비결을 클러스터에 적용하세요.
           ```sh {: pre}
           kubectl apply -f <secret_name>
           ```
   
   

3. 클러스터의 시크릿을 가져오고 출력을 확인하십시오.

   kubectl get secret
   

   출력 예

   NAME                  TYPE                                  DATA   AGE
   cos-write-access      ibm/ibmc-s3fs                         2      7d19h
   default-au-icr-io     kubernetes.io/dockerconfigjson        1      55d
   default-de-icr-io     kubernetes.io/dockerconfigjson        1      55d
   ...
   

4. IBM Cloud Object Storage 플러그인을 설치하십시오. 또는 플러그인을 이미 설치한 경우에는 IBM Cloud Object Storage 버킷에 대한 구성을 결정하십시오.

5. 선택사항: 시크릿을 기본 스토리지 클래스에 추가하십시오. 스토리지 클래스 참조