사용자 계정에 소프트웨어 온보딩

소프트웨어를 계정에 온보드하는 프로세스에는 개인 카탈로그로 버전 가져오기, 필요한 대상 인프라에 버전이 성공적으로 설치될 수 있는지 확인, 계정에 소프트웨어 게시가 포함됩니다. 그런 다음 사용자 계정의 사용자가 소프트웨어를 사용할 수 있습니다.

시작하기 전에

  1. 종량과금제 또는 구독 계정을 사용하고 있는지 확인하십시오. 자세한 내용은 계정 유형 보기를 참조하십시오.

  2. 온보드할 수 있는 소프트웨어 목록을 검토하십시오.

    • Helm Kubernetes 및 클러스터의 차트 Red Hat OpenShift on IBM Cloud
    • Terraform 템플리트
    • VMware Solutions Dedicated-vCenter Server에 배치된 OVA 이미지
    • VPC 인프라 또는 Power Virtual Server에 배치된 가상 서버 이미지(Terraform 사용)
    • VPC용 가상 서버 이미지

    IBM Z® (IAM) 배포 지원을 위한 VPC용 가상 서버 이미지 온보딩이 사설 카탈로그에서 제공됩니다. IBM Z 이 지원하는 가상 서버 이미지의 온보딩 경험은 개인 카탈로그 내 다른 가상 서버 이미지를 온보딩하는 방식과 동일합니다.

    • GitHub 또는 GitLab 저장소의 TGZ 파일이 있는 운영자
    • Red Hat OpenShift 레지스트리의 오퍼레이터 번들
  3. 귀하의 소스 코드를 릴리스에 업로드할 필요는 없습니다. GitHub 또는 GitLab VPC에 VSI를 배포하는 경우 저장소. 대신 계정에서 사용할 수 있는 사용자 정의 이미지가 준비되어 있는지 확인하세요. 보다 커스텀 이미지를 VPC로 가져오고 검증.

  4. 다음이 할당되었는지 확인하세요. IAM 액세스:

    • Schematic 서비스에 대한 관리자 역할
    • 카탈로그 관리 서비스에 대한 편집자 역할
    • 계정 내 모든 리소스 그룹에 대한 ‘Viewer’ 역할. 유효성 검사를 실행하려면 하나 이상의 리소스 그룹에 액세스해야 합니다.
    • Secrets Manager 서비스의 작성자 역할. VPC에서 VSI를 사용하는 경우에는 이 역할이 필요하지 않습니다.
  5. IBM Cloud CLI및 IBM Cloud Schematics 플러그인을 설치하십시오. 자세한 정보는 CLI 설정을 참조하십시오.

컨테이너화된 앱의 경우 다음 전제조건을 완료하십시오.

  1. Kubernetes 클러스터 또는 Red Hat OpenShift 클러스터를 작성하십시오.
  2. IBM Cloud Kubernetes Service에 대한 배치의 경우 Helm 차트를 설정하십시오.
  3. Red Hat OpenShift에 배치하려면 Helm 차트 또는 오퍼레이터를 설정하십시오.

가상 서버 이미지의 경우 다음 전제조건을 완료하십시오.

  1. 지원되는 이미지의 목록을 검토하십시오.
  2. 필요한 경우 Terraform 템플리트 를 작성하십시오. VPC용 가상 서버 이미지에는 Terraform 템플리트가 필요하지 않습니다.
  3. IBM Cloud Object Storage의 인스턴스를 작성하고 이미지를 버킷에 추가하십시오.

Terraform을 사용하여 계정에 소프트웨어를 온보딩하기 전에 다음을 완료했는지 확인하십시오.

  • Terraform CLI를 설치하고 Terraform에 대한 IBM Cloud 제공자 플러그인을 구성하십시오. 자세한 정보는 IBM Cloud® 에 대한 튜토리얼을 참조하십시오. 플러그인은 이 태스크를 완료하는 데 사용되는 IBM Cloud API를 요약합니다.
  • 이름이 main.tf인 Terraform 구성 파일을 작성하십시오. 이 파일에서는 리소스 정의 언어( HashiCorp )를 사용하여 리소스를 정의합니다. 자세한 내용은 Terraform 문서를 참조하십시오.

소프트웨어를 다른 계정과 공유하려면 파트너 센터에서 소프트웨어를 승인해야 합니다. 자세한 정보는 소프트웨어 판매 설정을 참조하십시오.

