Commande bluemixUtility

Utilisez l'utilitaire de ligne de commande IBM® Cloud pour configurer votre serveur Liberty sur site afin qu'il utilise certains services cloud IBM Cloud.

IBM Bluemix s'appelle désormais IBM Cloud, et toute référence à ces deux noms désigne la plateforme cloud sur le site https://console.bluemix.net.

Sources

Découvrez les services IBM Cloud, tels que Watson et Cloudant, que vous pouvez utiliser avec l'utilitaire de ligne de commande.

Syntaxe

La syntaxe de la commande est la suivante :
bluemixUtility action [options]
Utilisez les commandes action suivantes :
login
Connexion à IBM Cloud. Si vous exécutez la commande login sans spécifier d'option, l'outil vous invite à spécifier des informations supplémentaires, telles qu'un nom d'utilisateur et un mot de passe. Une fois que votre connexion a abouti, les données d'identification IBM Cloud sont enregistrées dans un fichier afin de vous permettre d'exécuter d'autres commandes sans avoir à spécifier de nouveau un nom d'utilisateur et un mot de passe.
Si vous vous connectez à IBM Cloud à l'aide du client Cloud Foundry (cf), bluemixUtility utilise les données d'identification enregistrées par ce client. Pour plus d'informations, voir Commandes Cloud Foundry (cf).
marketplace
Répertorier tous les services IBM Cloud qui peuvent être configurés à l'aide de l'utilitaire de ligne de commande.
createService
Créer une instance de service à partir du catalogue IBM Cloud.
listServices
Répertorier toutes les instances de service IBM Cloud disponibles.
showService
Afficher les informations relatives à une instance de service.
import
Importer une configuration pour un service. La configuration de service importée et ses dépendances sont placées dans le répertoire suivant :
${wlp.user.dir}/shared/config/services/serviceName
listImports
Répertorier toutes les configurations de service importées qui peuvent être liées à un serveur Liberty.
bind
Connecter une configuration de service IBM Cloud à un serveur Liberty. La configuration d'un service peut fournir les valeurs par défaut de certaines options, telles que l'option jndiName d'un élément dataSource. Dans certains cas, les valeurs par défaut ne correspondent pas aux valeurs attendues par l'application. Utilisez l'option --v dans le but de substituer une valeur par défaut par la valeur attendue par votre application.
unbind
Déconnecter une configuration de service d'un serveur Liberty.
deleteService
Supprimer une instance de service.
switch
Basculer vers une autre organisation ou un autre espace IBM Cloud.
info
Afficher les informations de connexion IBM Cloud.
help
Utiliser l'action d'aide sur chaque commande pour afficher les descriptions, l'utilisation et les options.
logout
Se déconnecter de IBM Cloud. La commande logout supprime le fichier qui a été créé lors de votre connexion à l'aide des données d'identification IBM Cloud.

Syntaxe

Affichez les exemples de syntaxe de commande que vous pouvez exécuter pour chaque action.

Utilisez la commande suivante pour exécuter l'action login :
bluemixUtility login [options]
Utilisez la commande suivante pour exécuter l'action marketplace :
bluemixUtility marketplace [serviceType...]
Utilisez la commande suivante pour exécuter l'action createService :
bluemixUtility createService [options] serviceType servicePlan serviceName
Utilisez la commande suivante pour exécuter l'action listServices :
bluemixUtility listServices
Utilisez la commande suivante pour exécuter l'action showService :
bluemixUtility showService [options] serviceName
Utilisez la commande suivante pour exécuter l'action import :
bluemixUtility import [options] serviceName
Utilisez la commande suivante pour exécuter l'action listImports :
bluemixUtility listImports [serverName]
Utilisez la commande suivante pour exécuter l'action bind :
bluemixUtility bind [options] serverName serviceName
Utilisez la commande suivante pour exécuter l'action unbind :
bluemixUtility unbind serverName serviceName
Utilisez la commande suivante pour exécuter l'action deleteService :
bluemixUtility deleteService [options] serviceName
Utilisez la commande suivante pour exécuter l'action switch :
bluemixUtility switch [options]
Utilisez la commande suivante pour exécuter l'action logout :
bluemixUtility logout

Options

Affichez les options disponibles pour chaque action.

