watsonx Code Assistant for Z 의 Agentic 설치

인스턴스 관리자는 버전 5.3 에 IBM® Software Hub watsonx Code Assistant for Z Agentic을 설치할 수 있습니다.

누가 이 작업을 완료해야 합니까?

인스턴스 관리자 : watsonx Code Assistant for Z Agentic을 설치하려면 인스턴스 관리자 권한이 있어야 합니다. 인스턴스 관리자는 다음 프로젝트에 소프트웨어를 설치할 수 있는 권한을 가지고 있습니다:

예를 들어, 운영자 프로젝트 의 경우

watsonx Code Assistant for Z Agentic 의 이 인스턴스에 대한 오퍼레이터는 operators 프로젝트에 설치되어 있습니다.

설치 명령어에서 환경 변수는 ${PROJECT_CPD_INST_OPERATORS} operators 프로젝트를 가리킵니다.

인스턴스에 대한 operands 프로젝트

watsonx Code Assistant for Z 용 사용자 정의 리소스와 Agentic은 control plane operands 프로젝트에 설치되어 있습니다.

설치 명령어에서 환경 변수는 ${PROJECT_CPD_INST_OPERANDS} operands 프로젝트를 가리킵니다.

이 작업을 언제까지 완료해야 하나요?

이 작업을 수행해야 하는지 확인하려면 다음 옵션을 검토하십시오:

  • 여러 서비스를 동시에 설치하려면, 대신 ‘솔루션 및 서비스 일괄 설치 실행’에 설명된 절차를 따르십시오.
  • watsonx Code Assistant for Z 용 Agentic을 일괄 설치의 일부로 설치하지 않은 경우, 이 작업을 완료하여 watsonx Code Assistant for Z 용 Agentic을 환경에 추가하십시오.

    IBM Software Hub필요에 따라 반복하십시오. 여러 인스턴스를 관리하는 경우, 이 작업을 반복하여 클러스터에 watsonx Code Assistant for Z Agentic 인스턴스를 추가로 설치할 수 있습니다.

이 태스크를 완료하는 데 필요한 정보

watsonx Code Assistant for Z Agentic을 설치하기 전에 다음 정보를 확인하십시오:

버전 요구사항

의 IBM Software Hub 인스턴스와 관련된 모든 구성 요소는 동일한 릴리스로 설치되어야 합니다. 예를 들어, 가 IBM Software Hub 버전 5.3.1control plane 으로 설치된 경우, watsonx Code Assistant for Z Agentic을 버전 5.3.1 으로 설치해야 합니다.

환경 변수

이 작업에 포함된 명령어는 환경 변수를 사용하므로, 명령어를 그대로 입력하여 실행할 수 있습니다.

  • 환경 변수를 정의하는 스크립트가 없는 경우, ‘설치 환경 변수 설정’을 참조하십시오.
  • 스크립트의 환경 변수를 사용하려면, 이 작업의 명령어를 실행하기 전에 환경 변수를 불러와야 합니다. 예를 들면, 다음을 실행하십시오.
    source ./cpd_vars.sh
보안 컨텍스트 제한조건

watsonx Code Assistant for Z Agentic은 기본 Red Hat® OpenShift® Container Platform 보안 컨텍스트 제약 조건인 restricted-v2.을 사용합니다.

Common core services

common core serviceswatsonx Code Assistant for Z Agentic에는 이 IBM Software Hub 필요합니다.

해당 인스턴스의 operands 프로젝트에 가 common core services 설치되어 있지 않은 경우, watsonx Code Assistant for Z Agentic을 설치하면 가 common core services 자동으로 설치됩니다. 이 common core services 설치 작업은 완료까지 걸리는 시간을 늘립니다.

스토리지 요구사항
watsonx Code Assistant for Z Agentic을 설치할 때는 스토리지 클래스를 지정해야 합니다. 다음과 같은 스토리지 클래스를 권장합니다. 단, 클러스터에서 이러한 스토리지 클래스를 사용하지 않는 경우, 이에 상응하는 정의가 포함된 스토리지 클래스를 지정해야 합니다.
스토리지 참고 스토리지 클래스
OpenShift Data Foundation 서비스를 설치할 때 파일 스토리지와 블록 스토리지를 지정하십시오.
  • 파일 저장: ocs-storagecluster-cephfs
  • 블록 스토리지: ocs-storagecluster-ceph-rbd
