프로그래밍 방식으로 Data Gate 에 대한 서비스 인스턴스 작성
설치 Data Gate 후에는 operands 프로젝트에 최소한 하나의 Data Gate 서비스 인스턴스를 생성해야 합니다. 사용자라면 IBM® Software
Hub REST /v3/service_instances API 호출을 사용하여 프로그래밍 방식으로 서비스 인스턴스를 생성할 수 있습니다.
- 이 태스크를 완료해야 하는 사용자
/v3/service_instancesREST API 호출을 사용하여 프로그래밍 방식으로 서비스 인스턴스를 작성하려면 IBM Software Hub에 서비스 인스턴스 작성 (can_provision) 권한이 있어야 합니다.
- 언제 이 태스크를 완료해야 합니까?
/v3/service_instancesREST API 호출을 사용하여 프로그래밍 방식으로 서비스 인스턴스를 작성하려는 경우에만 이 태스크를 완료하십시오.
서비스 인스턴스 작성을 위한 대체 방법
- 웹 클라이언트에서. 자세한 정보는 웹 클라이언트에서 Data Gate 에 대한 서비스 인스턴스 작성을 참조하십시오.
cpd-cli service-instance create명령을 사용합니다. 자세한 정보는 cpd-cli service-instance create 명령을 사용하여 Data Gate 에 대한 서비스 인스턴스 작성을 참조하십시오.
이 태스크를 완료하는 데 필요한 정보
Data Gate에 대한 서비스 인스턴스를 작성하기 전에 다음 정보를 검토하십시오.
- 버전 요구사항
IBM Software Hub 의 인스턴스와 연관된 모든 구성요소는 동일한 릴리스에서 설치되거나 작성되어야 합니다. 예를 들어, 가 버전 으로 Data Gate 5.3.1 설치된 경우, 서비스 인스턴스를 버전 으로 5.3.1 생성해야 합니다.
중요: Data Gate 는 IBM Software Hub와 다른 버전 번호를 사용합니다. 이 주제에는 IBM Software Hub의 각 새로 고치기에 대한 Data Gate 버전을 표시하는 표가 포함되어 있습니다. 이 테이블을 사용하여 설치된 IBM Software Hub 의 버전을 기반으로 올바른 버전을 찾으십시오.
- 환경 변수
이 태스크의 명령은 작성된 대로 정확하게 명령을 실행할 수 있도록 환경 변수를 사용합니다.
- 환경 변수를 정의하는 스크립트가 없는 경우 설치 환경 변수 설정을 참조하십시오.
- 스크립트의 환경 변수를 사용하려면 이 태스크에서 명령을 실행하기 전에 환경 변수의 소스를 지정해야 합니다. 예를 들면, 다음을 실행하십시오.
source ./cpd_vars.sh
시작하기 전에
이 태스크에서는 다음 전제조건이 충족되었다고 가정합니다.
| 필수 소프트웨어 | 자세한 정보를 찾을 위치 |
|---|---|
| Data Gate 가 설치되어 있습니다. | 이 태스크가 완료되지 않은 경우 Data Gate를 참조하십시오. |
Data Gate 인스턴스에 대한 대상 데이터베이스를 작성하십시오.
작성한 데이터베이스의 표시 이름 및 배치 ID가 있는지 확인하십시오. Data Gate 서비스 인스턴스를 작성하려면 이 정보가 필요합니다. |
이 태스크가 완료되지 않은 경우 작성해야 하는 데이터베이스 유형에 대한 적절한 주제를 참조하십시오. |
| 네트워크 액세스 구성 | 귀하(또는 네트워크 관리자)가 아직 와 Db2 for z/OSData Gate 인스턴스 간 네트워크 액세스를 구성하지 않은 경우, 와 Data Gate 간 네트워크 액세스 구성에 IBM Z 명시된 절차를 따르십시오. |
| API키를 생성했습니다. API키는 IBM Software
Hub에서 서비스 인스턴스 작성 ( |
이 작업이 완료되지 않은 경우, API 인증 토큰 생성을 참조하십시오. |
| 소스 Db2 for z/OS 하위 시스템에서 Connect 라이선스를 Db2 활성화하십시오 | 새 Data Gate 인스턴스의 데이터 소스 역할을 하는 하위 Db2 for z/OS 시스템에서 유효한 Db2 Connect 라이선스를 아직 활성화하지 않은 경우(또는 데이터베이스 관리자가 활성화하지 않은 경우), 하위 Db2 for z/OS 시스템에서 Connect Db2 Unlimited 라이선스 활성화에 명시된 절차를 따르십시오. |
프로시저
서비스 인스턴스를 작성하려면 다음 태스크를 완료하십시오.
서비스 인스턴스 작성
서비스 인스턴스를 작성하려면 다음을 수행하십시오.
- 서비스 인스턴스 페이로드를 정의하는 JSON 파일을 작성할 워크스테이션의 디렉토리로 변경하십시오.
- 서비스 인스턴스가 사용자가 작성한 대상 데이터베이스에 연결하는 데 사용할 수 있는 시크릿을 작성하십시오.
CPD_ROUTE환경 변수를 설정하십시오.export CPD_ROUTE=$(oc get route cpd -n ${PROJECT_CPD_INST_OPERANDS} -o jsonpath={".spec.host"})명령은 설치 환경 변수 스크립트에 이미 정의되어 있는
PROJECT_CPD_INST_OPERANDS변수를 사용합니다.API_KEY환경 변수를 사용자가 작성한 API키로 설정하십시오.export API_KEY=<your_api_key>DATABASE_ID환경 변수를 이 서비스 인스턴스에 대해 작성한 데이터베이스의 배치 ID로 설정하십시오.export DATABASE_ID=<database-id>다음 명령을 실행하여 IBM Software Hub의 이 인스턴스에 배치된 데이터베이스 목록을 가져오십시오.
oc get db2u -n ${PROJECT_CPD_INST_OPERANDS}NAME열의 값을 사용하십시오.- Db2 데이터베이스
- ID의 형식은
db2oltp-<unique-id>입니다. - Db2 Warehouse 데이터베이스
- ID의 형식은
db2wh-<unique-id>입니다.
- 시크릿을 작성하십시오.
실행하는 명령은 서비스 인스턴스를 작성하려는 IBM Software Hub 의 인스턴스가 자체 서명 인증서를 사용하는지 또는 신뢰할 수 있는 인증 기관에서 서명한 인증서를 사용하는지에 따라 다릅니다.
인스턴스가 신뢰할 수 있는 인증 기관에서 서명한 인증서를 사용합니다.
curl -X POST https://${CPD_ROUTE}/data-gate/api/${PROJECT_CPD_INST_OPERANDS}/${DATABASE_ID}/secret \ -H "Authorization: ZenApiKey ${API_KEY}" \ -H 'cache-control: no-cache' \ -H 'content-type: application/json'
인스턴스가 자체 서명된 인증서를 사용합니다 (기본값).
curl -k -X POST https://${CPD_ROUTE}/data-gate/api/${PROJECT_CPD_INST_OPERANDS}/${DATABASE_ID}/secret \ -H "Authorization: ZenApiKey ${API_KEY}" \ -H 'cache-control: no-cache' \ -H 'content-type: application/json'
- 요청이 성공하면 명령은 다음 응답 메시지를 리턴합니다.
{"result":"success","message":"create secret successfully"} - 요청에 실패한 경우 응답을 사용하여 이유를 판별하십시오.
- 요청이 성공하면 명령은 다음 응답 메시지를 리턴합니다.
- 시크릿이 작성되었는지 확인하십시오.
oc get secret -n ${PROJECT_CPD_INST_OPERANDS} | grep dg-${DATABASE_ID}-adminusertoken시크릿이 있는 경우 명령은 시크릿에 대한 정보를 리턴합니다.
- 서비스 인스턴스에 대한 JSON 페이로드를 채우는 데 사용되는 환경 변수를 설정하십시오.
INSTANCE_NAME환경 변수를 서비스 인스턴스의 표시 이름으로 사용할 고유 이름으로 설정하십시오.export INSTANCE_NAME=<display-name>이 이름은 IBM Software Hub 웹 클라이언트의 인스턴스 페이지에 표시됩니다.
표시 이름은
string이며 영숫자 문자 (a-z, A-Z, 0-9) 및 대시 (-) 만 포함할 수 있습니다. 이름은 영숫자로 시작하고 끝나야 합니다.INSTANCE_VERSION환경 변수를 클러스터의 IBM Software Hub 버전에 해당하는 버전으로 설정하십시오.export INSTANCE_VERSION=<version>다음 표를 사용하여 적절한 값을 판별하십시오.
IBM Software Hub버전 서비스 인스턴스 버전 5.3.1 9.1.0 5.3.0 9.0.0 INSTANCE_CPU환경 변수를 서비스 인스턴스에 할당할 CPU양으로 설정하십시오.export INSTANCE_CPU=<integer>2-32사이의 정수를 지정하십시오.
워크로드에 따라 인스턴스의 크기를 조정하십시오. 서비스 인스턴스에 할당할 CPU수에 대한 자세한 정보는 IBM Entitled Registry에서 다운로드할 수 있는 컴포넌트 스케일링 안내 PDF를 참조하십시오.
- 설정한 값을 기반으로 다음 스크립트에 정의된 추가 환경 변수를 설정하고 사용하려면
INSTANCE_CPU환경 변수, 당신은해야합니다source다음 스크립트:#!/bin/bash # export INSTANCE_CPU=$1 case $INSTANCE_CPU in 2) stunnel_cpu=0.3 server_cpu=0.65 apply_cpu=0.55 api_cpu=0.3 ui_cpu=0.1 ;; 3) stunnel_cpu=0.5 server_cpu=0.95 apply_cpu=0.95 api_cpu=0.4 ui_cpu=0.1 ;; 4) stunnel_cpu=0.7 server_cpu=1.35 apply_cpu=1.35 api_cpu=0.4 ui_cpu=0.1 ;; 5) stunnel_cpu=1.0 server_cpu=1.65 apply_cpu=1.65 api_cpu=0.4 ui_cpu=0.2 ;; 6) stunnel_cpu=1.2 server_cpu=2.05 apply_cpu=2.05 api_cpu=0.4 ui_cpu=0.2 ;; 7) stunnel_cpu=1.4 server_cpu=2.45 apply_cpu=2.45 api_cpu=0.4 ui_cpu=0.2 ;; 8) stunnel_cpu=1.6 server_cpu=2.85 apply_cpu=2.85 api_cpu=0.4 ui_cpu=0.2 ;; 9) stunnel_cpu=1.8 server_cpu=3.25 apply_cpu=3.25 api_cpu=0.4 ui_cpu=0.2 ;; 10) stunnel_cpu=2.0 server_cpu=3.65 apply_cpu=3.65 api_cpu=0.4 ui_cpu=0.2 ;; *) stunnel_cpu=2.0 server_cpu=`echo "scale=2;3.65+($INSTANCE_CPU-10)/2" | bc` apply_cpu=$server_cpu api_cpu=0.4 ui_cpu=0.2 ;; esac stunnel_cpu=`echo "${stunnel_cpu}*1000" | bc` server_cpu=`echo "${server_cpu}*1000" | bc` apply_cpu=`echo "${apply_cpu}*1000" | bc` api_cpu=`echo "${api_cpu}*1000" | bc` ui_cpu=`echo "${ui_cpu}*1000" | bc` export STUNNEL_CPU=${stunnel_cpu%.*} export SERVER_CPU=${server_cpu%.*} export APPLY_CPU=${apply_cpu%.*} export API_CPU=${api_cpu%.*} export UI_CPU=${ui_cpu%.*} # echo "STUNNEL_CPU: ${STUNNEL_CPU}" # echo "SERVER_CPU: ${SERVER_CPU}" # echo "APPLY_CPU: ${APPLY_CPU}" # echo "API_CPU: ${API_CPU}" # echo "UI_CPU: ${UI_CPU}" INSTANCE_MEMORY환경 변수를 서비스 인스턴스에 할당할 메모리 크기로 설정하십시오.export INSTANCE_MEMORY=<integer>13Gi-32Gi사이의 값을 지정하십시오. 값을 정수로 지정하십시오. 측정 단위를 생략하십시오.
워크로드에 따라 인스턴스의 크기를 조정하십시오. 서비스 인스턴스에 할당할 메모리 양에 대한 자세한 정보는 IBM Entitled Registry에서 다운로드할 수 있는 컴포넌트 스케일링 안내 PDF를 참조하십시오.
INSTANCE_MEMORY환경 변수에 설정한 값을 기반으로 다음 환경 변수를 설정하십시오.SERVER_MEMORY환경 변수를 다음 방정식으로 설정하십시오.export SERVER_MEMORY=$(bc <<< "scale=1; 3.5 + (${INSTANCE_MEMORY} - 13) / 2")APPLY_MEMORY환경 변수를 다음 방정식으로 설정하십시오.export APPLY_MEMORY=$(bc <<< "scale=1; 7 + (${INSTANCE_MEMORY} - 13) / 2")
DATABASE_NAME환경 변수를 이 서비스 인스턴스에 대해 작성한 데이터베이스의 표시 이름으로 설정하십시오.export DATABASE_NAME="<display-name>"이 이름은 IBM Software Hub 웹 클라이언트의 데이터베이스 페이지에 표시됩니다.
표시 이름은
string이며 영숫자 문자 (a-z, A-Z, 0-9), 공백 (), 대시 (-), 밑줄 (_) 및 마침표 (.) 를 포함할 수 있습니다. 앞의export명령에 표시된 대로 표시 이름을 따옴표로 묶어야 합니다.DATABASE_ENGN_SVC환경 변수를 데이터베이스와 연관된engn-svc서비스의 이름으로 설정하십시오.- Db2 데이터베이스
export DATABASE_ENGN_SVC=c-${DATABASE_ID}-db2u-engn-svc- Db2 Warehouse SMP 데이터베이스
export DATABASE_ENGN_SVC=c-${DATABASE_ID}-db2u-engn-svc- Db2 Warehouse MPP 데이터베이스
export DATABASE_ENGN_SVC=c-${DATABASE_ID}-db2u-head-engn-svc
DB_ENCODING환경 변수를 설정하십시오.- Db2 데이터베이스
export DB_ENCODING=UNICODE- Db2 Warehouse 데이터베이스
쿼리 가속화를 위해 Data Gate 의 이 인스턴스를 사용할지 여부를 결정하십시오. 조회 가속화에 이 인스턴스를 사용하려면 인코딩을 EBCDIC로 설정하십시오. 그렇지 않으면 인코딩을 UNICODE로 설정하십시오.
- EBCDIC
export DB_ENCODING=EBCDIC- UNICODE
export DB_ENCODING=UNICODE
INSTANCE_ROUTE환경 변수를 설정하십시오.- IBM Software
Hub 라우트를 가져오십시오.
oc get route cpd --namespace=${PROJECT_CPD_INST_OPERANDS}디폴트 라우트를 사용한다고 가정하면 라우트의 형식은 다음과 같습니다.https://cpd-namespace.apps.OCP-default-domain - 텍스트 편집기의 IBM Software
Hub 라우트에서 다음 요소를 제거하십시오.
https://cpd-namespace.라우트의 나머지 부분의 형식은 다음과 같습니다.
apps.OCP-default-domain ROUTE_SUBDOMAIN환경 변수를 라우트의 나머지 부분으로 설정하십시오.export ROUTE_SUBDOMAIN=<remaining-portion-of-the-route>
- IBM Software
Hub 라우트를 가져오십시오.
ROUTE_PREFIX환경 변수를 이 Data Gate 인스턴스의 고유 ID로 설정하십시오.export ROUTE_PREFIX=<unique-identifier>ID에는 소문자 영숫자 문자 (a-z, 0-9) 및 대시 (-) 가 포함될 수 있습니다. ID는 영숫자로 시작하고 끝나야 합니다.
ROUTE_PORT환경 변수를 원격 Db2 for z/OS 클러스터에서 수신되는 통신을 허용하기 위해 연 포트로 설정하십시오.export ROUTE_PORT=<port-number>- 서비스 인스턴스를 대상 데이터베이스와 동일한 노드에서 실행할지 여부에 따라
NODE_AFFINITY환경 변수를 설정하십시오.- 대상 데이터베이스와 동일한 노드에서 서비스 인스턴스 실행
export NODE_AFFINITY=true- 임의의 노드에서 서비스 인스턴스 실행
export NODE_AFFINITY=false
- 서비스 인스턴스를 작성할 때 새 스토리지를 프로비저닝할지 또는 기존 스토리지를 사용할지에 따라 적절한 환경 변수를 지정하십시오.
- 새 스토리지 프로비저닝
INSTANCE_STORAGE환경 변수를 서비스 인스턴스에 할당할 스토리지 크기로 설정하십시오.export INSTANCE_STORAGE=<size>50Gi는 대부분의 환경에서 충분합니다. 값을 정수로 지정하십시오. 측정 단위를 생략하십시오.
- 기존 스토리지 사용
INSTANCE_PVC_NAME환경 변수를 서비스 인스턴스에 스토리지를 할당하는 데 사용할 지속적 볼륨 청구의 이름으로 설정하십시오.export INSTANCE_PVC_NAME=<existing-pvc-name>PVC는 파일 스토리지를 가리켜야 합니다.
data-gate-instance.json페이로드 파일을 작성하십시오.실행하는 명령은 서비스 인스턴스에 대한 스토리지를 프로비저닝하는 방법에 따라 다릅니다.
스토리지 클래스를 사용하여 자동으로 스토리지를 프로비저닝합니다.
cat << EOF > ./data-gate-instance.json{ "addon_type": "dg", "display_name": "${INSTANCE_NAME}", "namespace": "${PROJECT_CPD_INST_OPERANDS}", "addon_version": "${INSTANCE_VERSION}", "preExistingOwner": false, "create_arguments": { "resources" : { "cpu" : "${INSTANCE_CPU}", "memory" : "${INSTANCE_MEMORY}" }, "metadata": { "arch" : "${IMAGE_ARCH}", "baseNamespace" : "${PROJECT_CPD_INST_OPERANDS}", "cpu" : "${INSTANCE_CPU}", "databaseEngineService" : "${DATABASE_ENGN_SVC}", "databaseSecureJdbcPort" : "50001", "dataGateInstanceName": "${INSTANCE_NAME}", "data_gate_database_name": "${DATABASE_NAME}", "defaultRouteSubdomain" : "${ROUTE_SUBDOMAIN}", "targetDbEncoding" : "${DB_ENCODING}", "images_stunnel_limit_cpu" : "${STUNNEL_CPU}m", "images_stunnel_request_cpu" : "${STUNNEL_CPU}m", "images_server_limit_cpu" : "${SERVER_CPU}m", "images_server_limit_memory" : "${SERVER_MEMORY}Gi", "images_server_request_cpu" : "${SERVER_CPU}m", "images_server_request_memory" : "${SERVER_MEMORY}Gi", "images_apply_limit_cpu" : "${APPLY_CPU}m", "images_apply_limit_memory" : "${APPLY_MEMORY}Gi", "images_apply_request_cpu" : "${APPLY_CPU}m", "images_apply_request_memory" : "${APPLY_MEMORY}Gi", "images_api_limit_cpu" : "${API_CPU}m", "images_api_request_cpu" : "${API_CPU}m", "images_ui_limit_cpu" : "${UI_CPU}m", "images_ui_request_cpu" : "${UI_CPU}m", "mem" : "${INSTANCE_MEMORY}", "name" : "IBM Data Gate", "route_data_gate_route_host_name" : "${ROUTE_PREFIX}.${ROUTE_SUBDOMAIN}", "route_data_gate_route_port" : "${ROUTE_PORT}", "targetDbInstance" : "${DATABASE_ID}", "type" : "dg", "version" : "${INSTANCE_VERSION}", "pod_affinity" : ${NODE_AFFINITY}, "storage_type" : "storageClass", "storage_storageclass_name":"${STG_CLASS_FILE}", "storage_storageclass_size":"${INSTANCE_STORAGE}Gi" }, "transientFields":{} } } EOF다음 환경 변수는 설치 환경 변수 스크립트에 이미 정의된 값을 사용합니다.${PROJECT_CPD_INST_OPERANDS}${STG_CLASS_FILE}${IMAGE_ARCH}
기존 지속적 볼륨 청구 사용
cat << EOF > ./data-gate-instance.json{ "addon_type": "dg", "display_name": "${INSTANCE_NAME}", "namespace": "${PROJECT_CPD_INST_OPERANDS}", "addon_version": "${INSTANCE_VERSION}", "preExistingOwner": false, "create_arguments": { "resources" : { "cpu" : "${INSTANCE_CPU}", "memory" : "${INSTANCE_MEMORY}" }, "metadata": { "arch" : "${IMAGE_ARCH}", "baseNamespace" : "${PROJECT_CPD_INST_OPERANDS}", "cpu" : "${INSTANCE_CPU}", "databaseEngineService" : "${DATABASE_ENGN_SVC}", "databaseSecureJdbcPort" : "50001", "dataGateInstanceName": "${INSTANCE_NAME}", "data_gate_database_name": "${DATABASE_NAME}", "defaultRouteSubdomain" : "${ROUTE_SUBDOMAIN}", "targetDbEncoding" : "${DB_ENCODING}", "images_stunnel_limit_cpu" : "${STUNNEL_CPU}m", "images_stunnel_request_cpu" : "${STUNNEL_CPU}m", "images_server_limit_cpu" : "${SERVER_CPU}m", "images_server_limit_memory" : "${SERVER_MEMORY}Gi", "images_server_request_cpu" : "${SERVER_CPU}m", "images_server_request_memory" : "${SERVER_MEMORY}Gi", "images_apply_limit_cpu" : "${APPLY_CPU}m", "images_apply_limit_memory" : "${APPLY_MEMORY}Gi", "images_apply_request_cpu" : "${APPLY_CPU}m", "images_apply_request_memory" : "${APPLY_MEMORY}Gi", "images_api_limit_cpu" : "${API_CPU}m", "images_api_request_cpu" : "${API_CPU}m", "images_ui_limit_cpu" : "${UI_CPU}m", "images_ui_request_cpu" : "${UI_CPU}m", "mem" : "${INSTANCE_MEMORY}", "name" : "IBM Data Gate", "route_data_gate_route_host_name" : "${ROUTE_PREFIX}.${ROUTE_SUBDOMAIN}", "route_data_gate_route_port" : "${ROUTE_PORT}", "targetDbInstance" : "${DATABASE_ID}", "type" : "dg", "version" : "${INSTANCE_VERSION}", "pod_affinity" : ${NODE_AFFINITY}, "storage_type" : "existingClaim", "storage_existingClaim_name": "${INSTANCE_PVC_NAME}" }, "transientFields":{} } } EOF다음 환경 변수는 설치 환경 변수 스크립트에 이미 정의된 값을 사용합니다.${PROJECT_CPD_INST_OPERANDS}${STG_CLASS_FILE}${IMAGE_ARCH}
PAYLOAD_FILE환경 변수를 워크스테이션에 있는 JSON 페이로드 파일의 완전한 이름으로 설정하십시오.export PAYLOAD_FILE=<fully-qualified-JSON-file-name>- 페이로드 파일에서 서비스 인스턴스를 작성하십시오.
실행하는 명령은 서비스 인스턴스를 작성하려는 IBM Software Hub 의 인스턴스가 자체 서명 인증서를 사용하는지 또는 신뢰할 수 있는 인증 기관에서 서명한 인증서를 사용하는지에 따라 다릅니다.
인스턴스가 신뢰할 수 있는 인증 기관에서 서명한 인증서를 사용합니다.
curl --request POST \ --url "https://${CPD_ROUTE}/zen-data/v3/service_instances" \ --header "Authorization: ZenApiKey ${API_KEY}" \ --header 'Content-Type: application/json' \ --data @${PAYLOAD_FILE}
인스턴스가 자체 서명된 인증서를 사용합니다 (기본값).
curl -k --request POST \ --url "https://${CPD_ROUTE}/zen-data/v3/service_instances" \ --header "Authorization: ZenApiKey ${API_KEY}" \ --header 'Content-Type: application/json' \ --data @${PAYLOAD_FILE}
요청이 성공적으로 완료되면, 명령은 다음 중 하나의 응답 코드 HTTP 를 반환합니다:- 200 -요청이 완료되었으며 서비스 인스턴스가 프로비저닝되었습니다.
- 202 -요청이 제출되었습니다. 서비스 인스턴스를 프로비저닝하는 중입니다.
요청이 성공적이지 않은 경우, 응답 코드( HTTP )를 사용하여 이유를 확인하십시오.
서비스 인스턴스가 작성되었는지 유효성 검증
서비스 인스턴스가 작성되었는지 유효성을 검증하려면 다음을 수행하십시오.
INSTANCE_ID환경 변수를POSTcURL 명령이 리턴한 ID로 설정하십시오.export INSTANCE_ID=<ID-from-response>- 서비스 인스턴스의 상태를 가져오십시오.
실행하는 명령은 서비스 인스턴스를 작성하려는 IBM Software Hub 의 인스턴스가 자체 서명 인증서를 사용하는지 또는 신뢰할 수 있는 인증 기관에서 서명한 인증서를 사용하는지에 따라 다릅니다.
인스턴스가 신뢰할 수 있는 인증 기관에서 서명한 인증서를 사용합니다.
curl --request GET \ --url "https://${CPD_ROUTE}/zen-data/v3/service_instances/${INSTANCE_ID}" \ --header "Authorization: ZenApiKey ${API_KEY}" \ --header 'Content-Type: application/json'
인스턴스가 자체 서명된 인증서를 사용합니다 (기본값).
curl -k --request GET \ --url "https://${CPD_ROUTE}/zen-data/v3/service_instances/${INSTANCE_ID}" \ --header "Authorization: ZenApiKey ${API_KEY}" \ --header 'Content-Type: application/json'
- 요청이 성공적으로 완료되면, 명령은 다음과 같은 응답 코드 HTTP 200을 반환합니다JSON 응답에서
provision_status매개변수를 찾으십시오.- 값이
PROVISIONED인 경우 서비스 인스턴스가 성공적으로 작성된 것입니다. - 값이
PROVISION_IN_PROGRESS인 경우 몇 분 동안 기다린 후 명령을 다시 실행하십시오. - 값이
FAILED인 경우 가능한 원인에 대해zen-core-api및zen-watcher팟 (Pod) 의 팟 (Pod) 로그를 검토하십시오.
- 값이
- 요청이 성공적이지 않은 경우, 응답 코드( HTTP )를 사용하여 이유를 확인하십시오.
- 요청이 성공적으로 완료되면, 명령은 다음과 같은 응답 코드 HTTP 200을 반환합니다
결과
프로비저닝 프로세스는 선택된 대상 데이터베이스 (Db2 또는 Db2 Warehouse) 를 변경합니다. 대상 데이터베이스의 변경 사항을 참조하십시오.
다음에 수행할 작업
- 쌍을 작성하십시오. 이를 위해 웹 클라이언트에서 Data Gate 용 서비스 인스턴스 생성 시 24단계부터 30단계까지 완료해야 합니다. 웹 클라이언트에서 인스턴스를 열고 계속하려면, Data Gate 용 소스 정의 업데이트 지침을 따르십시오.
- 사용자에게 서비스 인스턴스에 대한 액세스 권한을 부여해야 합니다. 자세한 내용은 Data Gate 에 대한 사용자 액세스 관리를 참조하십시오.