Les options suivantes sont disponibles pour la commande bluemixUtility login :
--api=url
Noeud final d'API Bluemix, par exemple, https://api.ng.bluemix.net. Le noeud final d'API peut également être défini comme nom de région Bluemix. Par exemple, il peut prendre la valeur us-south pour la région du Sud des Etats-Unis, eu-gb pour la région de Londres au Royaume-Uni, et au-syd pour la région de Sydney en Australie.
--user=username
Nom d'utilisateur du compte IBM Cloud.
--password=password
Mot de passe du compte IBM Cloud.
--org=organizationName
Nom d'organisation.
--space=spaceName
Nom d'espace.
[16.0.0.3 and later]--sso
Code d'accès à usage unique requis pour se connecter à l'aide d'un ID fédéré IBM Cloud. Pour générer le code d'accès, accédez au site Web du code d'accès IBM Cloud spécifié par la commande, puis entrez le code d'accès généré sur la ligne de commande. Cette option n'est pas requise pour signer à l'aide d'un ID IBM.
Les options suivantes sont disponibles pour la commande bluemixUtility marketplace :
[serviceType...]
Affichage d'informations détaillées sur un service IBM Cloud spécifique. Spécifiez plusieurs noms de service en les séparant par un espace.
Les options suivantes sont disponibles pour la commande bluemixUtility createService :
--credentialName=name
Nom des données d'identification de service. Par défaut, credential-1 est utilisé.
serviceType
Type de service à créer.
servicePlan
Nom de plan de service.
serviceName
Nom de service à créer.

Aucune option n'est disponible pour la commande bluemixUtility listServices.

Les options suivantes sont disponibles pour la commande bluemixUtility showService :

--showCredentials
Afficher les données d'identification de service.
serviceName
Nom d'un service IBM Cloud.

Les options suivantes sont disponibles pour la commande bluemixUtility import :

--acceptLicense
Accepter automatiquement les dispositions du contrat de licence.
--credentialName=name
Nom des données d'identification de service. Par défaut, les premières données d'identification détectées sont utilisées.
--encodeAlgorithm=[xor|aes]
Indique comment coder des informations sensibles relatives à la configuration de service importée. Les valeurs de codage prises en charge sont xor et aes. L'algorithme de codage par défaut est xor.
--encodeKey=key
Spécifie la clé à utiliser lors du codage avec le chiffrement AES. Si elle n'est pas fournie, une clé par défaut est utilisée.
--p[parameter]=value
Définit les paramètres qui permettent de faciliter la génération et l'importation de la configuration d'un service.
serviceName
Nom d'un service IBM Cloud.

Les options suivantes sont disponibles pour la commande bluemixUtility listImports :

[serverName]
Répertorier les services qui sont déjà connectés à ce serveur spécifique.

Les options suivantes sont disponibles pour la commande bluemixUtility bind :

--v[variable]=value
Substituer des variables dans la configuration de service importée.
--acceptLicense
Accepter automatiquement les dispositions du contrat de licence.
serverName
Nom du serveur à connecter à la configuration de service.
serviceName
Nom de la configuration de service importée.

Les options suivantes sont disponibles pour la commande bluemixUtility unbind :

serverName
Nom du serveur à partir duquel la configuration de service doit être déconnectée.
serviceName
Nom de la configuration de service à déconnecter.

Les options suivantes sont disponibles pour la commande bluemixUtility deleteService :

--force
Forcer la suppression sans afficher de confirmation.
serviceName
Nom du service à supprimer.

Les options suivantes sont disponibles pour la commande bluemixUtility switch :

--org=organizationName
Nom d'organisation.
--space=spaceName
Nom d'espace.

Aucune option n'est disponible pour la commande bluemixUtility info.

Aucune option n'est disponible pour la commande bluemixUtility logout.

Codes retour

Tableau 1. Codes retour et explications
Code retour Explication
0 La commande a exécuté l'opération demandée.
20 Un ou plusieurs arguments de ligne de commande, ou options, ne sont pas valides.
21 Une exception d'exécution inconnue s'est produite.
22 Une erreur d'entrée-sortie est survenue, généralement lors de la tentative de suppression d'un fichier du système de fichiers.
24 Abandon utilisateur. Se produit lorsque l'utilisateur ne répond pas à une invite ou annule l'opération.
26 Une exception inconnue s'est produite.
27 Erreur d'authentification IBM Cloud lors de la tentative de connexion ou tentative d'exécution d'une tâche sans être connecté.
28 Erreur générique lors de la communication avec IBM Cloud.
29 Erreur générique lors de la communication avec le service de configuration.
30 Une erreur générique de configuration de service s'est produite.
31 Une erreur générique d'installation de fonction s'est produite.
255 Une erreur inconnue s'est produite.

Icône indiquant le type de rubrique Rubrique de référence

Nom du fichier : rwlp_blmx_utility.html