IBM Fusion Data Foundation 서비스를 설치할 때 파일 스토리지와 블록 스토리지를 지정하십시오.
  • 파일 저장: ocs-storagecluster-cephfs
  • 블록 스토리지: ocs-storagecluster-ceph-rbd
IBM Fusion Global Data Platform 서비스를 설치할 때 파일 스토리지와 블록 스토리지에 동일한 스토리지 클래스를 지정하십시오.
  • 파일 저장:

    다음 저장 클래스 중 하나:

    • ibm-spectrum-scale-sc
    • ibm-storage-fusion-cp-sc
  • 블록 스토리지:

    다음 저장 클래스 중 하나:

    • ibm-spectrum-scale-sc
    • ibm-storage-fusion-cp-sc
IBM Storage Scale Container Native 서비스를 설치할 때 파일 스토리지와 블록 스토리지에 동일한 스토리지 클래스를 지정하십시오.
  • 파일 저장: ibm-spectrum-scale-sc
  • 블록 스토리지: ibm-spectrum-scale-sc
Portworx 서비스를 설치할 때 이 --storage_vendor=portworx 옵션을 사용하면 서비스가 올바른 스토리지 클래스를 사용하도록 보장됩니다.
  • 파일 저장: portworx-rwx-gp3-sc
  • 블록 스토리지:
    • portworx-couchdb-sc
    • portworx-elastic-sc
    • portworx-gp3-sc
NFS 서비스를 설치할 때 파일 스토리지와 블록 스토리지에 동일한 스토리지 클래스를 지정하십시오.
  • 파일 저장: managed-nfs-storage
  • 블록 스토리지: managed-nfs-storage
Amazon Elastic 스토리지
서비스를 설치할 때 다음을 지정할 수 있습니다:
  • 파일 저장 전용
  • 파일 스토리지 및 블록 스토리지 (권장)

Amazon Elastic File System파일 저장 공간은 에서 제공합니다. Amazon Elastic Block Store블록 스토리지는 에서 제공합니다.
  • 파일 저장: efs-nfs-client
  • 블록 스토리지:

    다음 저장 클래스 중 하나:

    • gp2-csi
    • gp3-csi
NetApp Trident 서비스를 설치할 때 파일 스토리지와 블록 스토리지에 동일한 스토리지 클래스를 지정하십시오.
  • 파일 저장: ontap-nas
  • 블록 스토리지: ontap-nas
Nutanix 지원되지 않음. 적용할 수 없습니다.

시작하기 전에

이 작업은 다음의 전제 조건이 충족된다고 가정합니다:

시스템 요구사항
이 작업은 클러스터가 watsonx Code Assistant for Z Agentic 의 최소 요구 사항을 충족한다고 가정합니다.
자세한 정보를 찾을 위치
이 작업이 완료되지 않은 경우, 시스템 요구 사항을 참조하십시오.
워크스테이션
이 작업은 설치를 실행할 워크스테이션이 클라이언트 워크스테이션으로 구성되어 있으며, 다음 명령줄 인터페이스를 갖추고 있다고 가정합니다:
  • IBM Software Hub 명령줄 인터페이스: cpd-cli
  • OpenShift 명령줄 인터페이스: oc
  • Helm 명령줄 인터페이스: helm
