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
- Pour vous inscrire ou vous connecter à un compte Bluemix, accédez au site Inscrivez-vous à IBM Bluemix.
- Pour en savoir plus sur Watson, voir Services Watson.
- Pour en savoir plus sur les services Cloudant, voir Initiation à Cloudant NoSQL DB.
Syntaxe
bluemixUtility action [options]
- 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.
bluemixUtility login [options]
bluemixUtility marketplace [serviceType...]
bluemixUtility createService [options] serviceType servicePlan serviceName
bluemixUtility listServices
bluemixUtility showService [options] serviceName
bluemixUtility import [options] serviceName
bluemixUtility listImports [serverName]
bluemixUtility bind [options] serverName serviceName
bluemixUtility unbind serverName serviceName
bluemixUtility deleteService [options] serviceName
bluemixUtility switch [options]
bluemixUtility logout
Options
Affichez les options disponibles pour chaque action.
- --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.
--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.
- [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.
- --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
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. |