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 動作來檢視說明、用法和選項。
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
空間名稱。
以下是 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 指令沒有可用的選項。

回覆碼

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

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



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