다음 cpd-cli
service-instance
create 명령어를 사용하여 Product Master 의 서비스 인스턴스를 생성합니다
Product Master 를 설치한 후에는 operands 프로젝트에 Product Master 서비스 인스턴스를 생성해야 합니다. 사용자라면 IBM® Software
Hub 명령을 cpd-cli
service-instance
create 사용하여 서비스 인스턴스를 생성하는 과정을 스크립트로 작성할 수 있습니다.
- 누가 이 작업을 완료해야 합니까?
- 를 사용하여 서비스
cpd-cli인스턴스를 생성하려면, 에서 ‘서비스 IBM Software Hub인스턴스 생성(can_provision)’ 권한이 있어야 합니다.
- 이 작업을 언제까지 완료해야 하나요?
- 다음
cpd-cli service-instance create명령어를cpd-cli사용하여 서비스 인스턴스를 생성하려는 경우에만 이 작업을 수행하십시오.
서비스 인스턴스를 생성하는 다른 방법
- 웹 클라이언트에서. 자세한 내용은 웹 클라이언트에서 ‘ Product Master ’ 서비스 인스턴스 만들기를 참조하십시오.
- REST API
/v3/service_instances호출을 사용하여. 자세한 내용은 ‘ Product Master 용 서비스 인스턴스를 프로그래밍 방식으로 만들기’를 참조하세요. - 명령을
cpd-cli manage apply-cr사용하여. 자세한 내용은 cpd-cli manage apply-cr 명령을 사용하여 Product Master 용 서비스 인스턴스를 생성하는 방법을 참조하십시오.
이 태스크를 완료하는 데 필요한 정보
Product Master 용 서비스 인스턴스를 생성하기 전에 다음 정보를 확인하십시오:
- 버전 요구사항
인스턴스와 관련된 모든 구성 요소는 동일한 IBM Software Hub 릴리스에서 설치되거나 생성되어야 합니다. 예를 들어, Product Master 가 버전 5.3.1 으로 설치된 경우, 서비스 인스턴스는 버전 5.3.1 으로 생성해야 합니다.
중요: Product Master 는. IBM Software Hub와 다른 버전 번호를 사용합니다. 이 항목에는 각 갱신 시의 IBM Software Hub. Product Master 버전을 보여주는 표가 포함되어 있습니다. 이 표를 참고하여 설치된 IBM Software Hub 버전에 맞는 올바른 버전을 확인하십시오.
- 환경 변수
이 작업에 포함된 명령어는 환경 변수를 사용하므로, 명령어를 작성된 그대로 실행할 수 있습니다.
- 환경 변수를 정의하는 스크립트가 없다면, ‘설치 환경 변수 설정’을 참조하십시오.
- 스크립트의 환경 변수를 사용하려면, 이 작업의 명령을 실행하기 전에 환경 변수를 불러와야 합니다. 예를 들면, 다음을 실행하십시오.
source ./cpd_vars.sh
시작하기 전에
이 작업은 다음의 전제 조건이 충족된다고 가정합니다:
| 필수 소프트웨어 | 자세한 정보를 찾을 위치 |
|---|---|
| Product Master 설치되어 있습니다. | 이 작업이 완료되지 않았다면, ‘ Product Master 설치’를 참조하십시오. |
서비스 인스턴스를 생성할 워크스테이션에 명령줄 cpd-cli 인터페이스가 설치되어 있습니다. |
이 작업이 완료되지 않았다면, ‘클라이언트 워크스테이션 설정’을 참조하십시오. |
| 서비스 인스턴스를 생성할 워크스테이션에 사용자 IBM Software
Hub 프로필을 생성했습니다. 이 프로필은 에서 '서비스 인스턴스 생성' |
이 작업이 완료되지 않은 경우, cpd-cli 관리 명령을 사용하려면 프로필 만들기를 참조하십시오. |
프로시저
서비스 인스턴스를 생성하려면 다음 작업을 완료하십시오:
서비스 인스턴스 작성
서비스 인스턴스를 작성하려면 다음을 수행하십시오.
- 서비스 인스턴스 페이로드를 정의하는 JSON 파일을 생성할 워크스테이션의 디렉터리로 이동하십시오.
- 서비스 인스턴스의 JSON 페이로드를 구성하는 데 사용되는 환경 변수를 설정합니다:
- 서비스 인스턴스의 표시 이름으로 사용할 고유한 이름을 환경
INSTANCE_NAME변수에 설정하십시오:export INSTANCE_NAME="<display-name>"이 이름은 웹 IBM Software Hub 클라이언트의 ‘인스턴스’ 페이지에 표시됩니다.
표시 이름은
string이며, 영문자와 숫자(a-z, A-Z, 0-9), 공백( ), 하이픈(-), 밑줄(_), 마침표(.)를 포함할 수 있습니다. 앞의export명령어에서 보여준 것처럼 표시 이름을 반드시 따옴표로 묶어야 합니다. - 클러스터에 IBM Software
Hub 설치된 의 버전과 일치하는 버전으로 환경
INSTANCE_VERSION변수를 설정하십시오:export INSTANCE_VERSION=<version>다음 표를 참고하여 적절한 값을 결정하십시오:
IBM Software Hub버전 서비스 인스턴스 버전 5.3.1 9.1.0 5.3.0 9.0.0 - 환경
INSTANCE_SIZE변수를 설정하십시오. 크기에 따라 서비스 인스턴스에 할당되는 리소스가 결정됩니다.export INSTANCE_SIZE=<size>유효값은 다음과 같습니다.small_mincpureqsmallmediumlargexlarge
각 크기와 관련된 리소스에 대한 자세한 내용은 구성 요소 크기 조정 가이드 PDF 를 참조하십시오. 이 IBM Entitled Registry문서는 에서 다운로드할 수 있습니다.
- 서비스 인스턴스가 사용자 워크로드에 따라 자동으로 확장되도록 할지 여부에 따라 환경
AUTO_SCALE변수를 설정하십시오:- 인스턴스를 자동으로 확장합니다
export AUTO_SCALE=true- 서비스 인스턴스를 자동으로 확장하지 마십시오
export AUTO_SCALE=false
- 서비스 인스턴스의 표시 이름으로 사용할 고유한 이름을 환경
- 페이로드
product-master-instance.json파일을 생성합니다:cat << EOF > ./product-master-instance.json{ "addon_type": "productmaster", "display_name": "${INSTANCE_NAME}", "namespace": "${PROJECT_CPD_INST_OPERANDS}", "addon_version": "${INSTANCE_VERSION}", "create_arguments": { "deployment_id": "${PROJECT_CPD_INST_OPERANDS}-pm", "metadata": { "scaleConfig": "${INSTANCE_SIZE}", "shutdown": "false", "autoScaleConfig": "${AUTO_SCALE}", "fileStorageClass": "${STG_CLASS_FILE}", "blockStorageClass": "${STG_CLASS_BLOCK}" } } } EOF다음 환경 변수들은 설치 환경 변수 스크립트에 이미 정의된 값을 사용합니다:${PROJECT_CPD_INST_OPERANDS}${STG_CLASS_BLOCK}${STG_CLASS_FILE}
- 작업station에 있는 JSON 페이로드 파일의 전체 경로를 환경
PAYLOAD_FILE변수에 설정하십시오:export PAYLOAD_FILE=<fully-qualified-JSON-file-name> - 페이로드 파일에서 서비스 인스턴스를 생성합니다:
cpd-cli service-instance create \ --profile=${CPD_PROFILE_NAME} \ --from-source=${PAYLOAD_FILE}
서비스 인스턴스가 생성되었는지 확인
서비스 인스턴스가 생성되었는지 확인하려면 다음 명령을 실행하십시오:
cpd-cli service-instance status ${INSTANCE_NAME} \
--profile=${CPD_PROFILE_NAME} \
--output=json
- 명령어가 를 반환하면
PROVISIONED, 서비스 인스턴스가 성공적으로 생성된 것입니다. - 명령어가 오류를 반환하면
PROVISION_IN_PROGRESS, 몇 분 정도 기다렸다가 명령어를 다시 실행하십시오. - 명령어가 를 반환하면
FAILED, 및zen-watcherzen-core-api포드의 로그를 확인하여 원인을 파악하십시오.