Commande bluemixUtility

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

Sources

Découvrez les services Bluemix, 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 à Bluemix. 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 Bluemix 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 à Bluemix à 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 Bluemix qui peuvent être configurés à l'aide de l'utilitaire de ligne de commande.
createService
Créer une instance de service à partir du catalogue Bluemix.
listServices
Répertorier toutes les instances de service Bluemix 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 Bluemix à 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 Bluemix.
info
Afficher les informations de connexion Bluemix.
help
Utiliser l'action d'aide sur chaque commande pour afficher les descriptions, l'utilisation et les options.
logout
Se déconnecter de Bluemix. La commande logout supprime le fichier qui a été créé lors de votre connexion à l'aide des données d'identification Bluemix.

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 Bluemix.
--password=password
Mot de passe du compte Bluemix.
--org=organizationName
Nom d'organisation.
--space=spaceName
Nom d'espace.
[16.0.0.3 et ultérieur]--sso
Code d'accès à usage unique requis pour se connecter à l'aide d'un ID fédéré Bluemix. Pour générer le code d'accès, accédez au site Web du code d'accès Bluemix 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 Bluemix 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 Bluemix.

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 Bluemix.

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 Bluemix 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 Bluemix.
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