자세한 정보를 찾을 위치
이 작업이 완료되지 않았다면 ‘클라이언트 워크스테이션 설정’을 참조하십시오.
제어 플레인
이 작업은 가 IBM Software Hub control plane 설치되어 있다고 가정합니다.
자세한 정보를 찾을 위치
이 작업이 완료되지 않은 경우, ‘ IBM 인스턴스 설치 ’ Software Hub 를 참조하십시오.
개인용 컨테이너 레지스트리
사용 중인 환경에서 사설 컨테이너 레지스트리를 사용하는 경우(예: 클러스터가 에어갭 환경인 경우), 이 작업은 다음 작업들이 완료되었다고 가정합니다:
  1. watsonx Code Assistant for Z 의 Agentic 소프트웨어 이미지가 사설 컨테이너 레지스트리에 미러링됩니다.
    자세한 정보를 찾을 위치
    이 작업이 완료되지 않았다면, ‘이미지를 비공개 컨테이너 레지스트리에 미러링하기’를 참조하십시오.
  2. 는 cpd-cli 사설 컨테이너 레지스트리에서 이미지를 olm-utils-v4 가져오도록 구성되어 있습니다.
    자세한 정보를 찾을 위치
    이 작업이 완료되지 않았다면, ‘비공개 컨테이너 레지스트리에서 olm-utils-v4 이미지를 가져오기’를 참조하십시오.
로드 밸런서
watsonx Code Assistant for Z 의 Agentic에 대해 로드 밸런서 타임아웃 설정이 조정되었습니다.
자세한 정보를 찾을 위치
이 작업이 완료되지 않은 경우, ‘로드 밸런서 설정 변경’을 참조하십시오.
SMT 설정
해당되는 경우, 커널 기반 가상 머신(KVM) 지원 시스템 및 빅 코어 PowerVM 지원 시스템에 대한 동시 멀티스레딩(SMT) 설정이 조정됩니다.
자세한 정보를 찾을 위치
이 작업이 완료되지 않은 경우, ‘전원 설정 변경’을 참조하십시오.
Red Hat OpenShift AI
이 작업은 가 설치되어 있다고 Red Hat OpenShift AI 가정합니다.
자세한 정보를 찾을 위치
이 작업이 완료되지 않은 경우, ‘ Red Hat OpenShift AI 설치’를 참조하십시오.
Red Hat OpenShift AI...가 필요한 기능을 사용할 계획이라면, 이 작업은...가 Red Hat OpenShift AI 설치되어 있다고 가정합니다.
자세한 정보를 찾을 위치
이 작업이 완료되지 않은 경우, ‘ Red Hat OpenShift AI 설치’를 참조하십시오.
클러스터 범위 리소스
이 작업은 사용자 정의 리소스 정의, 클러스터 역할, 클러스터 역할 바인딩과 같은 클러스터 범위 리소스가 이미 존재한다고 가정합니다.
자세한 정보를 찾을 위치
이 작업이 완료되지 않은 경우, IBM Software Hub 플랫폼 및 서비스용 클러스터 범위 리소스 생성을 참조하십시오.
이미지 풀 시크릿
이 작업은 인스턴스의 이미지 다운로드 자격 증명이 포함된 비밀 정보가 이미 존재한다고 가정합니다.
자세한 정보를 찾을 위치
이 작업이 완료되지 않은 경우, ‘ IBM 인스턴스용 이미지 풀 시크릿 생성’ Software Hub 문서를 참조하십시오.

전제조건 서비스

watsonx Code Assistant for Z Agentic을 설치하기 전에 다음 서비스가 설치되어 있고 실행 중인지 확인하십시오:

프로시저

watsonx Code Assistant for Z Agentic을 설치하려면 다음 작업을 완료하십시오:

  1. 서비스 설치
  2. 설치 확인
  3. 다음 단계

서비스 설치

watsonx Code Assistant for Z 용 Agentic을 설치하려면:

  1. Red Hat OpenShift Container Platform 클러스터에 로그인하십시오 cpd-cli :
    ${CPDM_OC_LOGIN}
    참고: CPDM_OC_LOGIN 는 명령어의 cpd-cli manage login-to-ocp 별칭입니다.
  2. watsonx Code Assistant for Z Agentic 용 오퍼레이터 및 사용자 정의 리소스를 설치하십시오.

    실행할 명령어는 클러스터의 스토리지 구성에 따라 달라집니다.

    Red Hat OpenShift 데이터 파운데이션 스토리지 
    cpd-cli manage install-components \
