명령줄 IBM Software Hub 인터페이스 업데이트 ( 5.1 버전에서 5.3 버전으로 업그레이드)

클라이언트 워크스테이션을 업데이트하려면:

1. 의 cpd-cli 저장소에서 IBM/cpd-cli 버전 GitHub14.3.1 을 다운로드하세요.

   클라이언트 워크스테이션의 운영 체제에 따라 올바른 패키지를 다운로드했는지 확인하십시오:

   워크스테이션 운영 체제	Enterprise Edition	Standard Edition
   Linux®	다운로드하는 패키지는 사용자의 하드웨어 사양에 따라 달라집니다: x86_64 cpd-cli-linux-EE-14.3.1.tgz ppc64le cpd-cli-ppc64le-EE-14.3.1.tgz s390x cpd-cli-s390x-EE-14.3.1.tgz	다운로드하는 패키지는 사용자의 하드웨어 사양에 따라 달라집니다: x86_64 cpd-cli-linux-SE-14.3.1.tgz ppc64le cpd-cli-ppc64le-SE-14.3.1.tgz s390x cpd-cli-s390x-SE-14.3.1.tgz
   Mac OS	cpd-cli-darwin-EE-14.3.1.tgz	cpd-cli-darwin-SE-14.3.1.tgz
   Windows	패키지를 Linux 다운로드한 후 다음 경로에서 실행해야 Windows Subsystem for Linux 합니다: cpd-cli-linux-EE-14.3.1.tgz	패키지를 Linux 다운로드한 후 다음 경로에서 실행해야 Windows Subsystem for Linux 합니다: cpd-cli-linux-SE-14.3.1.tgz

2. 패키지의 내용을. cpd-cli을 실행하려는 디렉터리에 압축을 풀어주세요.
3. 기존 cpd-cli 설치 디렉터리를 새 cpd-cli 버전 14.3.1cpd-cli-workspace 설치 디렉터리로 복사하십시오.
   중요: 해당 cpd-cli-workspace 디렉터리를 실행 cpd-cli 파일과 동일한 디렉터리에 배치해야 합니다.

   또한, 모든 사용자가 해당 work 하위 디렉터리에 대한 읽기, 쓰기 및 실행 권한을 가지고 있는지 확인하십시오. 해당 work 디렉터리의 권한을 확인하려면, 해당 work 디렉터리가 포함된 디렉터리로 이동한 다음 다음 명령을 실행하십시오:

   ls -l

   • 명령어가 를 반환하면 별도의 조치가 drwxrwxrwx필요하지 않습니다.
   • 명령어가 다른 값을 반환하는 경우, 다음 명령어를 실행하여 모든 사용자에 대해 읽기, 쓰기 및 실행 권한을 설정하십시오:

     chmod 0777 ./work

4. 기존 cpd-cli 설치를 삭제하십시오.
5. Mac OS 에서는 다음 구성 요소를 신뢰해야 cpd-cli 합니다:
   • cpd-cli
   • plugins/lib/darwin/config
   • plugins/lib/darwin/cpdbr
   • plugins/lib/darwin/cpdbr-oadp
   • plugins/lib/darwin/cpdctl
   • plugins/lib/darwin/cpdtool
   • plugins/lib/darwin/health
   • plugins/lib/darwin/manage
   • plugins/lib/darwin/platform-diag
   • plugins/lib/darwin/platform-mgmt

   각 구성 요소에 대해:

   1. 구성 요소를 마우스 오른쪽 버튼으로 클릭한 다음 ‘열기’를 선택합니다.

      다음과 같은 형식의 메시지가 표시됩니다:

      macOS ' component-name'의 개발자를 확인할 수 없습니다. 이 파일을 여시겠습니까?

   2. ‘열기’를 클릭하세요.
6. 모범 사례: 어떤 디렉터리에서든 실행 파일을 cpd-cli 실행할 수 있도록 하십시오.

   기본적으로 명령을 실행하려면 파일이 cpd-cli 있는 cpd-cli 디렉터리로 이동하거나 파일의 전체 경로를 지정해야 합니다.

   하지만 어떤 디렉터리에서든 실행 cpd-cli 파일을 생성할 수 있으므로, 명령을 실행하려면 cpd-cli command-name 단순히 만 입력하면 됩니다.

   워크스테이션 운영 체제	세부사항
   Linux	파일에 ~/.bashrc 다음 줄을 추가하세요: export PATH=<fully-qualified-path-to-the-cpd-cli>:$PATH
   Mac OS	의 ~/.bash_profile 또는 ~/.zshrc 파일에 다음 줄을 추가하세요: export PATH=<fully-qualified-path-to-the-cpd-cli>:$PATH
   Windows	에서 다음 줄을 Windows Subsystem for Linux파일에 ~/.bashrc 추가하세요: export PATH=<fully-qualified-path-to-the-cpd-cli>:$PATH