개인용 카탈로그 작성

개인용 카탈로그는 사용자 계정에 있는 사용자의 제품에 대한 액세스를 관리할 수 있는 방법을 제공합니다.

  1. IBM Cloud 콘솔에서 [관리 ] > [ 카탈로그 ]로 이동한 다음, [ 카탈로그 만들기]를 클릭합니다.
  2. 카탈로그의 이름 및 설명을 입력하십시오.
  3. 개인용 카탈로그의 IBM Cloud 카탈로그에 있는 모든 제품을 제외하거나 포함시키려면 선택하십시오. 카탈로그의 가시성에 미치는 영향에 대한 자세한 정보는 카탈로그 설정 관리의 내용을 참조하십시오.
  4. 작성을 클릭하십시오.

개인용 카탈로그에 소프트웨어 가져오기

소프트웨어를 개인용 카탈로그로 가져오려면 다음 단계를 완료하십시오.

  1. 개인용 제품 페이지에서 추가를 클릭하십시오.

  2. 배치 방법을 선택하십시오.

  3. 개인용 또는 공용 저장소에서 제품을 추가할지 여부를 선택하십시오. 또는 Red Hat 레지스트리에서 오퍼레이터를 온보딩하는 경우, Red Hat 저장소 유형(인증됨, Marketplace, 커뮤니티)을 선택하십시오.

    개인용 저장소에서 제품을 추가하는 경우 개인용 액세스 토큰을 제공하거나 시크릿을 사용할 수 있습니다. 사용자에게 개인 액세스 토큰을 제공하는 대신 시크릿에 대한 액세스 권한을 제공하고, 토큰을 시크릿에 추가하고, 중앙 집중식으로 모든 토큰을 관리하고, 시크릿 허용에 액세스할 수 있습니다.

    • 개인 액세스 토큰을 사용하는 경우 시크릿을 사용하지 않음을 표시하려면 아니오를 선택하고 개인 액세스 토큰을 제공하십시오.
    • 시크릿을 사용하는 경우 를 선택하고 Manager에서 선택을 클릭하십시오. 서비스 인스턴스, 시크릿 그룹 및 시크릿을 선택하십시오. 시크릿이 표시되지 않으면 올바른 시크릿 그룹 및 서비스 인스턴스를 사용 중인지 확인하십시오.

    작성된 서비스 인스턴스가 있는 경우에도 시크릿을 작성할 수 없거나 시크릿을 사용할 수 있는 올바른 액세스 권한이 없으면 No service instance available 메시지가 표시될 수 있습니다.

  4. 소스 URL을 입력하십시오. 소프트웨어 유형별로 다음과 같은 지원되는 형식 목록을 검토할 수 있습니다.

    • Helm 차트: https://raw.githubusercontent.com/IBM/charts/master/repo/ibm-helm
    • Node-RED Operator: https://github.com/IBM-Cloud/operator-bundle-sample/archive/refs/tags/v0.0.3.tar.gz
    • Red Hat OpenShift on IBM Cloud 레지스트리의 오퍼레이터 번들: 예를 들어, Certified 저장소의 사용 가능한 오퍼레이터 목록에서 ‘ Akka Cluster Operator ’를 선택하세요.
    • OVA 이미지: https://github.com/gcatalog/OVA-sample/blob/main/ova-sample.yaml
    • Terraform 템플리트: https://github.com/IBM-Cloud/terraform-sample/releases/tag/v1.0.0
    • Terraform을 사용하는 가상 서버 이미지: https://github.com/IBM-Cloud/isv-vsi-product-deploy-sample/releases/download/v1.0/isv-vsi-product-deploy-sample.tar.gz
    • VPC용 가상 서버 이미지: VPC로 가져온 사용 가능한 이미지 목록에서 이미지를 선택하거나 계정으로 새 이미지를 가져오십시오.

    VPC용 가상 서버 이미지는 한 번에 하나의 개인용 카탈로그 내에서 하나의 제품에만 추가할 수 있습니다. 가져올 가상 서버 이미지를 이미 다른 제품으로 가져온 경우 새 제품에 가상 서버 이미지를 추가하기 전에 해당 제품에서 이미지를 제거하거나 제품을 삭제해야 합니다.

  5. 적용 가능한 경우, 소프트웨어 버전을 주 버전, 부 버전 및 개정 형식으로 입력하십시오. 예를 들어, 버전 1.1.2를 입력하십시오.

  6. 제품에 대한 카탈로그 카테고리를 선택하십시오. 카테고리는 기능, 사용 또는 공통 솔루션을 기반으로 IBM Cloud 카탈로그에서 제품을 구성하는 데 사용됩니다.

  7. 제품 추가를 클릭하십시오.

