에이전틱 watsonx Code Assistant for Z 설치

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

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

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

인스턴스에 대한 운영자 프로젝트

이 Agentic watsonx Code Assistant for Z 인스턴스의 연산자는 operators 프로젝트에 설치됩니다.

설치 명령어에서 환경 ${PROJECT_CPD_INST_OPERATORS} 변수 `$PATH`는 운영자의 프로젝트를 가리킵니다.

인스턴스에 대한 피연산자 프로젝트

사용자 정의 리소스인 및 watsonx Code Assistant for Z control plane Agentic은 operands 프로젝트에 설치됩니다.

설치 명령어에서 환경 변수 ` ${PROJECT_CPD_INST_OPERANDS} $PATH`는 작업 대상 프로젝트를 가리킵니다.

이 작업을 언제까지 완료해야 합니까?

다음 옵션을 검토하여 이 작업을 완료해야 하는지 여부를 결정하십시오:

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

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

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

Agentic watsonx Code Assistant for Z 설치 전에 다음 정보를 검토하십시오:

버전 요구사항

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

환경 변수

이 작업의 명령어는 환경 변수를 사용하므로, 작성된 그대로 정확히 실행할 수 있습니다.

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

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

Common core services

watsonx Code Assistant for Z Agentic은 을 필요로 IBM Software Hubcommon core services 합니다.

해당 인스턴스의 오퍼랜드 common core services 프로젝트에 설치되지 않은 경우, Agentic watsonx Code Assistant for Z 설치 시 자동으로 설치됩니다 common core services . 설치 common core services 시간이 늘어납니다.

스토리지 요구사항
Agentic을 watsonx Code Assistant for Z 설치할 때 저장 클래스를 지정해야 합니다. 다음 저장 클래스를 권장합니다. 그러나 클러스터에서 이러한 스토리지 클래스를 사용하지 않는 경우, 동등한 정의의 스토리지 클래스를 반드시 지정해야 합니다.
스토리지 참고 스토리지 클래스
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 CLI: cpd-cli
  • OpenShift CLI: oc
  • Helm CLI: helm
자세한 정보를 찾을 위치
이 작업이 완료되지 않은 경우, 클라이언트 워크스테이션 설정을 참조하십시오.
제어 플레인
이 작업은 가 IBM Software Hubcontrol plane 설치되어 있다고 가정합니다.
자세한 정보를 찾을 위치
이 작업이 완료되지 않은 경우, 의 인스턴스 설치를 IBMSoftware Hub 참조하십시오.
개인용 컨테이너 레지스트리
사용 중인 환경이 사설 컨테이너 레지스트리를 사용하는 경우(예: 클러스터가 에어갭 상태인 경우), 이 작업은 다음 작업들이 완료되었음을 전제로 합니다:
  1. 에이전틱 소프트웨어 watsonx Code Assistant for Z 이미지는 사설 컨테이너 레지스트리에 미러링됩니다.
    자세한 정보를 찾을 위치
    이 작업이 완료되지 않은 경우, '이미지를 개인 컨테이너 레지스트리로 미러링하기'를 참조하십시오.
  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 있다고 가정합니다.
자세한 정보를 찾을 위치
이 작업이 완료되지 않은 경우, AI Red Hat OpenShift 설치를 참조하십시오.
특정 기능을 Red Hat OpenShift AI사용하려는 경우, 이 작업은 해당 기능이 설치되어 있음을 Red Hat OpenShift AI 전제로 합니다.
자세한 정보를 찾을 위치
이 작업이 완료되지 않은 경우, AI Red Hat OpenShift 설치를 참조하십시오.
클러스터 범위 리소스
이 작업은 사용자 정의 리소스 정의, 클러스터 역할, 클러스터 역할 바인딩과 같은 클러스터 범위 리소스가 존재한다고 가정합니다.
자세한 정보를 찾을 위치
이 작업이 완료되지 않은 경우, 플랫폼 IBMSoftware Hub 및 서비스를 위한 클러스터 범위 리소스 생성을 참조하십시오.
이미지 풀 시크릿
이 작업은 인스턴스의 이미지 풀 자격 증명을 포함하는 시크릿이 존재한다고 가정합니다.
자세한 정보를 찾을 위치
이 작업이 완료되지 않은 경우, 인스턴스에 대한 이미지 풀 시크릿 IBMSoftware Hub 생성을 참조하십시오.

전제조건 서비스

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

프로시저

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

  1. 서비스 설치
  2. 설치 검증
  3. 다음에 무엇을 해야 할까

서비스 설치

에이전틱 watsonx Code Assistant for Z 설치 방법:

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

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

    Red Hat OpenShift 데이터 파운데이션 스토리지 
    cpd-cli manage install-components \
--license_acceptance=true \
--components=wca_z_agentic \
--release=${VERSION} \
--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} \
--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 Fusion Global Data Platform 를 사용할 때, 와 ${STG_CLASS_FILE}${STG_CLASS_BLOCK} 는 동일한 스토리지 클래스(storage class)를 가리킵니다. 일반적으로 ibm-spectrum-scale-sc 또는 ibm-storage-fusion-cp-sc입니다.
    cpd-cli manage install-components \
--license_acceptance=true \
--components=wca_z_agentic \
--release=${VERSION} \
--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 스케일 컨테이너 네이티브 스토리지
    기억하세요: 스토리지(storage) IBM Storage Scale Container Native 를 사용할 때, 와 ${STG_CLASS_BLOCK} 는 동일한 스토리지 ${STG_CLASS_FILE} 클래스(일반적으로 ibm-spectrum-scale-sc)를 가리킵니다.
    cpd-cli manage install-components \
--license_acceptance=true \
--components=wca_z_agentic \
--release=${VERSION} \
--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} \
--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 스토리지
    기억하세요: 스토리지(storage) NFS 를 사용할 때, 와 ${STG_CLASS_BLOCK} 는 동일한 스토리지 ${STG_CLASS_FILE} 클래스(일반적으로 managed-nfs-storage)를 가리킵니다.
    cpd-cli manage install-components \
--license_acceptance=true \
--components=wca_z_agentic \
--release=${VERSION} \
--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 저장만 가능
    기억하세요: 스토리지(storage) EFS 를 사용할 때, 와 ${STG_CLASS_BLOCK} 는 동일한 스토리지 ${STG_CLASS_FILE} 클래스(일반적으로 efs-nfs-client)를 가리킵니다.
    cpd-cli manage install-components \
--license_acceptance=true \
--components=wca_z_agentic \
--release=${VERSION} \
--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} \
--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
    기억하세요: 스토리지(storage) NetApp Trident 를 사용할 때, 와 ${STG_CLASS_BLOCK} 는 동일한 스토리지 ${STG_CLASS_FILE} 클래스(일반적으로 ontap-nas)를 가리킵니다.
    cpd-cli manage install-components \
--license_acceptance=true \
--components=wca_z_agentic \
--release=${VERSION} \
--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 Agentic은 다음 install-components 명령어가 반환될 때 설치됩니다:
[SUCCESS]... The install-components command ran successfully

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

다음에 수행할 작업

이제 watsonx Code Assistant for Z Agentic을 사용하기 시작할 수 있습니다. 자세한 내용은 watsonx Code Assistant for Z Agentic 설치 후 설정을 참조하십시오