다음 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 용 서비스 인스턴스를 생성하기 전에 다음 정보를 확인하십시오:

버전 요구사항

인스턴스와 관련된 모든 구성 요소는 동일한 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 프로필을 생성했습니다.

이 프로필은 에서 '서비스 인스턴스 생성'can_provision 권한을 IBM Software Hub가진 사용자와 연결되어야 합니다.

이 작업이 완료되지 않은 경우, cpd-cli 관리 명령을 사용하려면 프로필 만들기를 참조하십시오.

프로시저

서비스 인스턴스를 생성하려면 다음 작업을 완료하십시오:

  1. 서비스 인스턴스 작성
  2. 서비스 인스턴스가 생성되었는지 확인
  3. 다음에 수행할 작업

서비스 인스턴스 작성

서비스 인스턴스를 작성하려면 다음을 수행하십시오.

  1. 서비스 인스턴스 페이로드를 정의하는 JSON 파일을 생성할 워크스테이션의 디렉터리로 이동하십시오.
  2. 서비스 인스턴스의 JSON 페이로드를 구성하는 데 사용되는 환경 변수를 설정합니다:
    1. 서비스 인스턴스의 표시 이름으로 사용할 고유한 이름을 환경 INSTANCE_NAME 변수에 설정하십시오:
      export INSTANCE_NAME="<display-name>"

      이 이름은 웹 IBM Software Hub 클라이언트의 ‘인스턴스’ 페이지에 표시됩니다.

      표시 이름은 string 이며, 영문자와 숫자(a-z, A-Z, 0-9), 공백( ), 하이픈(-), 밑줄(_), 마침표(.)를 포함할 수 있습니다. 앞의 export 명령어에서 보여준 것처럼 표시 이름을 반드시 따옴표로 묶어야 합니다.

    2. 클러스터에 IBM Software Hub 설치된 의 버전과 일치하는 버전으로 환경 INSTANCE_VERSION 변수를 설정하십시오:
      export INSTANCE_VERSION=<version>

      다음 표를 참고하여 적절한 값을 결정하십시오:

      IBM Software Hub버전 서비스 인스턴스 버전
      5.3.1 9.1.0
      5.3.0 9.0.0
    3. 환경 INSTANCE_SIZE 변수를 설정하십시오. 크기에 따라 서비스 인스턴스에 할당되는 리소스가 결정됩니다.
      export INSTANCE_SIZE=<size>
      유효값은 다음과 같습니다.
      • small_mincpureq
      • small
      • medium
      • large
      • xlarge

      각 크기와 관련된 리소스에 대한 자세한 내용은 구성 요소 크기 조정 가이드 PDF 를 참조하십시오. 이 IBM Entitled Registry문서는 에서 다운로드할 수 있습니다.

    4. 서비스 인스턴스가 사용자 워크로드에 따라 자동으로 확장되도록 할지 여부에 따라 환경 AUTO_SCALE 변수를 설정하십시오:
      인스턴스를 자동으로 확장합니다
      export AUTO_SCALE=true
      서비스 인스턴스를 자동으로 확장하지 마십시오
      export AUTO_SCALE=false
  3. 페이로드 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}
  4. 작업station에 있는 JSON 페이로드 파일의 전체 경로를 환경 PAYLOAD_FILE 변수에 설정하십시오:
    export PAYLOAD_FILE=<fully-qualified-JSON-file-name>
  5. 페이로드 파일에서 서비스 인스턴스를 생성합니다:
    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 포드의 로그를 확인하여 원인을 파악하십시오.

다음에 수행할 작업