카탈로그 항목 세부사항 추가

제품을 카탈로그에 공개하면 개인용 카탈로그에 대한 액세스 권한이 있는 사용자가 제품 이름, 그리고 온보딩 중에 추가된 기타 세부사항을 포함하는 타일을 볼 수 있게 됩니다. 소프트웨어를 가져올 때 설정하는 카테고리 외에 산업, 규제 준수, 상호작용하는 기술 등과 관련된 기타 필터를 추가할 수 있습니다. 이러한 필터 각각은 사용자가 카탈로그에서 자신의 요구사항에 맞는 소프트웨어를 찾는 데 사용됩니다. 카탈로그 항목 세부사항 섹션에서는 사용자가 제품을 빠르게 찾는 데 도움을 주기 위한 간단한 설명, 문서 URL 및 키워드 또한 평가하고 업데이트할 수 있습니다.

  1. 카탈로그 항목 세부사항 섹션에서 편집 아이콘 편집 아이콘을 클릭하십시오.
  2. 제품과 함께 가져온 정보를 검토하고 필요에 따라 편집하십시오.
  3. 필터 및 산업 옵션을 검토하여 적용되는 카탈로그 필터를 선택하십시오. 최대 5개의 산업 필터를 선택할 수 있습니다.
  4. 카탈로그 항목 미리보기를 확인하여 카탈로그에서 소프트웨어를 평가하는 사용자에게 카탈로그 타일이 어떻게 표시되는지 보십시오.
  5. 변경사항이 만족스러우면 저장을 클릭하십시오.

자세한 정보는 제품 세부사항 정의 를 참조하십시오.

소프트웨어 구성

Helm 차트

  1. 제품 세부사항 페이지에 표시된 버전 목록에서 소프트웨어가 포함된 행을 클릭하십시오.
  2. 버전 세부사항을 검토하고 다음을 클릭하십시오.
  3. 사전 설치를 구성하고 다음을 클릭하십시오.
  4. 설치 스크립트를 실행하고 배치 값을 설정하는 데 필요한 액세스를 설정하여 배치 세부사항을 구성하고 다음을 클릭하십시오.

Terraform

  1. 제품 세부사항 페이지에 표시된 버전 목록에서 소프트웨어가 포함된 행을 클릭하십시오.
  2. 버전 세부사항을 검토하고 다음을 클릭하십시오.
  3. 배치 값을 구성하십시오.
  4. 해당되는 경우 출력 값 설명을 편집하고 다음을 클릭하십시오.
  5. 필수 IAM 액세스를 정의하고 다음을 클릭하십시오.

GitHub 저장소의 오퍼레이터

  1. 제품 세부사항 페이지에 표시된 버전 목록에서 소프트웨어가 포함된 행을 클릭하십시오.
  2. 버전 세부사항을 검토하고 다음을 클릭하십시오.

Red Hat 레지스트리의 오퍼레이터

  1. 제품 세부사항 페이지에 표시된 버전 목록에서 소프트웨어가 포함된 행을 클릭하십시오.
  2. 버전 세부사항을 검토하고 다음을 클릭하십시오.

OVA 이미지

  1. 제품 세부사항 페이지에 표시된 버전 목록에서 소프트웨어가 포함된 행을 클릭하십시오.
  2. 버전 세부사항을 검토하고 다음을 클릭하십시오.

Terraform을 사용한 가상 서버 이미지

  1. 제품 세부사항 페이지에 표시된 버전 목록에서 소프트웨어가 포함된 행을 클릭하십시오.
  2. 버전 세부사항을 검토하고 다음을 클릭하십시오.
  3. 배치 값을 구성하십시오.
  4. 해당되는 경우 출력 값 설명을 편집하고 다음을 클릭하십시오.
  5. 필수 IAM 액세스를 정의하고 다음을 클릭하십시오.