--license_acceptance=true \
--components=wca_z_agentic \
--release=${VERSION} \
--patch_id=${PATCH_ID} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET}
    IBM 퓨전 데이터 파운데이션 스토리지 
    cpd-cli manage install-components \
--license_acceptance=true \
--components=wca_z_agentic \
--release=${VERSION} \
--patch_id=${PATCH_ID} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET}
    IBM 퓨전 글로벌 데이터 플랫폼 스토리지
    기억하세요: 스토리지 클래스를 사용할 IBM Fusion Global Data Platform 때, 와 ${STG_CLASS_FILE} 는 모두 ${STG_CLASS_BLOCK} 동일한 스토리지 클래스를 가리키며, 일반적으로 ibm-spectrum-scale-sc 또는 ibm-storage-fusion-cp-sc입니다.
    cpd-cli manage install-components \
--license_acceptance=true \
--components=wca_z_agentic \
--release=${VERSION} \
--patch_id=${PATCH_ID} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET}
    IBM Storage 스케일 컨테이너 네이티브 스토리지
    기억하세요: 스토리지 클래스를 사용할 IBM Storage Scale Container Native 때, 와 ${STG_CLASS_FILE} 는 모두 ${STG_CLASS_BLOCK} 동일한 스토리지 클래스를 가리키며, 일반적으로 ibm-spectrum-scale-sc입니다.
    cpd-cli manage install-components \
--license_acceptance=true \
--components=wca_z_agentic \
--release=${VERSION} \
--patch_id=${PATCH_ID} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET}
    Portworx 스토리지 
    cpd-cli manage install-components \
--license_acceptance=true \
--components=wca_z_agentic \
--release=${VERSION} \
--patch_id=${PATCH_ID} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--storage_vendor=portworx \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET}
    NFS 스토리지
    기억하세요: 스토리지 클래스를 사용할 NFS 때, 와 ${STG_CLASS_FILE} 는 모두 ${STG_CLASS_BLOCK} 동일한 스토리지 클래스를 가리키며, 일반적으로 managed-nfs-storage입니다.
    cpd-cli manage install-components \
--license_acceptance=true \
--components=wca_z_agentic \
--release=${VERSION} \
--patch_id=${PATCH_ID} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET}
    AWS EFS 저장소만 해당
    참고: EFS 스토리지를 사용할 경우, 와 ${STG_CLASS_FILE} 는 모두 ${STG_CLASS_BLOCK} 동일한 스토리지 클래스를 가리키며, 일반적으로 efs-nfs-client입니다.
    cpd-cli manage install-components \
--license_acceptance=true \
--components=wca_z_agentic \
--release=${VERSION} \
--patch_id=${PATCH_ID} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET}
    AWS EFS 및 EBS 스토리지와 함께 
    cpd-cli manage install-components \
--license_acceptance=true \
--components=wca_z_agentic \
--release=${VERSION} \
--patch_id=${PATCH_ID} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET}
    NetApp Trident
    기억하세요: 스토리지 클래스를 사용할 NetApp Trident 때, 와 ${STG_CLASS_FILE} 는 모두 ${STG_CLASS_BLOCK} 동일한 스토리지 클래스를 가리키며, 일반적으로 ontap-nas입니다.
    cpd-cli manage install-components \
--license_acceptance=true \
--components=wca_z_agentic \
--release=${VERSION} \
--patch_id=${PATCH_ID} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET}

설치 확인

watsonx Code Assistant for Z 다음 install-components 명령어가 다음 결과를 반환하면 Agentic이 설치된 것입니다:
[SUCCESS]... The install-components command ran successfully

Completed사용자 정의 리소스의 상태가 인지 확인하려면 다음 cpd-cli manage get-cr-status 명령을 실행할 수 있습니다:

다음에 수행할 작업

이제 watsonx Code Assistant for Z Agentic을 사용해 보실 수 있습니다. 자세한 내용은 ‘ watsonx Code Assistant for Z 의 설치 후 설정’을 참조하십시오