bluemixUtility 命令
使用 IBM® Bluemix® 命令行实用程序,将您的本地 Liberty 服务器配置为使用特定 Bluemix 云服务。
源
了解有关可以与命令行实用程序配合使用的 Bluemix 服务(例如 Watson™ 和 Cloudant® 服务)的信息。
- 要注册或登录到 Bluemix 帐户,请参阅注册 IBM Bluemix。
- 要了解有关 Watson 的更多信息,请参阅 Watson 服务。
- 要了解有关 Cloudant 服务的更多信息,请参阅 Cloudant NoSQL DB 入门。
语法
命令语法如下所示:
bluemixUtility action [options]
使用以下 action 命令:
- login
- 登录到 Bluemix。如果您在不带任何选项的情况下运行 login 命令,那么该工具将提示您输入更多信息,例如用户名和密码。成功登录后,Bluemix 凭证将保存到文件中,这样您无需再次指定用户名和密码就可以运行其他命令。
- 如果使用 Cloud Foundry (cf) 客户机登录到 Bluemix,那么 bluemixUtility 将使用 cf 客户机保存的凭证。有关更多信息,请参阅 Cloud Foundry (cf) 命令。
- marketplace
- 列出可以使用命令行实用程序配置的所有 Bluemix 服务。
- createService
- 从 Bluemix 目录创建服务实例。
- listServices
- 列出所有可用的 Bluemix 服务实例。
- showService
- 显示有关服务实例的信息。
- import
- 为服务导入配置。导入的服务配置及其依赖性将放入以下目录中:
${wlp.user.dir}/shared/config/services/serviceName
- listImports
- 列出可以绑定到 Liberty 服务器的所有已导入服务配置。
- bind
- 将 Bluemix 服务配置绑定到 Liberty 服务器。服务的配置可以为特定选项(例如 dataSource 元素的 jndiName)提供缺省值。在某些情况下,缺省值与应用程序所期望的值不匹配。借助 --v 选项,可使用应用程序期望的值覆盖缺省值。
- unbind
- 从 Liberty 服务器取消服务配置的绑定。
- deleteService
- 删除服务实例。
- switch
- 切换到不同的 Bluemix 组织或空间。
- info
- 查看 Bluemix 连接信息。
- help
- 使用每个命令上的 help 操作来查看描述、用法和选项。
- logout
- 从 Bluemix 注销。logout 命令将删除当您使用 Bluemix 凭证登录时创建的文件。
用法
查看可以为每个操作运行的用法示例。
使用以下命令来运行 login 操作:
bluemixUtility login [options]
使用以下命令来运行 marketplace 操作:
bluemixUtility marketplace [serviceType...]
使用以下命令来运行 createService 操作:
bluemixUtility createService [options] serviceType servicePlan serviceName
使用以下命令来运行 listServices 操作:
bluemixUtility listServices
使用以下命令来运行 showService 操作:
bluemixUtility showService [options] serviceName
使用以下命令来运行 import 操作:
bluemixUtility import [options] serviceName
使用以下命令来运行 listImports 操作:
bluemixUtility listImports [serverName]
使用以下命令来运行 bind 操作:
bluemixUtility bind [options] serverName serviceName
使用以下命令来运行 unbind 操作:
bluemixUtility unbind serverName serviceName
使用以下命令来运行 deleteService 操作:
bluemixUtility deleteService [options] serviceName
使用以下命令来运行 switch 操作:
bluemixUtility switch [options]
使用以下命令来运行 logout 操作:
bluemixUtility logout
选项
查看每个操作的可用选项。
以下选项可用于 bluemixUtility login 命令:
- --api=url
- Bluemix API 端点,例如,https://api.ng.bluemix.net。还可以将 API 端点设置为 Bluemix 区域名称。例如,可以将其对美国南部地区设置为 us-south,对英国伦敦地区设置为 eu-gb,而对澳大利亚悉尼地区设置为 au-syd。
- --user=username
- Bluemix 帐户的用户名。
- --password=password
- Bluemix 帐户的密码。
- --org=organizationName
- 组织名称。
- --space=spaceName
- 空间名称。
--sso
- 使用 Bluemix 联合标识登录所需的一次性口令。要生成口令,请转至此命令指定的 Bluemix 口令 Web 站点,然后在命令行上输入生成的口令。使用 IBM 标识登录时,不需要此选项。
以下选项可用于 bluemixUtility marketplace 命令:
- [serviceType...]
- 显示有关特定 Bluemix 服务的详细信息。通过以空格分隔服务名称来指定多个服务名称。
以下选项可用于 bluemixUtility createService 命令:
- --credentialName=name
- 服务凭证的名称。缺省情况下,将使用 credential-1。
- serviceType
- 要创建的服务的类型。
- servicePlan
- 服务计划的名称。
- serviceName
- 要创建的服务的名称。
bluemixUtility listServices 命令没有可用选项。
以下选项可用于 bluemixUtility showService 命令:
- --showCredentials
- 显示服务凭证。
- serviceName
- Bluemix 服务的名称。
以下选项可用于 bluemixUtility import 命令:
- --acceptLicense
- 自动地指示接受许可条款和条件。
- --credentialName=name
- 服务凭证的名称。缺省情况下,将使用找到的第一个凭证。
- --encodeAlgorithm=[xor|aes]
- 指定如何在已导入服务配置中对敏感信息进行编码。受支持的编码值为 xor 和 aes。缺省编码算法为 xor。
- --encodeKey=key
- 指定在使用 AES 加密进行编码时要使用的密钥。如果未提供此选项,那么将使用缺省密钥。
- --p[parameter]=value
- 指定帮助为服务生成和导入配置的参数。
- serviceName
- Bluemix 服务的名称。
以下选项可用于 bluemixUtility listImports 命令:
- [serverName]
- 列出已绑定到此特定服务器的服务。
以下选项可用于 bluemixUtility bind 命令:
- --v[variable]=value
- 覆盖已导入服务配置中的变量。
- --acceptLicense
- 自动地指示接受许可条款和条件。
- serverName
- 要绑定到服务配置的服务器的名称。
- serviceName
- 已导入服务配置的名称。
以下选项可用于 bluemixUtility unbind 命令:
- serverName
- 要从其取消服务配置绑定的服务器的名称。
- serviceName
- 要取消绑定的服务配置的名称。
以下选项可用于 bluemixUtility deleteService 命令:
- --force
- 强制删除而不确认。
- serviceName
- 要删除的服务的名称。
以下选项可用于 bluemixUtility switch 命令:
- --org=organizationName
- 组织名称。
- --space=spaceName
- 空间名称。
bluemixUtility info 命令没有可用选项。
bluemixUtility logout 命令没有可用选项。
返回码
返回码 | 说明 |
---|---|
0 | 此命令成功完成请求的操作。 |
20 | 一个或多个命令行自变量无效。 |
21 | 发生了未知运行时异常。 |
22 | 尝试从文件系统删除文件时,发生了 IO 错误。 |
24 | 用户异常中止。用户未能响应提示或取消操作时发生此错误。 |
26 | 发生未知的异常。 |
27 | 尝试登录或尝试在未登录的情况下执行任务时,发生 Bluemix 认证错误。 |
28 | 与 Bluemix 通信时发生通用错误。 |
29 | 与配置服务通信时发生通用错误。 |
30 | 发生了通用服务配置错误。 |
31 | 发生了通用功能部件安装错误。 |
255 | 发生了未知错误。 |