VPC용 가상 서버 이미지

  1. 제품 세부사항 페이지에 표시된 버전 목록에서 소프트웨어가 포함된 행을 클릭하십시오.
  2. 이미지 목록을 검토하고 다음을 클릭하십시오.
  3. 버전 세부사항을 검토하고 다음을 클릭하십시오.

라이센스 계약 추가

사용자가 제품을 설치할 때 승인해야 하는 라이센스 계약에 대한 URL을 제공합니다. 라이센스 계약은 IBM Cloud 서비스 계약에 추가됩니다.

  1. ‘라이선스 계약 추가’ > ‘라이선스 추가’를 클릭합니다.
  2. 이름 및 URL을 입력하고 업데이트 > 다음을 클릭하십시오.

Readme 파일 편집

사용자가 소프트웨어를 설치할 때, 귀하의 readme 파일 링크를 선택하여 제품 정보를 확인할 수 있습니다. 'Readme' 링크에 있는 정보는 사용자가 소스 저장소에 업로드한 readme 파일에서 생성된 것입니다.

  1. readme 편집 탭에서, 소프트웨어를 설치할 때 사용자에게 readme 파일의 정보를 표시하는 방법을 미리보십시오.
  2. 업데이트를 작성하려면 Readme 섹션 제목 옆에 있는 편집 아이콘 편집 아이콘을 클릭하십시오.
  3. 저장 을 클릭하십시오.
  4. 다음 을 클릭하십시오.

VPC의 가상 서버 이미지를 가져오는 경우 readme 파일이 자동으로 생성되지 않습니다. readme 파일 템플리트 의 컨텐츠를 복사하여 붙여넣고 필요에 따라 업데이트하십시오.

소프트웨어 유효성 검증하기

소프트웨어의 유효성을 검증할 때 현재 버전이 배치 대상에 성공적으로 설치될 수 있는지 확인하는 것입니다. 유효성 검증 단계는 배치 방법에 따라 다릅니다.

유효성 검증 프로세스의 진행 상태를 모니터하려면 로그 보기 를 클릭하십시오.

Helm 차트

  1. 제품 유효성 검증 탭에서 클러스터를 선택하십시오.
  2. 배치 대상이 Kubernetes 클러스터인 경우 네임스페이스를 선택하거나 새 이름을 작성하십시오. 배치 대상이 Red Hat OpenShift 클러스터인 경우 프로젝트를 선택하거나 새 프로젝트를 작성하십시오.
  3. 다음 을 클릭하십시오.
  4. IBM Cloud Schematics 작업공간을 구성하십시오.
  5. 다음 을 클릭하십시오.
  6. 적용 가능한 경우, 라이센스 계약을 검토하고 **다음 라이센스 계약을 읽고 동의합니다.**를 선택하십시오.
  7. 유효성 검증 을 클릭하십시오.

Terraform

  1. 제품 유효성 검증 탭에서 IBM Cloud Schematics 작업공간을 구성하십시오.
  2. 다음 을 클릭하십시오.
  3. 적용 가능한 경우, 라이센스 계약을 검토하고 **다음 라이센스 계약을 읽고 동의합니다.**를 선택하십시오.
  4. 유효성 검증 을 클릭하십시오.

GitHub 저장소의 오퍼레이터

  1. 제품 유효성 검증 탭에서 Red Hat OpenShift 클러스터를 선택하십시오.
  2. 프로젝트를 선택하거나 새 프로젝트를 작성하십시오. 프로젝트는 Kubernetes 클러스터 네임스페이스와 유사하며 목록은 사용자의 Red Hat OpenShift 환경으로부터 채워집니다.
  3. 다음 을 클릭하십시오.
  4. IBM Cloud Schematics 작업공간을 구성하십시오.
  5. 다음 을 클릭하십시오.
  6. 적용 가능한 경우, 라이센스 계약을 검토하고 **다음 라이센스 계약을 읽고 동의합니다.**를 선택하십시오.
  7. 유효성 검증 을 클릭하십시오.

Red Hat 레지스트리의 오퍼레이터

  1. 제품 유효성 검증 탭에서 업데이트 채널을 선택하십시오.
  2. 승인 전략을 선택하십시오.
  3. Red Hat OpenShift 클러스터를 선택하십시오.
  4. 프로젝트를 선택하거나 새 프로젝트를 작성하십시오. 프로젝트는 Kubernetes 클러스터 네임스페이스와 유사하며 목록은 사용자의 Red Hat OpenShift 환경으로부터 채워집니다.
  5. 다음 을 클릭하십시오.
  6. IBM Cloud Schematics 작업공간을 구성하십시오.
  7. 다음 을 클릭하십시오.
  8. 적용 가능한 경우, 라이센스 계약을 검토하고 **다음 라이센스 계약을 읽고 동의합니다.**를 선택하십시오.
  9. 유효성 검증 을 클릭하십시오.

