Plug-in d'interface de ligne de commande de gestion des catalogues
L'interface de ligne de commande (CLI) pour la gestion des catalogues IBM Cloud® offre des possibilités supplémentaires pour travailler avec les produits du catalogue IBM Cloud et des catalogues privés de votre compte. Vous pouvez utiliser ce plug-in d'interface CLI pour gérer vos catalogues privés, intégrer des produits logiciels privés et gérer la visibilité des catalogues entre le catalogue public et vos catalogues privés.
Avant de commencer
- Installez l'interface de ligne de commande IBM Cloud. Pour plus d'informations, voir Initiation à l'interface de ligne de commande IBM Cloud. Le préfixe pour l'exécution de commandes via l'interface
CLI d'IBM Cloud est
ibmcloud. - Avant d'exécuter les commandes de registre, connectez-vous à IBM Cloud en utilisant la commande
ibmcloud loginpour générer un jeton d'accès et authentifier votre session.
Installation du plug-in de gestion des catalogues
Pour installer le plug-in de gestion des catalogues, exécutez la commande suivante :
ibmcloud plugin install catalogs-management
Sur la ligne de commande, vous recevez une notification lorsque des mises à jour du plug-in de l'interface de ligne de commande ibmcloud et de l'interface de ligne de commande catalogs-management sont disponibles. Veillez
à conservez votre interface de ligne de commande à jour afin de pouvoir utiliser l'ensemble des commandes et indicateurs disponibles.
Si vous souhaitez afficher la version actuelle de votre plug-in d'interface de ligne de commande catalogs-management, exécutez ibmcloud plugin list.
Pour préserver la confidentialité et la sécurité, n'indiquez pas d'informations personnelles dans les noms ou les descriptions des catalogues.
ibmcloud catalog account add-approbation-access
Exécutez la commande suivante pour ajouter un accès d'approbation à votre compte de catalogue.
ibmcloud catalog account add-approval-access [--account-ids IDS] [--object-kind KIND]
Options de commande
- --object-kind VALEUR
- Indiquez le type d'objet. Les options sont
offering,vpe,proxy_sourceoupreset_configuration. - --account-ids VALEUR
- Fournissez une liste d'identifiants de compte séparés par des virgules et préfixés par l'un des éléments suivants.
-acct-pour les comptes ordinaires,-ent-pour les comptes d'entreprise et-entgrp-pour les groupes de comptes d'entreprise.
ibmcloud catalog account delete-approbation-access
Exécutez la commande suivante pour supprimer l'accès d'approbation à votre compte de catalogue.
ibmcloud catalog account delete-approval-access [--account-ids IDS] [--object-kind KIND]
Options de commande
- --object-kind VALEUR
- Indiquez le type d'objet. Les options sont
offering,vpe,proxy_sourceoupreset_configuration. - --account-ids VALEUR
- Fournissez une liste d'identifiants de compte séparés par des virgules et préfixés par l'un des éléments suivants.
-acct-pour les comptes ordinaires,-ent-pour les comptes d'entreprise et-entgrp-pour les groupes de comptes d'entreprise.
ibmcloud catalog account get-approbation-list
Exécutez la commande suivante pour obtenir une liste d'approbation pour votre compte catalogue.
ibmcloud catalog account get-approval-list [--object-kind KIND]
Options de commande
- --object-kind VALEUR
- Indiquez le type d'objet. Les options sont
offering,vpe,proxy_sourceoupreset_configuration.
ibmcloud catalog account get-approbation-list-source
Exécutez la commande suivante pour obtenir tous les comptes cible pointant vers une source.
ibmcloud catalog account get-approval-list-source [--approval-state STATE] [--enterprise-id ID] [--object-kind KIND]
Options de commande
- --object-kind VALEUR
- Indiquez le type d'objet. Les options sont
offering,vpe,proxy_sourceoupreset_configuration. - --approval-state VALEUR
- Indiquez l'état d'approbation. Les options sont
approved,pendingourejected. - --enterprise-id VALUE (optionnel)
- Indiquez un ID d'entreprise ou de groupe de comptes d'entreprise pour afficher ou gérer les demandes de l'entreprise. Préfixez l'ID avec
-ent-pour une entreprise et-entgrppour un groupe de comptes.
ibmcloud catalog account set-approbation-state-source
Exécutez la commande suivante pour définir l'état d'approbation des comptes cibles qui pointent vers une source.
ibmcloud catalog account set-approval-state-source [--account-ids IDS] [--approval-state STATE] [--enterprise-id ID] [--object-kind KIND]
Options de commande
- --object-kind VALEUR
- Indiquez le type d'objet. Les options sont
offering,vpe,proxy_sourceoupreset_configuration. - --approval-state VALEUR
- Indiquez l'état d'approbation. Les options sont
approved,pendingourejected. - --account-ids VALEUR
- Fournissez une liste d'ID de comptes séparés par des virgules et préfixés par l'un des éléments suivants :
-acct-pour les comptes ordinaires,-ent-pour les comptes d'entreprise et-entgrp-pour les groupes de comptes d'entreprise. - --enterprise-id VALUE (optionnel)
- Indiquez un ID d'entreprise ou de groupe de comptes d'entreprise pour afficher ou gérer les demandes de l'entreprise. Préfixez l'ID avec
-ent-pour une entreprise et-entgrppour un groupe de comptes.
ibmcloud catalog create
Cette commande permet de créer un nouveau catalogue privé dans votre compte. Un catalogue privé permet d'organiser un ensemble de produits, les produits privés que vous ajoutez ou des références à des produits du catalogue IBM Cloud. Un utilisateur doit avoir accès à votre catalogue privé via une règle d'accès IAM et au groupe de ressources contenant votre catalogue privé pour afficher et utiliser les produits.
Cibler un groupe de ressources pour créer un catalogue parce que le catalogue existe dans le contexte d'un groupe de ressources particulier. Pour obtenir la liste des groupes de ressources, vous pouvez exécuter la commande ibmcloud resource groups,
puis la commande ibmcloud target -g "resource group".
ibmcloud catalog create --name CATALOG [--catalog-description "DESCRIPTION"]
Options de commande
- --name CATALOG
- Nom du catalogue.
- --catalog-description DESCRIPTION (facultatif)
- Brève description du nouveau catalogue.
Exemple
Créer un catalogue appelé dev-catalog avec la description a catalog for development and testing purpsoses.
ibmcloud catalog create --name dev-catalog --catalog-description "a catalog for development and testing purposes"
ibmcloud catalog list
Exécutez la commande suivante pour extraire la liste des catalogues de ce compte spécifique.
ibmcloud catalog list [--output FORMAT]
Options de commande
- --output FORMAT (facultatif)
- Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et la seule alternative supportée est JSON. Par exemple,
--output json.
Sortie
La commande génère la sortie suivante :
Name ID Description Last Updated
dev-catalog 93f592fb-e09b-4a53-bbd9-92f6ab9e253b short-description 2019-11-21 21:28:28.347 +0000 UTC
ABDemoTestCatalog 7a246530-e191-45e2-87cc-07c8c7033d2b short-description 2019-08-19 17:43:48.59 +0000 UTC
ibmcloud catalog get
Exécutez la commande suivante pour extraire les informations correspondant à un catalogue spécifique du compte.
ibmcloud catalog get --catalog CATALOG [--output FORMAT]
Options de commande
- --catalog CATALOG
- Nom ou ID du catalogue.
- --output FORMAT (facultatif)
- Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et la seule alternative supportée est JSON. Par exemple,
--output json.
Sortie
La commande génère la sortie suivante :
Name Current State Version Locator
dev-catalog
|__dev-offering
| |__Openshift
| |__1.0.0 Draft 480fb4e3-d7ba-4e9b-9d4c-42f0ab811040.fd8f91a3-8027-4919-ad6d-c5189a4a8ee
ibmcloud catalog delete
Exécutez la commande suivante pour supprimer un catalogue spécifique dans le compte.
ibmcloud catalog delete --catalog CATALOG
Options de commande
- --catalog CATALOG
- Nom ou ID du catalogue.
ibmcloud catalog search
Exécutez la commande suivante pour rechercher des produits publiés dans le catalogue public, notamment des services et des logiciels.
ibmcloud catalog search <QUERY> [--catalog CATALOG] [--type TYPE] [-r, --region REGION] [-k, --kind KIND] [--fields FIELDS] [-p, --price PRICE] [-t, --tag TAG] [--sort-by PROPERTY] [--col COLUMNS] [--reverse] [--output TYPE] [--global]
Options de commande
- --type TYPE (facultatif)
- Optionnel. La valeur par défaut est
services. Les options valides sontservicesetsoftware. - --catalog CATALOG (facultatif)
- Rechercher les logiciels publiés par votre compte. Spécifier le nom ou l'ID du catalogue dans lequel rechercher.
- --output FORMAT (facultatif)
- Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et les seules options alternatives sont
jsonetcsv. - --kind KIND (facultatif)
- L'indicateur n'est valable que pour les services de recherche. Fournissez une liste de types de produit séparés par des virgules.
- --region REGION (facultatif)
- L'indicateur n'est valable que pour les services de recherche. Fournissez une liste de régions séparées par des virgules. Exécutez
ibmcloud cs regionspour renvoyer une liste valide. - --price PRICE (facultatif)
- L'indicateur n'est valable que pour les services de recherche. Fournissez une liste de types de tarification séparés par des virgules.
- --tag TAG (facultatif)
- L'indicateur n'est valable que pour les services de recherche. Fournissez une liste d'étiquettes séparées par des virgules.
- --global (facultatif)
- L'indicateur n'est valable que pour les services de recherche. Utilisez-le pour opérer à l'échelle mondiale.
- --sort-by TYPE (facultatif)
- L'indicateur n'est valable que pour les services de recherche et sert à ordonner les résultats de la recherche. Les options disponibles sont
name,displayname,kind,provider,createdetupdated. - --reverse (facultatif)
- L'indicateur n'est valable que pour les services de recherche. Utilisez-le pour inverser l'ordre de tri.
- --fields FIELDS (facultatif)
- L'indicateur n'est valable que pour les services de recherche. Personnalisez la table. Par exemple,
--fields name,kind,metadata.service.iam_compatible.
Sortie
La commande génère la sortie suivante :
Name ID Category
2 Zone VPC f10d9ae9-ac94-4718-b24a-3994241ae2a4-global Networking
Apache Qml0bmFtaS1hcGFjaGU=-global Developer Tools
Apache Airflow Qml0bmFtaS1haXJmbG93-global Databases
Apache Airflow Qml0bmFtaS1haXJmbG93-global Developer Tools
ibmcloud catalog filter get
Exécutez la commande suivante pour extraire les détails du filtre pour le compte ou un catalogue spécifique.
ibmcloud catalog filter get --catalog CATALOG [--output FORMAT]
Options de commande
- --catalog CATALOG
- Nom ou ID du catalogue.
- --account-group ACCOUNT GROUP
- Nom ou ID du groupe de comptes. Cette zone s'applique uniquement aux comptes d'entreprise.
- --output FORMAT (facultatif)
- Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et la seule alternative supportée est JSON. Par exemple,
--output json.
Sortie
La commande génère la sortie suivante :
Account: The IBM Cloud catalog is visible to all users in this account.
Filter:
Including IBM Cloud catalog
Type Include Tags
Pricing plan false Free
Provider false Third Party
ibmcloud catalog filter create
Exécutez la commande suivante pour créer un filtre. Si un filtre existe, cette commande remplace le filtre en cours.
ibmcloud catalog filter create [--catalog CATALOG] [--category CATEGORY] [--compliance COMPLIANCE] [--deployment-target TARGET] [--exclude-list LIST] [--include-all ALL] [--include-list LIST] [--offering-format FORMAT] [--pricing-plan PLAN] [--provider PROVIDER] [--release RELEASE] [--type TYPE]
Options de commande
- --catalog CATALOG (facultatif)
- Spécifier le nom ou l'ID du catalogue. Si cette option n'est pas spécifiée, le filtre est créé au niveau du compte.
- --account-group ACCOUNT GROUP
- Nom ou ID du groupe de comptes. Uniquement applicable aux comptes d'entreprise.
- --hide-ibm-catalog (facultatif)
- Par défaut, le catalogue est visible pour tous les utilisateurs de ce compte. En ajoutant cet indicateur, vous pouvez rendre les produits disponibles uniquement pour les utilisateurs de votre choix en désactivant la visibilité du catalogue IBM Cloud et en ajoutant les produits à vos catalogues privés.
- --include-all BOOLEAN (facultatif)
- La valeur par défaut est true si l'indicateur n'est pas fourni. Les valeurs valides sont
trueetfalse. Si la valeur est true, le filtre inclut par défaut la totalité du catalogue public et les filtres suivants sont exclus. Si la valeur est false, le filtre exclut la totalité du catalogue public, et les indicateurs suivants sont inclus. Pour plus d'informations, voir Gestion des paramètres de catalogue.
--offering-format FORMAT (facultatif)
- --category CATEGORY (facultatif)
- Indiquez la catégorie qui correspond le mieux à la façon dont les utilisateurs peuvent utiliser votre produit. Les catégories sont utilisées pour organiser les produits du catalogue selon qu'ils partagent des solutions, des fonctions ou
une utilisation communes. Vous ne pouvez sélectionner qu'une seule catégorie. Exécutez la commande
ibmcloud catalog offering category-optionspour afficher toutes les options. La valeur par défaut estDeveloper tools. - --compliance TYPE (facultatif)
- Indiquez une liste de catégories de conformité, séparées par des virgules, que vous souhaitez inclure ou exclure. Exécutez la commande
ibmcloud catalog filter optionspour afficher toutes les options. - --deployment-target TARGET (facultatif)
- Indiquez une liste de cibles de déploiement, séparées par des virgules, que vous souhaitez inclure ou exclure. Exécutez la commande
ibmcloud catalog filter optionspour afficher toutes les options. - --exclude-list LIST (facultatif)
- Spécifiez une liste d'ID ou de noms de produits séparés par des virgules à exclure du catalogue public filtré.
- --include-list LIST (facultatif)
- Spécifiez une liste d'ID ou de noms de produits séparés par des virgules à inclure du catalogue public filtré.
- Indiquez une liste de formats de produit, séparés par des virgules, que vous souhaitez inclure ou exclure. Exécutez la commande
ibmcloud catalog filter optionspour afficher toutes les options. - --pricing-plan PLAN (options)
- Indiquez une liste de plans de tarification, séparés par des virgules, que vous souhaitez inclure ou exclure. Exécutez la commande
ibmcloud catalog filter optionspour afficher toutes les options. - --provider PROVIDER (facultatif)
- Indiquez une liste de fournisseurs, séparés par des virgules, que vous souhaitez inclure ou exclure. Exécutez la commande
ibmcloud catalog filter optionspour afficher toutes les options. - --release RELEASE (facultatif)
- Indiquez une liste de catégories, séparées par des virgules, que vous souhaitez inclure ou exclure. Exécutez la commande
ibmcloud catalog filter optionspour afficher toutes les options. - --type TYPE (facultatif)
- Indiquez une liste de types de logiciel, séparés par des virgules, que vous souhaitez inclure ou exclure. Exécutez la commande
ibmcloud catalog filter optionspour afficher toutes les options.
ibmcloud catalogue filtre supprimer
Exécutez la commande suivante pour supprimer un filtre appliqué. Ce filtre rétablit par défaut le niveau du compte, sauf si un catalogue est spécifié. Le filtre est donc réinitialisé pour inclure tous les produits dans le catalogue public.
ibmcloud catalog filter delete --catalog CATALOG
Options de commande
- --catalog CATALOG
- Nom ou ID du catalogue.
- --account-group ACCOUNT GROUP
- Nom ou ID du groupe de comptes. Uniquement applicable aux comptes d'entreprise.
ibmcloud catalog filter offering
Mettez à jour le filtre pour inclure ou exclure un produit particulier et tous les plans de tarification applicables. Ce filtre rétablit par défaut le niveau du compte, sauf si un catalogue ou un groupe de comptes est spécifié.
ibmcloud catalog filter offering --offering PRODUCT-NAME
Options de commande
- --catalog CATALOG
- Nom ou ID du catalogue.
- --account-group ACCOUNT GROUP
- Nom ou ID du groupe de comptes. Uniquement applicable aux comptes d'entreprise.
- --plans-list PLANS LIST
- Liste d'ID ou de noms de plan séparés par des virgules à inclure ou exclure.
- --offering OFFERING
- Nom ou ID du produit.
- --include
- La valeur par défaut est true si aucun indicateur n'est fourni. Les valeurs valides sont
trueetfalse. Si la valeur est true, le produit et les plans fournis sont visibles par les utilisateurs du compte. Si la valeur est false, le produit et les plans ne sont pas visibles par les utilisateurs du compte.
ibmcloud catalog filter hide-ibm-public-catalog
Par défaut, le catalogue IBM Cloud est visible par tous les utilisateurs du compte. Vous pouvez rendre les produits disponibles uniquement pour les utilisateurs de votre choix en désactivant la visibilité du catalogue IBM Cloud et en ajoutant les produits à vos catalogues privés.
ibmcloud catalog filter hide-ibm-public-catalog
ibmcloud catalog filter show-ibm-public-catalog
Par défaut, le catalogue IBM Cloud est visible par tous les utilisateurs du compte. Vous pouvez rendre les produits disponibles uniquement pour les utilisateurs de votre choix en désactivant la visibilité du catalogue IBM Cloud et en ajoutant les produits à vos catalogues privés.
ibmcloud catalog filter show-ibm-public-catalog
ibmcloud catalogue filtre options
Exécutez la commande suivante pour extraire les options de filtre pour chaque catégorie de filtre.
ibmcloud catalog filter options
Options de commande
- --all
- Inclut le secteur d'activité, le type de solution et le plan de tarification dans la liste des filtres.
- --output FORMAT (facultatif)
- Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et la seule alternative supportée est JSON. Par exemple,
--output json.
Sortie
La commande génère la sortie suivante :
Deployment target ID
IBM Cloud Kubernetes Service target_iks
IBM Cloud Schematics target_terraform
Red Hat OpenShift target_roks
VMware vCenter Server target_vcenter
Virtual private cloud target_vpc-x86
Power Systems Virtual Server target_power-iaas
Provider ID
Third party ibm_third_party
Community ibm_community
IBM ibm_created
Release ID
Beta ibm_beta
Deprecated ibm_deprecated
Works with ID
SAP Certified sap_certified
Quantum Technologies quantum_tech
Satellite Enabled satellite_enabled
HPC hpc
Support ID
Third party supported support_third_party
Community supported support_community
IBM supported support_ibm
Delivery method ID
Cloud Paks cloud_pak
Helm charts helm
Operators operator
OVA Images ova
Starter kits template
Terraform terraform
Server Images vsi_image
Blueprint blueprint
Toolchains toolchain
Compliance ID
EU Supported eu_access
Financial Services Validated fs_ready
HIPAA Enabled hipaa
IAM-enabled rc_compatible
Service Endpoint Supported service_endpoint_supported
Category ID Tags
Compute compute compute,compute_classic,content,openwhisk,runtime,virtualservers,compute_baremetal
Containers containers containers,clusters,registry
Networking network network,network_vpc,network_classic,network_edge,network_interconnectivity
Storage storage storage,storage_vpc,storage_classic,storage_datamovement
Converged infrastructure converged_infra converged_infra
Enterprise applications enterprise_app enterprise_app
AI / Machine Learning ai watson,ai
Analytics analytics data_analytics,business_analytics,analytics
Blockchain blockchain blockchain
Databases databases data_management,database
Developer tools devops dev_ops
Logging and monitoring logging_monitoring logging_monitoring
Migration migration_tools migration_tools
Integration integration integration,api
Internet of Things iot internet_of_things
Security security security
Mobile mobile mobile,web_and_app
ibmcloud catalog offering create
Exécutez la commande suivante pour ajouter un produit à un catalogue privé dans le compte.
ibmcloud catalog offering create [--catalog CATALOG_NAME] [--zipurl URL] [--include-config] [--target-version VERSION] [--token TOKEN] [--vpc-body BODY]
Options de commande
- --catalog CATALOG_NAME
- Nom ou ID du catalogue.
- - --zipurl URL (facultatif)
- URL désignant le fichier .zip du produit.
- --target-version VERSION
- Indiquez la version du produit.
- --include-config (facultatif)
- Si cette option est spécifiée, toutes les valeurs de configuration sont incluses et disponibles lorsque vous ajoutez le produit.
- --token TOKEN (optional)
- Indiquez le jeton d'accès personnel pour un référentiel privé.
- --vpc-body BODY (optionnel)
- Fournissez les informations permettant d'importer une image de serveur virtuel pour VPC, y compris un nom, un libellé, un type d'installation, un type de cible, une version, un sha, des balises et des métadonnées.
Exemple d'image de serveur virtuel pour VPC #1
Importez une image de serveur virtuel pour VPC en tant qu'offre dans un catalogue avec l'ID 51c9e0db-2911-45a6-adb0-ac5332d27cf2.
ibmcloud catalog offering create --catalog 51c9e0db-2911-45a6-adb0-ac5332d27cf2 --vpc-body '{
"name": "virtual-server-image",
"label": "virtual server image",
"install_kind": "instance",
"target_kinds": ["vpc-x86"],
"version": "0.0.10",
"sha": "64245e5f3f1e9c4048b18db3abd1450d4b6f9e263ac1b33df6fc1ae96fcbdebb",
"tags": ["virtualservers"],
"metadata": {
"operating_system": {
"dedicated_host_only": false,
"vendor": "CentOS",
"name": "centos-7-amd64",
"href": "https://us-south-stage01.iaasdev.cloud.ibm.com/v1/operating_systems/centos-7-amd64",
"display_name": "CentOS 7.x - Minimal Install (amd64)",
"family": "CentOS",
"version": "7.x - Minimal Install",
"architecture": "amd64"
},
"minimum_provisioned_size": 100,
"file": {
"size": 1
},
"images": [{"id": "r134-14903434-faf0-4a66-b861-7b35198de393", "name": "virtual-server-image", "region": "us-south"}]
}
}'
Exemple d'image de serveur virtuel pour VPC #2
Importez une image de serveur virtuel pour VPC en tant qu'offre dans un catalogue avec l'ID 2bdc3974-dfcf-4711-b298-cd238f7d3734.
ibmcloud catalog offering create --catalog 2bdc3974-dfcf-4711-b298-cd238f7d3734 --vpc-body '{
"name": "virtual-server-image-s390x",
"label": "virtual-server-image-s390x",
"install_kind": "instance",
"target_kinds": ["vpc-z"],
"version": "0.0.10",
"sha": "4739f1eaeeebc69ad5d48f9191fcc0d23960cb720bb16c67e915e5556c1da9b2",
"tags": ["virtualservers"],
"metadata": {
"operating_system": {
"dedicated_host_only": false,
"vendor": "SUSE Linux Enterprise Server",
"name": "sles-15-sp2-s390x-byol",
"href": "https://us-south-stage01.iaasdev.cloud.ibm.com/v1/operating_systems/sles-15-s390x",
"display_name": "Suse enterprise server(s390x)",
"family": "SUSE",
"version": "15-sp2",
"architecture": "s390x"
},
"minimum_provisioned_size": 100,
"file": {
"size": 1
},
"images": [{"id": "r134-f20e2e4e-3133-423c-afa2-365afa14c4dc", "name": "virtual-server-image-s390x", "region": "us-south"}]
}
ibmcloud catalog offering list
Exécutez la commande suivante pour obtenir les détails des produits de vos catalogues privés. Cette commande permet de filtrer en fonction de la version, du produit et du catalogue privé.
ibmcloud catalog offering list [--catalog CATALOG] [--offering OFFERING_NAME] [--version VERSION] [--output FORMAT]
Options de commande
- --catalog CATALOG
- Nom ou ID du catalogue.
- --output FORMAT (facultatif)
- Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et la seule alternative supportée est JSON, par exemple,
--output json.
Exemple
Répertoriez tous les produits du catalogue dev-catalog.
ibmcloud catalog offering list --catalog dev-catalog
Sortie
La commande génère la sortie suivante :
Name ID Current State Version Locator
Cloud Pak for Automation cb90274e-398b-4373-9b28-d6428d3302df
|__OpenShift
|__19.0.2 New 7b7e590f-259b-437b-b1f4-39e8615ed837.21d1d712-80ab-4318-9d05-73c6caaaee23
Cloud Pak for Data 8993c7b1-1794-4447-9275-db83faa08ee4
|__OpenShift
|__2.1.0.2 New 7b7e590f-259b-437b-b1f4-39e8615ed837.ab6ba56f-788d-4d6b-b880-a1001fca8451
harbor 927adb44-6784-4bec-a771-f639900f07f1
|__Kubernetes
|__1.9.1 New 7b7e590f-259b-437b-b1f4-39e8615ed837.e437b06c-273f-49de-8c44-f55e408abf78
IBM Starter Collection for Openshift fd1857f4-cf17-4e97-9443-b615bc71f6a0
|__OpenShift
|__0.0.1 New 7b7e590f-259b-437b-b1f4-39e8615ed837.72e0f636-9dc4-49ae-b3c2-7a5de90487b9
tf_cloudless_sleepy-2.0 c260a67a-1b25-49fc-9896-46e7e6212990
|__
|__1.0.0 New 7b7e590f-259b-437b-b1f4-39e8615ed837.965df91d-5760-4872-adf6-4019796c06b0
|__1.0.1 New 7b7e590f-259b-437b-b1f4-39e8615ed837.aff4cecb-4c9b-41ba-ae3d-71f4217dc0bc
ibmcloud catalog offering search
Exécutez la commande suivante pour obtenir les détails des produits de vos catalogues privés. Cette commande permet de filtrer en fonction de la version, du produit et du catalogue privé.
ibmcloud catalog offering search [--catalog CATALOG] [--offering OFFERING_NAME] [--version VERSION] [--output FORMAT]
Options de commande
- --catalog CATALOG (facultatif)
- Nom ou ID du catalogue.
- --offering OFFERING (facultatif)
- Nom ou ID du produit.
- --version VERSION (facultatif)
- Nom ou ID de la version.
- --output FORMAT (facultatif)
- Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et la seule alternative supportée est JSON, par exemple,
--output json.
Exemple
Répertoriez tous les produits du catalogue dev-catalog.
ibmcloud catalog offering list --catalog dev-catalog
Sortie
La commande génère la sortie suivante :
Name Current State Version Locator
dev-catalog
|__dev-offering
| |__Kubernetes
| |__1.0.0 Validated b636d651-8489-4425-bd6a-f30af1603577.17ac792e-a603-4f1a-a1b6-48e90a46940c
|__dev-offering-2.0
| |__Kubernetes
| |__1.0.0 Published to account b636d651-8489-4425-bd6a-f30af1603577.decdb0e1-46d2-401a-b482-80f9d6855f98
ibmcloud catalog offering get
Exécutez la commande suivante pour obtenir les détails relatifs à un produit spécifique du catalogue.
ibmcloud catalog offering get --catalog CATALOG --offering OFFERING_NAME [--output FORMAT]
Options de commande
- --catalog CATALOG
- Nom ou ID du catalogue.
- --offering OFFERING_NAME
- Nom ou ID du produit.
- --output FORMAT (facultatif)
- Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et la seule alternative supportée est JSON, par exemple,
--output json.
Sortie
La commande génère la sortie suivante :
Name Current State Version Locator
dev-offering
|__
|__1.0.0 Draft 480fb4e3-d7ba-4e9b-9d4c-42f0ab811040.a92f5409-ebd9-413c-88ae-7ed311c1b793
ibmcloud catalog offering import-version
Exécutez la commande suivante pour importer une nouvelle version d'un produit dans votre catalogue privé.
ibmcloud catalog offering import-version --catalog CATALOG --offering OFFERING_NAME [--zipurl URL] [--target-version APP_VERSION] [--include-config] [--vpc-body BODY]
Options de commande
- --catalog CATALOG
- Nom ou ID du catalogue.
- --offering OFFERING_NAME
- : Nom ou ID du produit.
- - --zipurl URL (facultatif)
- Le site URL qui pointe vers le fichier.zip du produit.
- --target-version APP_VERSION (facultatif)
- Version d'application de l'élément "tgz" importé.
- --include-config (facultatif)
- Si cette option est indiquée, toutes les valeurs de configuration sont incluses et disponibles lorsque vous importez la nouvelle version.
- --vpc-body BODY (optionnel)
- Fournissez les informations permettant d'importer une image de serveur virtuel pour VPC, y compris un nom, un libellé, un type d'installation, un type de cible, une version, un sha, des balises et des métadonnées.
Image de serveur virtuel pour VPC Exemple
Importer une image de serveur virtuel pour VPC dans une offre existante avec dans un catalogue avec ID 51c9e0db-2911-45a6-adb0-ac5332d27cf2 et ID d'offre 97cdaf1b-62b2-48e2-8589-10b31023866d.
ibmcloud catalog offering import-version --catalog 51c9e0db-2911-45a6-adb0-ac5332d27cf2 --offering 97cdaf1b-62b2-48e2-8589-10b31023866d --vpc-body '{
"name": "virtual-server-image",
"label": "virtual server image",
"install_kind": "instance",
"target_kinds": ["vpc-x86"],
"version": "0.0.10",
"sha": "64245e5f3f1e9c4048b18db3abd1450d4b6f9e263ac1b33df6fc1ae96fcbdebb",
"tags": ["virtualservers"],
"metadata": {
"operating_system": {
"dedicated_host_only": false,
"vendor": "CentOS",
"name": "centos-7-amd64",
"href": "https://us-south-stage01.iaasdev.cloud.ibm.com/v1/operating_systems/centos-7-amd64",
"display_name": "CentOS 7.x - Minimal Install (amd64)",
"family": "CentOS",
"version": "7.x - Minimal Install",
"architecture": "amd64"
},
"minimum_provisioned_size": 100,
"file": {
"size": 1
},
"images": [{"id": "r134-14903434-faf0-4a66-b861-7b35198de393", "name": "virtual-server-image", "region": "us-south"}]
}
}''
ibmcloud catalog offering update
Pour mettre à jour un produit dans votre catalogue privé, vous devez d'abord obtenir le produit, puis vous pouvez le mettre à jour.
Exécutez la commande offering get. Pour plus d'informations, voir l'offre de catalogue ibmcloud get.
ibmcloud catalog offering get -c <CATALOGID> -o <OFFERINGID> --output json
Exécutez la commande offering update.
ibmcloud catalog offering update -c <CATALOGID> -o <OFFERINGID> --updated-offering <UPDATED_OFFERING.json>
ibmcloud catalog offering version preinstall
Exécutez la commande suivante pour exécuter le script de préinstallation pour un produit spécifique.
ibmcloud catalog offering version preinstall --version-locator VERSION_NUMBER --cluster CLUSTER_ID --namespace NAME
Options de commande
- --version-locator VERSION_NUMBER
- Pour obtenir le releveur de coordonnées de version de ce produit, exécutez la commande
ibmcloud catalog offering listet recherchez le produit et la version spécifiés que vous souhaitez utiliser. - --cluster CLUSTER_ID
- Spécifiez l'ID de cluster dans lequel vous souhaitez installer le produit.
- --namespace NAME
- Indiquez l'espace de nom que vous souhaitez utiliser. Si vous en indiquez un nouveau, il est automatiquement créé lors de la préinstallation.
Exemple
Exécutez le script de préinstallation d'un produit avec un numéro de releveur de coordonnées de version b636d651-8489-4425-bd6a-f30af1603577.18aad484-c78b-4269-808b-52027621abd4 dans l'espace de nom bn5ebho206o7fg45f2e0 du cluster ayant l'ID test-namespace.
ibmcloud catalog offering version preinstall --version-locator b636d651-8489-4425-bd6a-f30af1603577.18aad484-c78b-4269-808b-52027621abd4 --cluster bn5ebho206o7fg45f2e0 --namespace test-namespace
ibmcloud catalog offering version preinstall-status
Exécutez la commande suivante pour obtenir le statut d'une préinstallation en cours.
ibmcloud catalog offering version preinstall-status --version-locator VERSION_NUMBER --cluster CLUSTER_ID --namespace NAME [--output FORMAT]
Options de commande
- --version-locator VERSION_NUMBER
- Pour obtenir le releveur de coordonnées de version du produit, exécutez la commande
ibmcloud catalog offering listet recherchez le produit et la version spécifiés que vous souhaitez utiliser. - --cluster CLUSTER_ID
- Indiquez l'ID de cluster dans lequel la préinstallation a été exécutée.
- --namespace NAME
- Indiquez l'espace de nom utilisé pour la préinstallation.
- --output FORMAT (facultatif)
- Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et la seule alternative supportée est JSON, par exemple,
--output json.
ibmcloud catalog offering version validate
Exécutez la commande suivante pour valider une nouvelle version d'un produit dans votre catalogue privé. Il est nécessaire de valider les produits afin qu'ils puissent fonctionner comme cela a été prévu avant de pouvoir être publiés dans le compte pour que d'autres utilisateurs créent une instance à partir du catalogue privé.
ibmcloud catalog offering version validate --version-locator VERSION_NUMBER --cluster CLUSTER_ID --namespace NAME [--timeout TIMEOUT] [--wait WAIT] [--override-values VALUES|FILENAME] [--workspace-tf-version VERSION] [--workspace-region REGION] [--workspace-rg-id ID][--schematics-destroy][--schematics-delete]
Options de commande
- --version-locator VERSION_NUMBER
- Pour obtenir le releveur de coordonnées de version du produit, exécutez la commande
ibmcloud catalog offering listet recherchez le produit et la version spécifiés que vous souhaitez utiliser. - --cluster CLUSTER_ID
- Spécifiez l'ID de cluster dans lequel vous souhaitez installer le produit.
- --namespace NAME
- Indiquez l'espace de nom que vous souhaitez utiliser. Si vous en indiquez un nouveau, il est automatiquement créé lors de la préinstallation.
- --timeout TIMEOUT
- Indiquez, en secondes, le délai d'attente d'installation pour l'espace de travail Schematics. La valeur par défaut est
180. - --wait WAIT
- Attendez et suivez la progression du travail de l'espace de travail Schematics. Si la valeur est
true, l'installation attend. Si la valeur estfalse, le logiciel s'installe immédiatement. La valeur par défaut esttrue. - --override-values VALUES|FILENAME (facultatif)
- Indiquez des configurations personnalisées pour l'installation. Vous pouvez spécifier cette valeur en ligne ou en utilisant un fichier JSON ou TXT. Par exemple,
override-values values.json. Lors de la validation d'une image de serveur virtuel pour VPC, les zones suivantes doivent être fournies: vsi_instance_name, vsi_id, vpc_profile, subnet_id, vpc_id, subnet_zone, ssh_key_id, vpc_region - --workspace-tf-version VERSION (facultatif)
- Indiquer une version terraform de l'espace de travail.
- -- workspace-region REGION (facultatif)
- Indiquer une région d'espace de travail.
- --workspace-rg-id ID (facultatif)
- Indiquez un ID groupe de ressources de l'espace de travail.
- -- schematics-destroy (facultatif)
- Indiquez ce drapeau pour supprimer les ressources de l'espace de travail après la validation et l'installation.
- -- schematics-delete VALUE (facultatif)
- Indiquez cet indicateur pour supprimer l'espace de travail Schematics après validation et installation.
Exemple de validation d'un produit utilisant un cluster
Validez un produit avec le releveur de coordonnées de version b636d651-8489-4425-bd6a-f30af1603577.18aad484-c78b-4269-808b-52027621abd4 dans un espace de nom bn5ebho206o7fg45f2e0 d'un cluster ayant l'ID test-namespace.
Cette installation inclut des configurations personnalisées. Les valeurs sont donc fournies en utilisant un fichier values.json.
ibmcloud catalog offering version validate --version-locator b636d651-8489-4425-bd6a-f30af1603577.18aad484-c78b-4269-808b-52027621abd4 --cluster bn5ebho206o7fg45f2e0 --namespace test-namespace --override-values values.json
Remplacer le format exemple des valeurs dans le fichier values.json :
{
"username": "provision-test-1",
"password": "passw0rd"
}
Image de serveur virtuel pour VPC Exemple
Validez un produit avec le localisateur de version 51c9e0db-2911-45a6-adb0-ac5332d27cf2.ecebffdc-f1f8-4a85-965f-9cbe31920542 dans un VPC avec l'ID r134-476cbb67-a6c2-4957-9806-3fcbac3498be.
ibmcloud catalog offering version validate --version-locator 51c9e0db-2911-45a6-adb0-ac5332d27cf2.ecebffdc-f1f8-4a85-965f-9cbe31920542 --workspace-region=us-south --workspace-rg-id Default --override-values '{
"vsi_instance_name": "instance-name-1",
"vsi_id": "r134-14903434-faf0-4a66-b861-7b35198de393",
"vpc_profile": "bx2-2x8",
"subnet_id": "0716-d799c449-466c-4844-902c-a5d3f8948d7d",
"vpc_id": "r134-476cbb67-a6c2-4957-9806-3fcbac3498be",
"subnet_zone": "us-south-1",
"ssh_key_id": "r134-0c53e7f2-771f-4d0e-a19e-39f2e6e6949c",
"vpc_region": "us-south"
}
ibmcloud catalog offering version validate-status
Exécutez la commande suivante pour obtenir le statut d'une validation en cours.
ibmcloud catalog offering version validate-status --version-locator VERSION_NUMBER [--output FORMAT]
Options de commande
- --version-locator VERSION_NUMBER
- Pour obtenir le releveur de coordonnées de version du produit, exécutez la commande
ibmcloud catalog offering listet recherchez le produit ou la version spécifié à utiliser. - --output FORMAT (facultatif)
- Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et la seule alternative supportée est JSON, par exemple,
--output json.
ibmcloud catalog offering category-options
Exécutez la commande suivante pour extraire la liste des choix de catégorie.
ibmcloud catalog offering category-options [--output FORMAT]
Options de commande
- --output FORMAT (facultatif)
- Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et la seule alternative supportée est JSON, par exemple,
--output json.
Exemple
ibmcloud catalog offering category-options
Sortie
La commande génère la sortie suivante :
Name Tags Description
VPC Infrastructure vpc Fully customizable, software-defined virtual network with superior isolation.
Compute compute,content,containers,openwhisk,vmware,runtime Build your virtual environments
Containers containers,clusters,registry Get started by creating a Kubernetes cluster, or manage your Docker images in the registry.
Networking network Order network.
Storage storage Order storage.
ibmcloud catalog offering add-category
Exécutez la commande suivante pour ajouter une balise de catégorie à un produit. Vous pouvez indiquer le nom de la catégorie, que vous trouverez en exécutant la commande ibmcloud catalog offering category-options. Pour pouvoir être
visibles dans le catalogue, les produits doivent être placés dans une catégorie. La valeur par défaut est Developer tools.
ibmcloud catalog offering category-options [--output FORMAT]
Options de commande
- --catalog CATALOG
- Nom ou ID du catalogue.
- --offering OFFERING
- Nom ou ID du produit.
- --category CATEGORY
- Indiquez la catégorie qui correspond le mieux à la façon dont les utilisateurs peuvent utiliser votre produit. Les catégories sont utilisées pour organiser les produits du catalogue selon qu'ils partagent des solutions, des fonctions ou
une utilisation communes. Vous ne pouvez sélectionner qu'une seule catégorie. Exécutez la commande
ibmcloud catalog offering category-optionspour afficher toutes les options. La valeur par défaut estDeveloper tools.
Exemple
ibmcloud catalog offering add-category --catalog dev-catalog --offering dev-offering --category dev_ops
catégories d'offre de catalogue ibmcloud
Exécutez la commande suivante pour extraire la catégorie d'une version de produit.
ibmcloud catalog offering version categories [--catalog CATALOG] [--offering OFFERING] [--output OUTPUT]
Options de commande
- --catalog CATALOG
- Nom ou ID du catalogue.
- --offering OFFERING
- Nom ou ID du produit.
- --output FORMAT (facultatif)
- Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et la seule alternative supportée est JSON. Par exemple,
--output json.
Exemple
Extrayez la catégorie d'un produit appelé dev-offering et situé dans dev-catalog.
ibmcloud catalog offering version categories --catalog dev-catalog --offering dev-offering
ibmcloud catalog offering version get-claims
Exécutez la commande suivante pour extraire les informations de sécurité et de conformité réclamées par une version.
ibmcloud catalog offering version get-claims [--output OUTPUT] [--version-locator LOCATOR]
Options de commande
- --version-locator LOCATEUR
- Pour obtenir le releveur de coordonnées de version du produit, exécutez la commande
ibmcloud catalog offering listet recherchez le produit ou la version spécifié à utiliser. - --output valeur (optionnelle)
- Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et la seule alternative supportée est JSON, par exemple,
--output json.
ibmcloud catalog offering version update-claims
Exécutez la commande suivante pour mettre à jour les déclarations de sécurité et de conformité d'une version.
ibmcloud catalog offering version update-claims [--claims CLAIMS] [--version-locator LOCATOR]
Options de commande
- --claims RÉCLAMATIONS
- Spécifiez les données de réclamation pour une version en tant qu'objet ou fichier JSON.
- --version-locator LOCATEUR
- Pour obtenir le releveur de coordonnées de version du produit, exécutez la commande
ibmcloud catalog offering listet recherchez le produit ou la version spécifié à utiliser.
ibmcloud catalog offering version scc-apply
Exécutez la commande suivante pour ajouter un examen Security and Compliance Center à votre version. Ajoutez des informations de sécurité et de conformité à votre version et validez votre version avant de pouvoir ajouter une analyse.
ibmcloud catalog offering version scc-apply [--instance-region REGION] [--scan SCAN] [--service-instance INSTANCE] [--target-account-name NAME] [--target-api-key KEY] [--timeout TIMEOUT] [--version-locator LOCATOR] [--wait WAIT]
Options de commande
- --instance-region RÉGION
- La région de l'instance.
- --scan SCAN
- ID d'une analyse Security and Compliance Center.
- --service-instance INSTANCE
- Indiquez l'ID d'instance Security and Compliance Center.
- --target-account-name NOM (facultatif)
- Indiquez le nom du compte cible.
- --target-api-key KEY (optionnel)
- Indiquez une clé d'API si vous souhaitez utiliser un autre compte (compte cible) pour appliquer un examen à votre compte source. Pour plus d'informations, voir Configuration d'un compte cible.
- --timeout TIMEOUT
- Indiquez, en secondes, la durée pendant laquelle vous souhaitez attendre que l'analyse soit appliquée à la version avant le retour de la commande. La valeur par défaut est 600 (10 minutes).
- --version-locator LOCATEUR
- Pour obtenir le releveur de coordonnées de version du produit, exécutez la commande
ibmcloud catalog offering listet recherchez le produit ou la version spécifié à utiliser. - --wait WAIT
- Attendez et suivez la progression d'une application d'examen. La valeur par défaut est true si l'indicateur n'est pas fourni. Si
true, la commande suit la progression de l'application d'analyse. Si la valeur estfalse, la commande est renvoyée immédiatement.
ibmcloud catalog offering version scc-apply-status
Exécutez la commande suivante pour afficher le statut d'une application d'analyse Security and Compliance Center sur votre version.
ibmcloud catalog offering version scc-apply-status [--scan SCAN] [--version-locator LOCATOR]
Options de commande
- --scan SCAN
- ID d'une analyse Security and Compliance Center.
- --version-locator LOCATEUR
- Pour obtenir le releveur de coordonnées de version du produit, exécutez la commande
ibmcloud catalog offering listet recherchez le produit ou la version spécifié à utiliser.
ibmcloud catalog offering version get-scans
Exécutez la commande suivante pour extraire les analyses Security and Compliance Center ajoutées à votre version.
ibmcloud catalog offering version get-scans [--instance-region REGION] [--output OUTPUT] [--profiles PROFILES] [--service-instance INSTANCE] [--target-account-name NAME] [--target-api-key KEY]
Options de commande
- --instance-region RÉGION
- Indiquer la région de l'instance.
- --output OUTPUT (optionnel)
- Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et la seule alternative supportée est JSON. Par exemple,
--output json. - --profiles PROFILS
- Fournissez une liste séparée par des virgules de noms de profil avec des versions, par exemple,
"IBM Cloud for Financial Services::1.2.0". - --service-instance INSTANCE
- Indiquez l'ID d'instance Security and Compliance Center.
- --target-account-name NOM (facultatif)
- Indiquez le nom du compte cible.
- --target-api-key KEY (optionnel)
- Indiquez une clé d'API si vous souhaitez utiliser un autre compte (compte cible) pour appliquer un examen à votre compte source. Pour plus d'informations, voir Configuration d'un compte cible.
ibmcloud catalog offering get-scan-results
Exécutez la commande suivante pour générer un rapport sur les résultats de l'analyse du Code Risk Analyzer et du Security and Compliance Center votre version. Pour générer un rapport complet, vous devez exécuter les analyses du Code Risk Analyzer et du Security and Compliance Center
ibmcloud catalog offering get-scan-results [--version-locator LOCATOR]
Options de commande
- --version-locator LOCATEUR
- Pour obtenir le releveur de coordonnées de version du produit, exécutez la commande
ibmcloud catalog offering listet recherchez le produit ou la version spécifié à utiliser.
ibmcloud catalog offering version create-draft
Exécutez la commande suivante pour créer un brouillon d'une version existante. Cette commande est utile lorsque vous voulez modifier une version existante que vous souhaitez publier sans créer de nouvelle version. Pour certaines modifications, comme le changement de fichier source, vous devez valider le produit à nouveau.
ibmcloud catalog offering version create-draft --version-locator VERSION_NUMBER [--output FORMAT]
Options de commande
- --version-locator VERSION_NUMBER
- Pour obtenir le releveur de coordonnées de version du produit, exécutez la commande
ibmcloud catalog offering listet recherchez le produit ou la version spécifié à utiliser. - --output FORMAT (facultatif)
- Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et la seule alternative supportée est JSON. Par exemple,
--output json.
ibmcloud catalog offering version delete-version
Exécutez la commande suivante pour supprimer une version d'un produit.
ibmcloud catalog offering version delete-version --version-locator VERSION_NUMBER [--output FORMAT]
Options de commande
- --version-locator VERSION_NUMBER
- Pour obtenir le releveur de coordonnées de version du produit, exécutez la commande
ibmcloud catalog offering listet recherchez le produit ou la version spécifié à utiliser. - --output FORMAT (facultatif)
- Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et la seule alternative supportée est JSON. Par exemple,
--output json.
ibmcloud catalog offering version deprecate-version
Exécutez la commande suivante pour déprécier dans le catalogue IBM Cloud une version de produit précédemment publiée.
ibmcloud catalog offering version deprecate-version --version-locator VERSION_NUMBER
Options de commande
- --version-locator VERSION_NUMBER
- Pour obtenir le releveur de coordonnées de version du produit, exécutez la commande
ibmcloud catalog offering listet recherchez le produit ou la version spécifié à utiliser.
ibmcloud catalog offering version refresh-version
Exécutez la commande suivante pour créer une modification dans le fichier source d'une version préliminaire. Cette commande est utile pour la mise à jour d'une version existante.
ibmcloud catalog offering version refresh-version --version-locator VERSION_NUMBER --zipurl URL [--include-config]
Options de commande
- --version-locator VERSION_NUMBER
- Pour obtenir le releveur de coordonnées de version du produit, exécutez la commande
ibmcloud catalog offering listet recherchez le produit ou la version spécifié à utiliser. - --zipurl URL
- Le site URL qui pointe vers le fichier compressé du produit.
- --include-config (facultatif)
- Si cette option est spécifiée, toutes les valeurs de configuration sont incluses et disponibles lorsque vous ajoutez le produit.
ibmcloud catalog offering version merge-draft
Exécutez la commande suivante pour fusionner une version brouillon d'un produit.
ibmcloud catalog offering version merge-draft --version-locator VERSION_NUMBER
Options de commande
- --version-locator VERSION_NUMBER
- Pour obtenir le releveur de coordonnées de version du produit, exécutez la commande
ibmcloud catalog offering listet recherchez le produit ou la version spécifié à utiliser.
ibmcloud catalog offering ready
Exécutez la commande suivante pour marquer votre produit comme prêt pour partage ou publication.
ibmcloud catalog offering ready --version-locator VERSION_NUMBER
Options de commande
- --version-locator VERSION_NUMBER
- Pour obtenir le releveur de coordonnées de version du produit, exécutez la commande
ibmcloud catalog offering listet recherchez le produit ou la version spécifié à utiliser.
ibmcloud catalog offering delete
Exécutez la commande suivante pour supprimer un produit de votre catalogue privé. Vous ne pouvez pas supprimer un produit publié dans le catalogue IBM Cloud. Pour déprécier un produit publié dans le catalogue IBM Cloud, voir ibmcloud catalog offering deprecate-offering.
ibmcloud catalog offering delete --catalog CATALOG --offering OFFERING
Options de commande
- --catalog CATALOG
- Nom ou ID du catalogue.
- --offering OFFERING
- Nom ou ID du produit.
ibmcloud catalog offering publish account
Exécutez la commande suivante pour publier un produit de votre catalogue privé sur un compte. Une fois le produit publié, les utilisateurs du compte ont accès au catalogue privé. Le groupe de ressources qui le contient peut créer une instance et commencer à l'utiliser.
ibmcloud catalog offering publish account [--catalog CATALOG][--offering OFFERING]
Options de commande
- --catalog CATALOG
- Nom ou ID du catalogue.
- --offering OFFERING
- Nom ou ID du produit.
ibmcloud catalog offering publish allowlist
Exécutez la commande suivante pour publier un produit de votre catalogue privé sur un ensemble de comptes figurant dans une liste autorisée. Une fois le produit publié, les utilisateurs des comptes autorisés peuvent créer une instance et commencer à l'utiliser.
ibmcloud catalog offering publish allowlist [--catalog CATALOG][--offering OFFERING][--account-ids ACCOUNT-IDS]
Options de commande
- --catalog CATALOG
- Nom ou ID du catalogue.
- --offering OFFERING
- Nom ou ID du produit.
- --account-ids ACCOUNT-IDS
- Les ID de compte.
ibmcloud catalog offering publish enterprise
Exécutez la commande suivante pour publier un produit dans une entreprise. Une fois le produit publié, les utilisateurs de l'entreprise peuvent créer une instance du produit.
ibmcloud catalog offering publish enterprise [--catalog CATALOG][--offering OFFERING]
Options de commande
- --catalog CATALOG
- Nom ou ID du catalogue.
- --offering OFFERING
- Nom ou ID du produit.
ibmcloud catalog offering suspend-offering
Exécutez la commande suivante pour suspendre un produit du catalogue. Vous pouvez le suspendre pour une courte période sans le supprimer définitivement ni le déprécier. La suspension d'un produit peut s'avérer utile, par exemple lorsque vous identifiez dans votre produit un bogue ou une vulnérabilité devant être examiné avant de permettre à davantage d'utilisateurs de l'installer.
ibmcloud catalog offering suspend-offering [--catalog CATALOG][--offering OFFERING]
Options de commande
- --catalog CATALOG
- Nom ou ID du catalogue.
- --offering OFFERING
- Nom ou ID du produit.
ibmcloud catalog offering version suspend-version
Exécutez la commande suivante pour suspendre une version d'un produit du catalogue. Vous pouvez suspendre la version pendant une courte période sans la supprimer définitivement ni la déprécier.
ibmcloud catalog offering version suspend-version [--version-locator VERSION_NUMBER]
Options de commande
- --version-locator VERSION_NUMBER
- Pour obtenir le releveur de coordonnées de version pour cette offre, exécutez
ibmcloud catalog offering listet recherchez la version que vous souhaitez utiliser.
ibmcloud catalog offering workspaces
Exécutez la commande suivante pour obtenir les espaces de travail Schematics pour une version de produit.
ibmcloud catalog offering workspaces [--version-locator VERSION_NUMBER] [output FORMAT]
Options de commande
- --version-locator VERSION_NUMBER
- Pour obtenir le releveur de coordonnées de version pour cette offre, exécutez
ibmcloud catalog offering listet recherchez la version spécifiée que vous souhaitez utiliser. - --output FORMAT (facultatif)
- Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et la seule alternative supportée est JSON. Par exemple,
--output json.
ibmcloud catalog install
Exécutez la commande suivante pour installer une version de logiciel à partir du catalogue IBM Cloud.
ibmcloud catalog install [--version-locator VERSION_NUMBER] [--cluster CLUSTER_ID] [--namespace NAME] [--override-values VALUES] [--timeout TIMEOUT] [--wait WAIT] [--workspace-name NAME] [--workspace-tags TAGS] [--workspace-tf-version VERSION] [--workspace-region REGION] [--workspace-rg-id ID] [schematics-delete VALUE]
Options de commande
- --version-locator VERSION_NUMBER
- Pour obtenir le releveur de coordonnées de version pour cette offre, exécutez
ibmcloud catalog offering listet recherchez la version que vous souhaitez utiliser. - --cluster CLUSTER_ID
- Spécifier le nom ou l'ID du cluster.
- --namespace NAME
- Indiquez l'espace de nom que vous souhaitez utiliser.
- --override-values VALUES
- Indiquez des configurations personnalisées pour l'installation. Vous pouvez spécifier cette valeur en ligne ou en utilisant un fichier JSON ou TXT. Par exemple,
override-values values.json. - --timeout TIMEOUT
- Indiquez, en secondes, le délai d'attente d'installation pour l'espace de travail Schematics. La valeur par défaut est
180. - --wait WAIT
- Attendez et suivez la progression du travail de l'espace de travail Schematics. Si la valeur est
true, l'installation attend. Si la valeur estfalse, le logiciel s'installe immédiatement. La valeur par défaut esttrue. - --workspace-name NAME (facultatif)
- Fournissez un nom d'espace de travail. La valeur par défaut est
OfferingName-Date. - --workspace-tags TAGS (facultatif)
- Fournissez une liste d'étiquettes séparées par des virgules.
- --workspace-tf-version VERSION (facultatif)
- Indiquer une version terraform de l'espace de travail.
- -- workspace-region REGION (facultatif)
- Indiquer une région d'espace de travail.
- --workspace-rg-id ID (facultatif)
- Indiquez un ID groupe de ressources de l'espace de travail.
- -- schematics-delete VALUE (facultatif)
- Indiquez cet indicateur pour supprimer l'espace de travail Schematics après validation et installation.
Exemple
Installez la version 1 du logiciel en utilisant cluster A, namespace install, et les valeurs de remplacement JSON values.json.
ibmcloud catalog install [--version-locator 1] [--cluster A] [--namespace install] [--override-values values.json]
Remplacer le format exemple des valeurs dans le fichier values.json :
{
"username": "install-test-1",
"password": "passw0rd"
}
tarification du catalogue ibmcloud
Exécutez la commande suivante pour obtenir des informations de tarification pour les offres de catalogue.
ibmcloud catalog pricing [-r, --region REGION] [-k, --kind KIND] [-p, --price PRICE] [--tag TAG] [--country COUNTRY] [--global] [--iam] [--json] [--csv] [-f, --file FILENAME]
Options de commande
- -r --region (facultatif)
- Filtrer par zone géographique.
- -k, --kind (facultatif)
- Filtrer par type de ressource. Actuellement,
service(par défaut),iaas,runtime,template, etgeographysont pris en charge - -p, --price (facultatif)
- Filtrer par prix. Actuellement, les sites
free,paygoetsubscriptionsont pris en charge - -t, --tag (facultatif)
- Filtrer par étiquette. Cet indicateur est répétable et produit un OU logique de toutes les étiquettes spécifiées.
- --co, --country (facultatif)
- Filtrer par pays. La sortie vers CSV ou JSON peut utiliser la valeur
ALLpour obtenir les valeurs pour tous les pays. - --json (facultatif)
- Produire une réponse JSON.
- --csv (optionnel)
- Produit un fichier CSV.
- -f --file (facultatif)
- Spécifiez un nom de fichier pour la sortie csv.
- --global (facultatif)
- Opérer dans une portée globale.
- --iam (facultatif)
- Filtrer par offres compatibles avec IAM.
Exemple
Obtenez des informations de tarification pour Virtual Server for VPC pour un compte de type Paiement à la carte.
ibmcloud catalog pricing is.instance [--price paygo]
ibmcloud catalog private-endpoint regions
Exécutez la commande suivante pour obtenir la liste des régions qui prennent en charge les points d'extrémité privés pour un service donné.
ibmcloud catalog private-endpoint regions [--service ID]
Options de commande
- --service
- Fournir l'ID ou le nom programmatique du service pour voir ses régions qui supportent le point de terminaison privé
ibmcloud catalog private-endpoint services
Exécutez la commande suivante pour récupérer la liste des services qui prennent en charge les points d'extrémité privés pour une région donnée.
ibmcloud catalog private-endpoint services [--region REGION]
Options de commande
- --region ou -r
- Indiquez la RÉGION pour connaître les services qui prennent en charge les points d'extrémité privés dans cette région
Utilitaire de catalogue ibmcloud create-product-from-workspace
Exécutez la commande suivante pour créer une vignette d'architecture déployable à partir d'un espace de travailSchematics créé directement à partir du référentiel Git. L'architecture déployable crée un projet afin que vous puissiez continuer à développer et à maintenir l'architecture déployable avec la future version.
La commande requiert une variable d'environnement GIT_TOKEN pour s'authentifier auprès de votre référentiel source afin qu'un manifeste de catalogue puisse être ajouté. La commande est envoyée à une nouvelle branche dans le référentiel
Git qui se trouve dans l'espace de travail Schematics et crée une édition utilisée pour l'intégration.
ibmcloud catalog utility create-product-from-workspace [--workspace-id ID] [--api-key KEY] [--trusted-profile-id ID] [--catalog-label LABEL] [--offering-label LABEL] [--project-name NAME] [--project-resource-group GROUP] [--target-version VERSION] [--variation-label LABEL]
Options de commande
- --api-key ou --ak API KEY
- Fournir une clé API utilisée pour lier le catalogue et le projet. Exclusif avec '--trusted-profile-id'.
- --catalog-label CATALOGUE LABEL (optionnel)
- Indiquez le libellé d'un catalogue existant dans lequel effectuer l'importation ou le nom d'un nouveau catalogue à créer. La valeur par défaut est "Migrated DAs".
- --offering-label ÉTIQUETTE DE L'OFFRE (facultatif)
- Indiquez le libellé d'une offre existante dans laquelle effectuer l'importation ou le nom d'une nouvelle offre à créer. La valeur par défaut est "Migrated <workspace_name>". L'étiquette remplace l'étiquette de l'offre existante si l'espace de travail est créé à partir d'une offre de catalogue.
- --project-name NOM (facultatif)
- Fournir un nom de projet lié au catalogue embarqué. Si le projet n'existe pas, il est créé. Le nom par défaut est "Dev Migration Project".
- --project-resource-group (facultatif)
- Fournir un groupe de ressources pour le projet créé. Le groupe de ressources par défaut est "Default".
- --target-version VERSION (optionnel)
- Indiquez la version cible de l'offre migrée. La valeur par défaut est '1.0.0'.
- --trusted-profile-id ou --tpi TRUSTED PROFILE ID
- Fournir un identifiant de profil de confiance utilisé pour lier le catalogue et le projet. Exclusivité mutuelle avec '--api-key'.
- --variation-label VARIATION LABEL (optionnel)
- Indiquez un libellé de variante pour la version à intégrer. La valeur par défaut est "Standard". Le libellé remplace le libellé de version existant si l'espace de travail est créé à partir d'une offre de catalogue.
- --workspace-id ID DE L'ESPACE DE TRAVAIL
- Indiquez un ID d'espace de travail Schematics. Pour obtenir l'ID de l'espace de travail, vous devez créer l'espace de travail Schematics. Pour plus d'informations, voir
ibmcloud schematics workspace new.
ibmcloud catalog utility netrc
Exécutez la commande suivante pour créer un fichier .netrc, générer le nom de machine dans votre fichier .netrc ou mettre à jour les données d'identification dans votre fichier .netrc. Un fichier .netrc stocke les informations de connexion requises pour utiliser des modules Terraform depuis le catalogue IBM Cloud.
En exécutant cette commande, vous configurez un fichier .netrc pour le nom de machine cm.globalcatalog.cloud.ibm.com avec iamtoken comme nom d'utilisateur et votre jeton IAM comme mot de passe.
Vous avez besoin de la version 1.2.7 ou supérieure du plug-in de l'interface CLI de gestion de catalogues pour exécuter la commande .netrc.
ibmcloud catalog utility netrc
ibmcloud catalog utility update-module-references
Exécutez la commande suivante pour rechercher dans le catalogue des mises à jour pour les modules Terraform de votre répertoire de travail et mettre à jour l'attribut source vers la version la plus récente. Le fichier README.md est également mis à jour.
ibmcloud catalog utility update-module-references
ibmcloud catalog offering unpublish account
Exécutez la commande suivante pour annuler la publication d'un produit dans votre compte. Une fois la publication du produit annulée, les utilisateurs de votre compte ne peuvent plus créer d'instance du produit.
ibmcloud catalog offering unpublish account [--catalog CATALOG][--offering OFFERING]
Options de commande
- --catalog CATALOG
- Nom ou ID du catalogue.
- --offering OFFERING
- Nom ou ID du produit.
ibmcloud catalog offering unpublish allowlist
Exécutez la commande suivante pour retirer des ID de compte de la liste autorisée du produit. Les comptes retirés de la liste autorisée ne peuvent pas créer d'instance du produit.
ibmcloud catalog offering unpublish allowlist [--catalog CATALOG][--offering OFFERING][--account-ids ACCOUNT-IDS]
Options de commande
- --catalog CATALOG
- Nom ou ID du catalogue.
- --offering OFFERING
- Nom ou ID du produit.
- --account-ids ACCOUNT-IDS
- Les ID de compte.
ibmcloud catalog offering unpublish enterprise
Exécutez la commande suivante pour annuler la publication d'un produit dans une entreprise. Une fois la publication du produit annulée, l'entreprise ne peut plus créer d'instance du produit.
ibmcloud catalog offering unpublish enterprise [--catalog CATALOG][--offering OFFERING]
Options de commande
- --catalog CATALOG
- Nom ou ID du catalogue.
- --offering OFFERING
- Nom ou ID du produit.
ibmcloud catalog offering unpublish ibm
Exécutez la commande suivante pour dépublier un produit à partir de IBM. Une fois le produit dépublié, les employés de IBM ne peuvent plus créer d'instance du produit.
ibmcloud catalog offering unpublish ibm [--catalog CATALOG][--offering OFFERING]
Options de commande
- --catalog CATALOG
- Nom ou ID du catalogue.
- --offering OFFERING
- Nom ou ID du produit.
ibmcloud catalogue offre publier ibm
Exécutez la commande suivante pour publier une offre qui est déjà disponible dans votre compte à tous les utilisateurs de IBM. Cette partie du processus de publication crée une tuile dans les catalogues de préparation et de production qui n'est visible que par les utilisateurs de IBM. En publiant une offre sur IBM ers, vous pouvez tester l'offre en production avant de la mettre à la disposition de tous les utilisateurs dans le catalogue IBM Cloud.
ibmcloud catalog offering publish ibm [--catalog CATALOG][--offering OFFERING]
Options de commande
- --catalog CATALOG
- Nom ou ID du catalogue.
- --offering OFFERING
- Nom ou ID du produit.
ibmcloud catalog offering publish public
Exécutez la commande suivante pour publier votre offre privée dans le catalogue IBM Cloud afin que tous les utilisateurs puissent la voir et l'utiliser. Pour accéder à cette étape dans le processus de publication, vous devez tout d'abord publier l'offre dans votre compte à destination de tous les collaborateurs IBM afin de terminer le processus de test. Une fois le test terminé, vous pouvez exécuter cette commande.
Cette option requiert une approbation. Une fois l'approbation obtenue, votre carreau est disponible pour tous les clients de IBM Cloud.
ibmcloud catalog offering publish public [--catalog CATALOG][--offering OFFERING]
Options de commande
- --catalog CATALOG
- Nom ou ID du catalogue.
- --offering OFFERING
- Nom ou ID du produit.
ibmcloud catalog offering deprecate-offering
Exécutez la commande suivante pour déprécier une version d'offre précédemment publiée dans le catalogue IBM Cloud.
ibmcloud catalog offering deprecate-offering [--catalog CATALOG][--offering OFFERING]
Options de commande
- --catalog CATALOG
- Nom ou ID du catalogue.
- --offering OFFERING
- Nom ou ID du produit.
ibmcloud catalog offering restore-offering
Exécutez la commande suivante pour restaurer un produit précédemment déprécié dans le catalogue IBM Cloud. Une fois que vous avez validé une version de votre produit, vous pouvez le restaurer à l'état publié dans lequel il était avant d'être déprécié.
ibmcloud catalog offering restore-offering [--catalog CATALOG][--offering OFFERING]
Options de commande
- --catalog CATALOG
- Nom ou ID du catalogue.
- --offering OFFERING
- Nom ou ID du produit.
ibmcloud catalog offering version restore-version
Exécutez la commande suivante pour restaurer dans le catalogue IBM Cloud une version obsolète d'un produit. Le fait de le restaurer place la version dans un état de brouillon. Après l'avoir validée, vous pouvez restaurer la version d'origine à son état publié avant sa dépréciation.
ibmcloud catalog offering version restore-version [--catalog CATALOG][--offering OFFERING] [--include-config]
Options de commande
- --catalog CATALOG
- Nom ou ID du catalogue.
- --offering OFFERING
- Nom ou ID du produit.
- --include-config (facultatif)
- Si cette option est spécifiée, toutes les valeurs de configuration sont incluses et disponibles lorsque vous ajoutez le produit.
ibmcloud catalog object create vpe
Exécutez la commande suivante pour ajouter un objet à un catalogue privé dans le compte.
ibmcloud catalog object create vpe [--catalog CATALOG] [--crn CRN] [endpoint-type TYPE] [--fqdn FQDN] [--name NAME] [--region REGION]
Options de commande
- --catalog CATALOG
- Spécifier le nom ou l'ID du catalogue.
- --crn CRN
- Indiquez le nom de la ressource cloud (CRN).
- --endpoint-type TYPE
- Indiquez le type de noeud final VPE.
- --fqdn FQDN
- Fournir une liste de noms de domaine entièrement qualifiés, séparés par des virgules.
- --name NAME
- Indiquez le nom de l'objet.
- --region REGION
- Indiquez la région pour le noeud final VPE.
Suppression de l'objet de catalogue ibmcloud
Exécutez la commande suivante pour supprimer l'objet.
ibmcloud catalog object delete [--catalog CATALOG] [--name NAME]
Options de commande
- --catalog CATALOG
- Spécifier le nom ou l'ID du catalogue.
- --name NAME
- Indiquer le nom de l'objet.
ibmcloud catalog object update vpe
Exécutez la commande suivante pour mettre à jour l'objet.
ibmcloud catalog object update vpe [--catalog CATALOG] [--name NAME] [--crn CRN] [--endpoint-type TYPE] [--fqdn FQDN] [--region REGION]
Options de commande
- --catalog CATALOG
- Spécifier le nom ou l'ID du catalogue.
- --name NAME
- Indiquez le nom de l'objet.
- --crn CRN (facultatif)
- Indiquez le nom de la ressource cloud (CRN).
- --endpoint-type TYPE (facultatif)
- Indiquez le type de noeud final VPE.
- --fqdn FQDN (optionnel)
- Fournir une liste de noms de domaine entièrement qualifiés, séparés par des virgules.
- --region REGION (facultatif)
- Indiquez la région pour le noeud final VPE.
Obtention de l'objet de catalogue ibmcloud
Exécutez la commande suivante pour extraire des informations pour un objet particulier.
ibmcloud catalog object get [--catalog CATALOG] [--name NAME] [--output OUTPUT]
Options de commande
- --catalog CATALOG
- Spécifier le nom ou l'ID du catalogue.
- --name NAME
- Indiquer le nom de l'objet.
- --output OUTPUT (optionnel)
- Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et la seule alternative supportée est JSON. Exemple:
--output json
Liste d'objets de catalogue ibmcloud
Exécutez la commande suivante pour extraire une liste d'objets d'un catalogue.
ibmcloud catalog object list [--catalog CATALOG] [--output OUTPUT]
Options de commande
- --catalog CATALOG
- Spécifier le nom ou l'ID du catalogue.
- --output OUTPUT (optionnel)
- Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et la seule alternative supportée est JSON. Exemple:
--output json
recherche d'objet de catalogue ibmcloud
Exécutez la commande suivante pour rechercher des objets à l'aide de la syntaxe de requête Lucene.
ibmcloud catalog object search [--query QUERY] [--output OUTPUT]
Options de commande
- --query REQUÊTE
- Indiquez la chaîne de requête Lucene.
- --output OUTPUT (optionnel)
- Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et la seule alternative supportée est JSON. Exemple:
--output json
Objet de catalogue ibmcloud prêt
Exécutez la commande suivante pour marquer votre objet comme étant prêt à être partagé ou publié.
ibmcloud catalog object ready [--catalog CATALOG] [--name NAME]
Options de commande
- --catalog CATALOG
- Spécifier le nom ou l'ID du catalogue.
- --name NAME
- Indiquez le nom de l'objet.
Publication de l'objet de catalogue ibmcloud
Exécutez la commande suivante pour publier l'objet dans une liste d'accès, dans votre compte IBM employés ou dans le catalogue IBM Cloud pour tous les utilisateurs.
ibmcloud catalog object publish COMMAND [--catalog CATALOG] [--name NAME]
Options de commande
- Commande
- Indiquez où vous souhaitez publier l'objet. Les valeurs valides sont
accesslist,account,ibmoupublic. - --catalog CATALOG
- Spécifier le nom ou l'ID du catalogue.
- --name NAME
- Indiquer le nom de l'objet.
Exemple
Publiez un objet appelé dev-object qui se trouve dans le catalogue dev-catalog pour les employés de IBM.
ibmcloud catalog object publish ibm --catalog dev-catalog --name dev-object
ibmcloud catalog object access-list add
Exécutez la commande suivante pour ajouter des ID de compte à la liste d'accès d'un objet.
ibmcloud catalog object access-list add [--account-id ID] [--catalog CATALOG] [--name NAME]
Options de commande
- --account-id ID
- Fournir une liste d'identifiants de comptes séparés par des virgules.
- --catalog CATALOG
- Spécifier le nom ou l'ID du catalogue.
- --name NAME
- Indiquez le nom de l'objet.
ibmcloud catalog object access-list get
Exécutez la commande suivante pour extraire des informations relatives à une liste d'accès particulière pour un objet.
ibmcloud catalog object access-list get [--catalog CATALOG] [--name NAME] [--output OUTPUT]
Options de commande
- --catalog CATALOG
- Spécifier le nom ou l'ID du catalogue.
- --name NAME
- Indiquez le nom de l'objet.
- --output OUTPUT (optionnel)
- Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et la seule alternative supportée est JSON. Exemple:
--output json
ibmcloud catalog object access-list rm
Exécutez la commande suivante pour supprimer les identifiants de compte de la liste d'accès de l'objet.
ibmcloud catalog object access-list rm [--account-id ID] [--catalog CATALOG] [--name NAME]
Options de commande
- --account-id ID
- Fournir une liste d'identifiants de comptes séparés par des virgules.
- --catalog CATALOG
- Spécifier le nom ou l'ID du catalogue.
- --name NAME
- Indiquez le nom de l'objet.