Mandato bluemixUtility
Utilice el programa de utilidad de línea de mandatos de IBM® Cloud para configurar el servidor de Liberty local a fin de utilizar determinados servicios en la nube de IBM Cloud.
IBM Bluemix es ahora IBM Cloud y estos nombres hacen referencia a la misma plataforma en la nube en https://console.bluemix.net.
Orígenes
- Para registrar o iniciar la sesión en una cuenta de IBM Cloud, consulte Registrarse en IBM Cloud.
- Para obtener más información sobre Watson, consulte Servicios Watson.
- Para obtener más información sobre los servicios de Cloudant, consulte Getting started with Cloudant NoSQL DB.
Sintaxis
bluemixUtility acción [opciones]
- login
- Iniciar la sesión en IBM Cloud. 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 IBM Cloud 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 IBM Cloud 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 IBM Cloud 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 IBM Cloud.
- listServices
- Listar todas las instancias de servicio de IBM Cloud 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 IBM Cloud 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 IBM Cloud.
- info
- Ver información de conexión de IBM Cloud.
- help
- Utilizar la acción de ayuda en cada mandato para ver descripciones, el uso y opciones.
- logout
- Cerrar la sesión de IBM Cloud. El mandato logout suprime el archivo que se ha creado al iniciar la sesión con las credenciales de IBM Cloud.
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 se puede establecer como el 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 IBM Cloud.
- --password=contraseña
- Contraseña de la cuenta de IBM Cloud.
- --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 IBM Cloud. Para generar el código de acceso, vaya al sitio web de código de acceso de IBM Cloud 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 iniciar la sesión utilizando un ID de IBM.
- [serviceType...]
- Mostrar información detallada sobre un determinado servicio de IBM Cloud. 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
- El nombre de un servicio de IBM Cloud.
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
- El nombre de un servicio de IBM Cloud.
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 IBM Cloud al intentar iniciar la sesión o al intentar realizar una tarea sin haber iniciado la sesión. |
28 | Un error genérico al comunicarse con IBM Cloud. |
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. |