OVA 이미지

  1. 제품 유효성 검증 탭에서 라이센스 계약을 검토하고 **다음 라이센스 계약을 읽고 동의합니다.**를 선택하십시오.
  2. 유효성 검증 을 클릭하십시오.

Terraform을 사용한 가상 서버 이미지

  1. 제품 유효성 검증 탭에서 IBM Cloud Schematics 작업공간을 구성하십시오.
  2. 다음 을 클릭하십시오.
  3. 적용 가능한 경우, 라이센스 계약을 검토하고 **다음 라이센스 계약을 읽고 동의합니다.**를 선택하십시오.
  4. 유효성 검증 을 클릭하십시오.

VPC용 가상 서버 이미지

  1. ‘검증 버전’ 탭에서 검증 대상을 구성한 다음 ‘다음’을 클릭합니다.
  2. 원하는 경우 ‘ Schematics ’ 작업 공간을 구성한 다음 ‘다음’을 클릭합니다.
  3. 적용 가능한 경우, 라이센스 계약을 검토하고 **다음 라이센스 계약을 읽고 동의합니다.**를 선택하십시오.
  4. 유효성 검증 을 클릭하십시오.

규제 준수 관리

소프트웨어에 프로파일 및 제어를 추가하여 보안 및 준수 요구사항을 충족하는지 증명할 수 있습니다. Compliance Manager 를 사용하여 유효성 검증 중에 작성된 자원을 스캔해야 합니다.

Compliance Manager 에서 지원되고 Compliance Manager 스캔에서 유효성 검증되는 프로파일 및 제어만 카탈로그에 표시됩니다.

제어 추가

컨트롤을 추가하려면 다음 단계를 따르십시오

  1. 규정 준수 관리 페이지에서 '제어 추가'를 선택하십시오.

  2. Workload Protection 인스턴스를 선택한 다음 정책을 선택하십시오.

    아직 Workload Protection 인스턴스를 프로비저닝하지 않은 경우, IBM Cloud 카탈로그에서 인스턴스를 설정하고 IBM Cloud 계정에 대해 클라우드 Security Posture Management(CSPM)를 활성화 해야 합니다. 그런 다음 기존 Workload Protection 인스턴스 또는 새 인스턴스와 통합하기 위한 단계를 완료하십시오.

  3. 전체 정책을 추가할지, 아니면 제어 항목의 일부만 추가할지 선택하십시오.

  4. 전체 정책을 추가하도록 선택한 경우 다음 단계로 진행하십시오. 일부 컨트롤을 추가하도록 선택한 경우, 추가하려는 컨트롤을 선택하십시오.

  5. 추가 를 클릭하십시오.

Workload Protection 의 재고 결과를 추가하세요

Workload Protection 의 재고 결과를 추가하면 사용자가 카탈로그에서 제품을 평가할 때 해당 제품의 준수 여부를 확인할 수 있습니다.

Workload Protection 에서는 인벤토리가 하루에 한 번씩 업데이트됩니다. 재고를 카탈로그 목록에 추가하기 전에 자원을 배치하고 재고가 업데이트될 때까지 기다려야 합니다. 자세한 정보는 규제 준수를 참조하십시오.

재고 결과를 추가하려면 다음 단계를 따르십시오

  1. ‘규정 준수 관리’ 페이지에서 ‘결과 추가’를 클릭합니다.
  2. 이전에 프로비저닝한 ' Workload Protection ' 인스턴스를 선택하십시오.
  3. 최신 재고 결과를 적용하려면 적용을 클릭하십시오.

요구사항 검토

계정에 공유하려면 인증 절차 및 기타 모든 요건을 완료해야 합니다. 개인용 카탈로그에 액세스할 수 있는 모든 사용자가 제품을 사용할 수 있도록 할 준비가 되면 공유 준비를 클릭하십시오.

소프트웨어 공유

