환경 변수 스크립트 업데이트 ( 5.1 버전에서 5.3 버전으로 업그레이드)

환경 변수 파일 편집하기

1. 텍스트 편집기에서 기존 환경 변수 셸 스크립트를 열어주세요.
2. 해당 VERSION 항목을 찾아서 업그레이드하려는 IBM Software Hub 버전을 지정하십시오. 예를 들어,

   export VERSION=5.3.1

3. 사용 중인 라이선스와 클러스터 하드웨어 사양에 따라 환경 OLM_UTILS_IMAGE 변수를 설정하거나 업데이트하십시오.
   팁: 클러스터가 사설 컨테이너 레지스트리에서 이미지를 가져오는 경우, 이미지를 사설 컨테이너 레지스트리에 푸시한 후에 이 환경 변수를 업데이트해야 합니다.

   olm-utils-v4

   모든 IBM Software Hub 고객은 해당 olm-utils-v4 이미지를 사용할 수 있습니다.

   x86-64 클러스터

   export OLM_UTILS_IMAGE=icr.io/cpopen/cpd/olm-utils-v4:${VERSION}.amd64

   ppc64le 클러스터

   export OLM_UTILS_IMAGE=icr.io/cpopen/cpd/olm-utils-v4:${VERSION}.ppc64le

   s390x 클러스터

   export OLM_UTILS_IMAGE=icr.io/cpopen/cpd/olm-utils-v4:${VERSION}.s390x

   olm-utils-premium-v4

   이 olm-utils-premium-v4 이미지를 사용하려면 IBM Software Hub Premium Cartridge 라이선스를 구매하셔야 합니다.

   x86-64 클러스터

   export OLM_UTILS_IMAGE=cp.icr.io/cp/cpd/olm-utils-premium-v4:${VERSION}.amd64

   ppc64le 클러스터

   export OLM_UTILS_IMAGE=cp.icr.io/cp/cpd/olm-utils-premium-v4:${VERSION}.ppc64le

   s390x 클러스터

   export OLM_UTILS_IMAGE=cp.icr.io/cp/cpd/olm-utils-premium-v4:${VERSION}.s390x

4. 필요한 경우 변수를 COMPONENTS 업데이트하십시오.

   서비스 구성 요소 목록이 정확한지 확인하십시오.

5. 이미지를 비공개 컨테이너 레지스트리에 미러링할 때, 서비스 이미지에 포함되지 않은 모델이나 선택적 이미지를 미러링해야 하는 경우, 스크립트에 다음 IMAGE_GROUPS 환경 변수를 추가하거나 업데이트하십시오:

   export IMAGE_GROUPS=<comma-separated-list-of-group-names>

   개인 컨테이너 레지스트리에 미러링할 모델 또는 선택적 이미지의 쉼표로 구분된 목록입니다.

   구성 요소에 기본적으로 미러링되지 않는 모델이나 선택적 이미지가 포함된 경우, 해당 이미지를 개인 컨테이너 레지스트리에 명시적으로 미러링해야 합니다.

   예를 들어, 를 설치할 계획이라면 watsonx.ai™, 개인 컨테이너 레지스트리에 미러링할 모델을 선택해야 합니다.

   자세한 내용은 ‘프라이빗 컨테이너 레지스트리에 미러링할 모델 및 이미지 결정하기( 5.1 버전에서 5.3 버전으로 업그레이드) ’를 참조하십시오.

6. 스크립트에 “이미지 가져오기 구성”이라는 새 섹션을 추가하고 다음 환경 변수를 추가하십시오:
   1. 환경 IMAGE_PULL_SECRET 변수를 추가하고, 이미지 풀링을 위한 base64 형식으로 인코딩된 자격 증명을 포함할 네임스페이스 범위 내 시크릿에 사용할 이름을 설정하십시오.

      Kubernetes 규격을 준수하며 소문자 영숫자, 하이픈(-) 또는 점(.)만 포함된 이름을 지정하십시오. 이름은 영숫자로 시작하고 끝내야 합니다.

      export IMAGE_PULL_SECRET=<pull-secret-name>

   2. 클러스터가 이미지를 가져오는 위치에 따라 및 IMAGE_PULL_PREFIX 환경 IMAGE_PULL_CREDENTIALS 변수를 추가하십시오:

      IBM Entitled Registry

      클러스터가 에서 이미지를 IBM Entitled Registry가져오는 경우, 스크립트에 다음 환경 변수를 추가하십시오. 명령을 export 수정하지 마십시오:

      export IMAGE_PULL_CREDENTIALS=$(echo -n "cp:$IBM_ENTITLEMENT_KEY" | base64 -w 0)
      export IMAGE_PULL_PREFIX=icr.io

      개인용 컨테이너 레지스트리

      클러스터가 사설 컨테이너 레지스트리에서 이미지를 가져오는 경우, 스크립트에 다음 환경 변수를 추가하십시오. 명령을 export 수정하지 마십시오:

      export IMAGE_PULL_CREDENTIALS=$(echo -n "$PRIVATE_REGISTRY_PULL_USER:$PRIVATE_REGISTRY_PULL_PASSWORD" | base64 -w 0)
      export IMAGE_PULL_PREFIX=${PRIVATE_REGISTRY_LOCATION}

7. 변경사항을 저장하십시오.
8. 스크립트에 오류가 없는지 확인하십시오. 예를 들어, cpd_vars.sh 스크립트를 지정한 경우 다음을 실행하십시오.

   bash ./cpd_vars.sh

환경 변수 소싱

설치 및 업그레이드 명령을 실행하기 전에 반드시 bash 프롬프트에서 스크립트를 실행해야 합니다. 스크립트는 환경 변수를 명령행 세션으로 내보냅니다.

1. 스크립트를 저장한 디렉토리로 변경하십시오.
2. 환경 변수를 확인하십시오. 예를 들어, cpd_vars.sh 스크립트를 지정한 경우 다음을 실행하십시오.

   source ./cpd_vars.sh

다음에 수행할 작업