7. 모범 사례 :. cpd-cli에 대해 다음 환경 변수 중 설정해야 할 것이 있는지 확인하십시오.

   OLM_UTILS_IMAGE

   기본적으로 Premium은 에서 이미지를 cpd-cliolm-utils-v4 IBM Entitled Registry불러옵니다. 라이선스를 IBM Software Hub Premium Cartridge 구매하셨다면, 를 업데이트하여 cpd-cli 이미지를 olm-utils-premium-v4 가져오세요.

   1. 설치하려는 IBM Software Hub 버전에 따라 환경 VERSION 변수를 설정하십시오:

      export VERSION=<version>

      사용 중인 환경에 맞는 값으로 를 <version> 대체하십시오:

      • 5.3.0
      • 5.3.1

   1. 클러스터의 하드웨어 사양에 따라 환경 OLM_UTILS_IMAGE 변수를 설정하십시오:

      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

   CPD_CLI_MANAGE_WORKSPACE

   기본적으로 명령을 cpd-cli manage 처음 실행하면 자동으로 cpd-cli cpd-cli-workspace/olm-utils-workspace/work 디렉터리가 생성됩니다.

   디렉터리의 위치는 여러 요인에 따라 달라집니다:

   • 어떤 디렉터리에서든 실행 cpd-cli 파일을 생성한 경우, 해당 디렉터리는 명령을 cpd-cli 실행하는 위치에 생성됩니다.
   • 특정 디렉터리에서 실행 cpd-cli 파일을 생성하지 않은 경우, 해당 디렉터리는 프로그램이 cpd-cli 설치된 위치에 생성됩니다.

   기본 위치를 변경하려면 환경 CPD_CLI_MANAGE_WORKSPACE 변수를 설정할 수 있습니다.

   이 CPD_CLI_MANAGE_WORKSPACE 환경 변수는 어떤 디렉터리에서든 실행 cpd-cli 파일을 실행할 때 특히 유용합니다. 환경 변수를 설정하면 파일이 하나의 디렉터리에 위치하도록 보장합니다.

   기본값

   기본값 없음 이 디렉터리는 앞선 내용에서 설명한 요소들을 바탕으로 생성됩니다.

   유효한 값은

   디렉터리를 work 생성할 cpd-cli 위치의 전체 경로. 예를 들어, 를 /root/cpd-cli/지정하면 cpd-cli manage 플러그인은 파일을 /root/cpd-cli/work 디렉터리에 저장합니다.

   환경 CPD_CLI_MANAGE_WORKSPACE 변수를 설정하려면 다음 명령을 실행하십시오:

   export CPD_CLI_MANAGE_WORKSPACE=<fully-qualified-directory>

   OLM_UTILS_LAUNCH_ARGS

   환경 OLM_UTILS_LAUNCH_ARGS 변수를 사용하여 cpd-cli 컨테이너에서 필수로 cpd-cli 사용해야 하는 인증서를 마운트할 수 있습니다.

   CA 인증서 설치

   중요: 프록시 서버를 사용하여 이미지를 미러링하거나 CASE 패키지를 다운로드하는 경우, 환경 OLM_UTILS_LAUNCH_ARGS 변수를 사용하여 CA 인증서를 추가해야 olm-utils 컨테이너가 프록시 서버를 통한 연결을 신뢰할 수 있습니다. 자세한 내용은 ‘프록시 서버 사용 시 CASE 패키지에 액세스할 수 없음’을 참조하십시오.

   자체 서명된 인증서를 사용하는 외부 HTTPS 엔드포인트에 접속해야 하는 경우 CA 인증서를 등록할 수 있습니다.

   팁: 일반적으로 CA 인증서는 워크스테이션의 /etc/pki/ca-trust 디렉터리에 있습니다. 워크스테이션에 인증서를 추가하는 방법에 대한 추가 정보가 필요하면 다음 명령을 실행하십시오:

   man update-ca-trust

   사용 중인 환경에 맞는 올바른 인수를 확인하십시오:

   • 클라이언트 워크스테이션의 인증서가 /etc/pki/ca-trust 디렉터리에 있는 경우, 인수는 다음과 같습니다:

     " -v /etc/pki/ca-trust:/etc/pki/ca-trust"

   • 클라이언트 워크스테이션의 인증서가 다른 디렉터리에 있는 경우, 다음을 클라이언트 워크스테이션의 해당 위치로 <ca-loc> 변경하십시오:

     " -v <ca-loc>:/etc/pki/ca-trust"

   인증서 Kubernetes 등록

   API Kubernetes 서버에 연결할 때 인증서가 필요한 경우 인증서를 Kubernetes 등록할 수 있습니다.

   이 주장은 클라이언트 워크스테이션 내 인증서의 위치에 따라 달라집니다. 클라이언트 워크스테이션의 해당 위치로 를 <k8-loc> 대체하십시오:

   " -v <k8-loc>:/etc/k8scert --env K8S_AUTH_SSL_CA_CERT=/etc/k8scert"

   기본값

   기본값 없음

   유효한 값은

   유효한 값은 환경 OLM_UTILS_LAUNCH_ARGS 변수에 전달해야 하는 인수에 따라 달라집니다.

   • CA 인증서를 전달하려면 다음을 지정하십시오:

     " -v <ca-loc>:/etc/pki/ca-trust"

   • 인증서를 Kubernetes 전달하려면 다음을 지정하십시오:

     " -v <k8-loc>:/etc/k8scert --env K8S_AUTH_SSL_CA_CERT=/etc/k8scert"

   • CA 인증서와 일반 Kubernetes 인증서를 모두 통과하려면 다음을 지정하십시오:

     " -v <ca-loc>:/etc/pki/ca-trust -v <k8-loc>:/etc/k8scert --env K8S_AUTH_SSL_CA_CERT=/etc/k8scert"

   환경 OLM_UTILS_LAUNCH_ARGS 변수를 설정하려면 다음 명령을 실행하십시오:

   export OLM_UTILS_LAUNCH_ARGS=" <arguments>"

   중요: 이 환경 변수 중 하나를 설정하는 경우, 반드시 설치 환경 변수 스크립트에 해당 변수를 추가해야 합니다.
8. 다음 명령을 실행하여 가 cpd-cli 설치되어 정상적으로 작동하는지, 그리고 cpd-cli manage 플러그인이 올바른 버전의 이미지를 olm-utils-v4 사용하고 있는지 확인하십시오.

   cpd-cli manage restart-container