계정 또는 엔터프라이즈에 제품을 공유하려면 탐색에서 제품 이름을 클릭하여 제품 세부사항 페이지로 이동하십시오. ‘작업’ 메뉴에서 ‘공유’를 클릭합니다. 제품을 공유할 위치를 선택하고 공유를 클릭하십시오.

CLI를 사용하여 카탈로그에 소프트웨어 온보딩

CLI를 사용하여 소프트웨어를 추가하려면 다음 단계를 완료하십시오. 이 태스크를 CI/CD 프로세스에서 사용할 수 있습니다. 개인용 저장소에서 소프트웨어를 추가하려면 개인 액세스 토큰을 포함해야 합니다.

  1. ibmcloud catalog create 명령을 실행하여 개인용 카탈로그를 작성하십시오. 개인용 카탈로그는 사용자 계정에 있는 사용자의 제품에 대한 액세스를 관리할 수 있는 방법을 제공합니다.

    ibmcloud catalog create --name CATALOG [--catalog-description "DESCRIPTION"]
    
  2. ibmcloud catalog offering create 명령을 실행하여 개인용 카탈로그에 소프트웨어를 추가하십시오.

    ibmcloud catalog offering create [--catalog CATALOG-NAME] [--zipurl URL]
    

    개인용 저장소에서 소프트웨어를 가져오려면 명령에 [--token TOKEN]을 추가하여 개인 액세스 토큰을 사용할 수 있습니다.

  3. ibmcloud catalog offering add-category 명령을 실행하여 제품에 카테고리를 추가하십시오. 기본적으로 개발자 도구 카테고리가 제품에 추가됩니다.

    ibmcloud catalog offering add-category --catalog CATALOG_NAME [--offering OFFERING] [--category CATEGORY]
    
  4. ibmcloud catalog offering import-version 명령을 실행하여 카탈로그에서 원하는 소프트웨어 버전을 가져오십시오.

    ibmcloud catalog offering import-version --catalog CATALOG --offering OFFERING_NAME --zipurl URL
    

    다음은 소프트웨어 유형별로 지원되는 형식 목록을 표시합니다.

    • Helm 차트: https://raw.githubusercontent.com/IBM/charts/master/repo/ibm-helm
    • Node-RED Operator: https://github.com/IBM-Cloud/operator-bundle-sample/archive/refs/tags/v0.0.3.tar.gz
    • Red Hat OpenShift on IBM Cloud 레지스트리의 오퍼레이터 번들: 예를 들어, Certified 저장소의 사용 가능한 오퍼레이터 목록에서 ‘ Akka Cluster Operator ’를 선택하세요.
    • OVA 이미지: https://github.com/gcatalog/OVA-sample/blob/main/ova-sample.yaml
    • Terraform 템플리트: https://github.com/IBM-Cloud/terraform-sample/releases/tag/v1.0.0
    • Terraform을 사용하는 가상 서버 이미지: https://github.com/IBM-Cloud/isv-vsi-product-deploy-sample/releases/download/v1.0/isv-vsi-product-deploy-sample.tar.gz
    • VPC용 가상 서버 이미지: VPC로 가져온 이미지 목록에서 이미지를 선택하거나 계정으로 새 이미지를 가져오십시오.
  5. ibmcloud catalog offering version validate 명령을 실행하여 소프트웨어를 유효성 검증하십시오.

    ibmcloud catalog offering version validate --version-locator VERSION_NUMBER --cluster CLUSTER_ID --namespace NAME [--timeout TIMEOUT] [--wait WAIT]
    

    소프트웨어를 배치하는 데 몇 분이 소요될 수 있습니다. ibmcloud catalog offering version validate-status 를 실행하여 제품 유효성 검증 상태를 조회하여 유효성 검증 상태를 확인하십시오.

    ibmcloud catalog offering version validate-status --version-locator VERSION_NUMBER [--output FORMAT]
    
  6. ibmcloud catalog offering publish account 를 실행하여 계정의 사용자에게 소프트웨어를 게시하십시오.

    ibmcloud catalog offering publish account [--catalog CATALOG][--offering OFFERING]
    

API를 사용하여 개인용 카탈로그 작성

개인용 카탈로그는 사용자 계정에 있는 사용자의 제품에 대한 액세스를 관리할 수 있는 방법을 제공합니다. 다음 샘플 요청에 표시된 대로 카탈로그 관리 API를 호출하여 개인용 카탈로그를 프로그래밍 방식으로 작성할 수 있습니다. 자세한 정보는 카탈로그 작성을 위한 카탈로그 관리 API를 참조하십시오.

