Mandato bluemixUtility
Utilice el programa de utilidad de línea de mandatos de IBM® Bluemix para configurar el servidor de Liberty local a fin de utilizar determinados servicios en la nube de Bluemix.
Orígenes
- Para registrar o iniciar la sesión en una cuenta de Bluemix, consulte Registrarse en IBM Bluemix.
- Para obtener más información sobre Watson, consulte Servicios Watson.
- Para obtener más información sobre los servicios de Cloudant, consulte Iniciación a Cloudant NoSQL DB.
Sintaxis
bluemixUtility acción [opciones]
- login
- Iniciar la sesión en Bluemix. Si ejecuta el mandato login sin ninguna opción, la herramienta le solicita más información, como, por ejemplo, nombre de usuario y contraseña. Después de un inicio de sesión satisfactorio, las credenciales de Bluemix se guardan en un archivo para que pueda ejecutar otros mandatos sin especificar de nuevo el nombre de usuario y la contraseña.
- Si inicia la sesión en Bluemix con el cliente de Cloud Foundry (cf), bluemixUtility utiliza las credenciales guardadas por el cliente cf. Para obtener más información, consulte Mandatos de Cloud Foundry (cf).
- marketplace
- Listar todos los servicios de Bluemix que se pueden configurar utilizando el programa de utilidad de línea de mandatos.
- createService
- Crear una instancia de servicio a partir del catálogo de Bluemix.
- listServices
- Listar todas las instancias de servicio de Bluemix disponibles.
- showService
- Mostrar información sobre una instancia de servicio.
- import
- Importar una configuración para un servicio. La configuración de servicio importada y sus dependencias
se colocan en el directorio siguiente:
${wlp.user.dir}/shared/config/services/nombreServicio
- listImports
- Listar todas las configuraciones de servicio importadas que se pueden enlazar a un servidor de Liberty.
- bind
- Enlazar una configuración de servicio de Bluemix con un servidor de Liberty. La configuración de un servicio puede proporcionar valores predeterminados para determinadas opciones, como por ejemplo el jndiName de un elemento dataSource. En algunos casos, los valores predeterminados no coinciden con lo que la aplicación espera. Utilice la opción --v para alterar temporalmente un valor predeterminado con el valor que la aplicación espera.
- unbind
- Desenlazar una configuración de servicio de un servidor de Liberty.
- deleteService
- Suprimir una instancia de servicio.
- switch
- Conmutar a otro espacio u organización de Bluemix.
- info
- Ver información de conexión de Bluemix.
- help
- Utilizar la acción de ayuda en cada mandato para ver descripciones, el uso y opciones.
- logout
- Cerrar la sesión de Bluemix. El mandato logout suprime el archivo que se ha creado al iniciar la sesión con las credenciales de Bluemix.
Uso
Vea los ejemplos de uso que puede ejecutar para cada acción.
bluemixUtility login [opciones]
bluemixUtility marketplace [tipoServicio...]
bluemixUtility createService [opciones] tipoServicio planServicio nombreServicio
bluemixUtility listServices
bluemixUtility showService [opciones] nombreServicio
bluemixUtility import [opciones] nombreServicio
bluemixUtility listImports [nombreServidor]
bluemixUtility bind [opciones] nombreServidor
nombreServicio
bluemixUtility unbind nombreServidor nombreServicio
bluemixUtility deleteService [opciones] nombreServicio
bluemixUtility switch [opciones]
bluemixUtility logout
Opciones
Vea las opciones disponibles para cada acción.
- --api=url
- Punto final de API Bluemix, por ejemplo https://api.ng.bluemix.net. El punto final de API también puede establecerse como nombre de región de Bluemix. Por ejemplo, puede establecerse en us-south para la región sur de EE.UU., eu-gb para la región de Londres en el Reino Unido y au-syd para la región de Sidney en Australia.
- --user=nombre_usuario
- Nombre de usuario de la cuenta de Bluemix.
- --password=contraseña
- Contraseña de la cuenta de Bluemix.
- --org=nombre_organización
- Nombre de organización.
- --space=nombre_espacio
- Nombre de espacio.
--sso
- Un código de acceso de un solo uso necesario para iniciar la sesión utilizando un ID federado de Bluemix. Para generar el código de acceso, vaya al sitio web de código de acceso de Bluemix especificado por el mandato y, a continuación, escriba el código generado en la línea de mandatos. Esta opción no es necesaria para firmar utilizando un ID de IBM.
- [serviceType...]
- Mostrar información detallada sobre un determinado servicio de Bluemix. Especifique varios nombres de servicio separándolos con un espacio.
- --credentialName=name
- Nombre de la credencial de servicio. De forma predeterminada, se utiliza credential-1.
- serviceType
- Tipo de servicio a crear.
- servicePlan
- Nombre del plan de servicio.
- serviceName
- Nombre del servicio que se debe crear.
No hay opciones disponibles para el mandato bluemixUtility listServices.
Están disponibles las siguientes opciones para el mandato bluemixUtility showService:
- --showCredentials
- Visualiza credenciales de servicio.
- serviceName
- Nombre de un servicio de Bluemix.
Están disponibles las siguientes opciones para el mandato bluemixUtility import:
- --acceptLicense
- Indica automáticamente la aceptación de los términos y condiciones de licencia.
- --credentialName=name
- Nombre de la credencial de servicio. De forma predeterminada, se utiliza la primera credencial que se encuentra.
- --encodeAlgorithm=[xor|aes]
- Especifica cómo codificar información confidencial en la configuración de servicio importada. Los valores de codificaciones soportados son xor y aes. El algoritmo de codificación predeterminado es xor.
- --encodeKey=key
- Especifica la clave que se debe utilizar cuando se codifica con el cifrado AES. Si no se proporciona esta opción, se utiliza una clave predeterminada.
- --p[parameter]=value
- Especifica los parámetros que ayudan a generar e importar una configuración para un servicio.
- serviceName
- Nombre de un servicio de Bluemix.
Están disponibles las siguientes opciones para el mandato bluemixUtility listImports:
- [serverName]
- Lista los servicios que ya están enlazados a este servidor en particular.
Están disponibles las siguientes opciones para el mandato bluemixUtility bind:
- --v[variable]=value
- Altera temporalmente las variables en la configuración de servicio importada.
- --acceptLicense
- Indica automáticamente la aceptación de los términos y condiciones de licencia.
- serverName
- Nombre del servidor a enlazar a la configuración de servicio.
- serviceName
- Nombre de la configuración del servicio importada.
Están disponibles las siguientes opciones para el mandato bluemixUtility unbind:
- serverName
- Nombre del servidor del que se debe desenlazar la configuración.
- serviceName
- Nombre de la configuración de servicio que se debe desenlazar.
Están disponibles las siguientes opciones para el mandato bluemixUtility deleteService:
- --force
- Fuerza la supresión sin confirmación.
- serviceName
- Nombre del servicio a suprimir.
Están disponibles las siguientes opciones para el mandato bluemixUtility switch:
- --org=organizationName
- Nombre de organización.
- --space=spaceName
- Nombre de espacio.
No hay opciones disponibles para el mandato bluemixUtility info.
No hay opciones disponibles para el mandato bluemixUtility logout.
Códigos de retorno
Código de retorno | Descripción |
---|---|
0 | El mandato ha completado correctamente la operación solicitada. |
20 | No son válidos uno o más argumentos u opciones de línea de mandatos. |
21 | Se ha producido una excepción de tiempo de ejecución desconocida. |
22 | Se ha producido un error de E/S, normalmente al intentar suprimir un archivo del sistema de archivos. |
24 | El usuario ha terminado anormalmente. Se produce cuando el usuario no puede responder a una solicitud o cancela la operación. |
26 | Se ha producido una excepción desconocida. |
27 | Error de autenticación de Bluemix al intentar iniciar sesión, o al intentar realizar una tarea sin haber iniciado sesión. |
28 | Un error genérico al comunicarse con Bluemix. |
29 | Un error genérico al comunicarse con el servicio de configuración. |
30 | Se ha producido un error de configuración del servicio genérico. |
31 | Se ha producido un error de instalación de característica genérico. |
255 | Se ha producido un error desconocido. |