bluemixUtility 指令

請利用 IBM® Bluemix® 指令行公用程式,配置內部部署的 Liberty 伺服器來使用特定的 Bluemix 雲端服務。

來源

請瞭解可以搭配指令行公用程式來使用的 Bluemix 服務,例如 Watson™Cloudant® 服務。

語法

指令語法如下:
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
登出 Bluemixlogout 指令會刪除利用 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
空間名稱。
[16.0.0.3 以及更新版本]--sso
使用 Bluemix 聯合 ID 登入時,所需的一次性通行碼。如果要產生通行碼,請前往指令所指定的 Bluemix 通行碼網站,然後在指令行上輸入產生的通行碼。如果使用 IBM ID 來登入,就不需要指定這個選項。
以下是 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]
指定如何對所匯入服務配置中的機密性資訊進行編碼。 支援的編碼值有 xoraes。預設編碼演算法為 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 指令沒有可用的選項。

回覆碼

表 1. 回覆碼與說明
回覆碼 說明
0 指令已順利完成所要求的作業。
20 有一或多個指令行引數或選項無效。
21 發生不明的執行時期異常狀況。
22 發生 IO 錯誤,通常是在嘗試刪除檔案系統中的檔案時發生。
24 使用者中斷。在使用者無法回應提示或取消作業時發生。
26 發生不明異常狀況。
27 在嘗試登入,或在未登入的情況下嘗試執行作業時,發生 Bluemix 鑑別錯誤。
28 與 Bluemix 通訊時,發生一般錯誤。
29 與配置服務通訊時,發生一般錯誤。
30 發生一般服務配置錯誤。
31 發生一般特性安裝錯誤。
255 發生不明錯誤。

指示主題類型的圖示 參照主題



「時間戳記」圖示 前次更新: 2016 年 11 月 30 日
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rwlp_blmx_utility
檔名:rwlp_blmx_utility.html