String label = "{label}";
String shortDesc = "{shortDesc}";
CreateCatalogOptions createOptions = new CreateCatalogOptions.Builder().label(label).shortDescription(shortDesc).build();
Response<Catalog> response = service.createCatalog(createOptions).execute();
System.out.println(response.getResult());
label = "{label}";
shortDesc = "{shortDesc}";
response = await service.createCatalog({ 'label': label, 'shortDescription': shortDesc });
console.log(response);
label = "{label}"
shortDesc = "{shortDesc}"
response = self.service.create_catalog(label=label, short_description=shortDesc)
print(response)
label := "{label}"
shortDesc := "{shortDesc}"
createOptions := service.NewCreateCatalogOptions()
createOptions.SetLabel(label)
createOptions.SetShortDescription(shortDesc)
_, response, _ := service.CreateCatalog(createOptions)
fmt.Println(response)

API를 사용하여 개인용 카탈로그에 소프트웨어 가져오기

다음 샘플 요청에 표시된 대로 카탈로그 관리 API를 호출하여 프로그램 방식으로 카탈로그에 소프트웨어를 가져올 수 있습니다. 이 API는 소프트웨어를 작성하고 가져오기도 합니다. API에 대한 자세한 정보는 카탈로그 관리 API를 참조하십시오.

id = "{id}";
offeringURL = "{offeringURL}";
ImportOfferingOptions offeringOptions = new ImportOfferingOptions.Builder().catalogIdentifier(id).zipurl(offeringURL).build();
Response<Offering> response = service.importOffering(offeringOptions).execute();
System.out.println(response.getResult());
id = "{id}";
offeringURL = "{offeringURL}";
response = await service.importOffering({ 'catalogIdentifier': id, 'zipurl': offeringURL });
console.log(response);
id = "{id}"
offeringURL = "{offeringURL}"
response = self.service.import_offering(catalog_identifier=id, zipurl=offeringURL)
print(response)
id := "{id}"
offeringURL := "{offeringURL}"
offeringOptions := service.NewImportOfferingOptions(id, offeringURL)
_, response, _ := service.ImportOffering(offeringOptions)
fmt.Println(response)

API를 사용하여 소프트웨어 유효성 검증

다음 샘플 요청에 표시된 대로 카탈로그 관리 API를 호출하여 프로그래밍 방식으로 제품의 유효성을 검증할 수 있습니다. 이 프로세스는 몇 분 정도 걸릴 수 있습니다. API에 대한 자세한 정보는 카탈로그 관리 API를 참조하십시오.

String authRefreshToken = "{authRefreshToken}";
String versionLocator = "{versionLocator}";
ValidationInstallOptions installOptions = new ValidationInstallOptions.Builder().xAuthRefreshToken(authRefreshToken).versionLocId(versionLocator).build();
Response<Void> response = service.validationInstall(installOptions).execute();
System.out.println(response.getResult());
versionLocator = "{versionLocator}";
authRefreshToken = "{authRefreshToken}";
response = await service.validationInstall({ 'versionLocatorId': versionLocator, 'xAuthRefreshToken': authRefreshToken });
console.log(response);
authRefreshToken="{authRefreshToken}"
versionLocator = "{versionLocator}"
response = self.service.validation_install(version_locator_id=versionLocator, x_auth_refresh_token=authRefreshToken)
print(response)
versionLocator := "{versionLocator}"
authRefreshToken := "{authRefreshToken}"
installOptions := service.NewValidationInstallOptions(versionLocator, authRefreshToken)
response, _ := service.ValidationInstall(installOptions)
fmt.Println(response)

API를 사용하여 사용자 계정에 소프트웨어 공개

다음 샘플 요청에 표시된 대로 카탈로그 관리 API를 호출하여 사용자의 계정에 소프트웨어를 프로그래밍 방식으로 공개할 수 있습니다.

String versionLocator = "{versionLocator}";
AccountPublishVersionOptions publishOption = new AccountPublishVersionOptions.Builder().versionLocId(versionLocator).build();
Response<Void> response = service.accountPublishVersion(publishOption).execute();
System.out.println(response.getResult());
versionLocator = "{versionLocator}";
response = await service.accountPublishVersion({ 'versionLocId': versionLocator});
console.log(response);
versionLocator = "{versionLocator}"
response = self.service.account_publish_version(version_loc_id=versionLocator)
print(response)
versionLocator := "{versionLocator}"
publishOptions := service.NewAccountPublishVersionOptions(versionLocator)
response, _ := service.AccountPublishVersion(publishOptions)
fmt.Println(response)

Terraform을 사용하여 개인용 카탈로그 작성

Terraform을 사용하여 개인용 카탈로그를 작성하려면 다음 단계를 사용하십시오.

  1. main.tf 파일에 인수를 추가하십시오. 다음 예제에서는 ibm_cm_catalog 리소스를 사용하여 개인용 카탈로그를 작성합니다. 여기서 label은 카탈로그를 식별하기 위한 표시 이름입니다.

    resource "ibm_cm_catalog" "cm_catalog" {
    label = "label"
    short_description = "short_description"
    }
    

    자세한 내용은 Terraform 카탈로그 관리 페이지의 인자 참조 정보를 참조하십시오.

  2. 구성 파일 빌드를 완료한 후 Terraform CLI를 초기화하십시오. 자세한 정보는 작업 디렉토리 초기화를 참조하십시오.

    terraform init
    
  3. main.tf 파일에서 자원을 프로비저닝하십시오. 자세한 정보는 Terraform을 사용하여 인프라 프로비저닝을 참조하십시오.

    1. terraform plan 를 실행하여 제안된 조치를 미리보기 위한 Terraform 실행 플랜을 생성하십시오.
       terraform plan
    
    1. terraform apply 를 실행하여 계획에 정의된 자원을 작성하십시오.
       terraform apply
    

Terraform을 사용하여 카탈로그에 제품 가져오기

Terraform을 사용하여 개인용 카탈로그에 제품을 가져오려면 다음 단계를 사용하십시오.

  1. main.tf 파일에 인수를 추가하십시오. 다음 예제에서는 ibm_cm_offering 리소스를 사용하여 제품을 추가합니다. 여기서 label은 제품을 식별하기 위한 표시 이름입니다.

    resource "ibm_cm_offering" "cm_offering" {
    catalog_id = "catalog_id"
    label = "label"
    tags = [ "tags" ]
    }
    

    자세한 내용은 Terraform 카탈로그 관리 페이지의 인자 참조 정보를 참조하십시오.

  2. 구성 파일 빌드를 완료한 후 Terraform CLI를 초기화하십시오. 자세한 정보는 작업 디렉토리 초기화를 참조하십시오.

    terraform init
    
  3. main.tf 파일에서 자원을 프로비저닝하십시오. 자세한 정보는 Terraform을 사용하여 인프라 프로비저닝을 참조하십시오.

    1. terraform plan 를 실행하여 제안된 조치를 미리보기 위한 Terraform 실행 플랜을 생성하십시오.
       terraform plan
    
    1. terraform apply 를 실행하여 계획에 정의된 자원을 작성하십시오.
       terraform apply
    

Terraform을 사용하여 소프트웨어 버전 가져오기

제품을 추가한 후 Terraform을 사용하여 소프트웨어 버전을 추가하려면 다음 단계를 사용하십시오.

  1. main.tf 파일에 인수를 추가하십시오. 다음 예제는 cm_version 리소스를 사용하여 소프트웨어 버전에 액세스합니다. 여기서 offering_id는 소프트웨어를 식별합니다.

    resource "cm_version" "cm_version" {
    catalog_identifier = "catalog_identifier"
    offering_id = "offering_id"
    zipurl = "zipurl"
    }
    

    자세한 내용은 Terraform 카탈로그 관리 페이지의 인자 참조 정보를 참조하십시오.

  2. 구성 파일 빌드를 완료한 후 Terraform CLI를 초기화하십시오. 자세한 정보는 작업 디렉토리 초기화를 참조하십시오.

    terraform init
    
  3. main.tf 파일에서 자원을 프로비저닝하십시오. 자세한 정보는 Terraform을 사용하여 인프라 프로비저닝을 참조하십시오.

    1. terraform plan 를 실행하여 제안된 조치를 미리보기 위한 Terraform 실행 플랜을 생성하십시오.
       terraform plan
    
    1. terraform apply 를 실행하여 계획에 정의된 자원을 작성하십시오.
       terraform apply