bluemixUtility 指令
請利用 IBM® Bluemix® 指令行公用程式,配置內部部署的 Liberty 伺服器來使用特定的 IBM Cloud 雲端服務。
IBM Bluemix 現在是 IBM Cloud,當提及這些名稱時,都是指 https://console.bluemix.net 的同一雲端平台。
來源
請瞭解可以搭配指令行公用程式來使用的 IBM Cloud 服務,例如 Watson™ 和 Cloudant® 服務。
- 如果要登錄或登入 IBM Cloud 帳戶,請參閱註冊取得 IBM Cloud。
- 如果要進一步瞭解 Watson,請參閱 Watson 服務。
- 如果要進一步瞭解 Cloudant 服務,請參閱 Cloudant NoSQL DB 入門。
語法
指令語法如下:
bluemixUtility action [options]
請使用下列 action 指令:
- login
- 登入「IBM Cloud」。如果您執行 login 指令,且未設定任何選項,工具會發出相關資訊的提示,例如,使用者名稱和密碼。 登入成功之後,會將 IBM Cloud 認證儲存在檔案中,以便執行其他指令時,無需再次指定使用者名稱和密碼。
- 如果您利用 Cloud Foundry (cf) 用戶端來登入 IBM Cloud,bluemixUtility 會使用 cf 用戶端所儲存的認證。 如需相關資訊,請參閱 Cloud Foundry (cf) 指令。
- marketplace
- 列出可以利用指令行公用程式來配置的所有 IBM Cloud 服務。
- createService
- 從 IBM Cloud 型錄建立服務實例。
- listServices
- 列出所有可用的 IBM Cloud 服務實例。
- showService
- 顯示服務實例的相關資訊。
- import
- 匯入服務的配置。匯入的服務配置及其相依關係放在下列目錄中:
${wlp.user.dir}/shared/config/services/serviceName
- listImports
- 列出所有可連結至 Liberty 伺服器的已匯入的服務配置。
- bind
- 將 IBM Cloud 服務配置連結至 Liberty 伺服器。 服務的配置可能會提供特定選項的預設值,例如 dataSource 元素的 jndiName。 在某些情況下,預設值並不符合應用程式的期望值。 請利用 --v 選項,以應用程式的期望值來置換預設值。
- unbind
- 取消服務配置與 Liberty 伺服器的連結。
- deleteService
- 刪除服務實例。
- switch
- 切換至不同的 IBM Cloud 組織或空間。
- info
- 檢視 IBM Cloud 連線資訊。
- help
- 請在各個指令上,利用 help 動作來檢視說明、用法和選項。
- logout
- 登出 IBM Cloud。logout 指令會刪除利用 IBM Cloud 認證登入時所建立的檔案。
用法
檢視每個動作所能執行的用法範例。
請利用下列指令來執行 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
- IBM Cloud 帳戶的使用者名稱。
- --password=password
- IBM Cloud 帳戶的使用者名稱。
- --org=organizationName
- 組織名稱。
- --space=spaceName
- 空間名稱。
--sso
- 使用 IBM Cloud 聯合 ID 登入時,所需的一次性通行碼。如果要產生通行碼,請前往指令所指定的 IBM Cloud 通行碼網站,然後在指令行上輸入產生的通行碼。如果使用 IBM ID 來登入,就不需要指定這個選項。
以下是 bluemixUtility marketplace 指令的可用選項:
- [serviceType...]
- 顯示關於特定 IBM Cloud 服務的詳細資訊。 請用空格來區隔,以指定多個服務名稱。
以下是 bluemixUtility createService 指令的可用選項:
- --credentialName=name
- 服務認證的名稱。依預設,會使用 credential-1。
- serviceType
- 要建立的服務類型。
- servicePlan
- 服務計劃的名稱。
- serviceName
- 要建立的服務名稱。
bluemixUtility listServices 指令沒有可用的選項。
以下是 bluemixUtility showService 指令的可用選項:
- --showCredentials
- 顯示服務認證。
- serviceName
- IBM Cloud 服務的名稱。
以下是 bluemixUtility import 指令的可用選項:
- --acceptLicense
- 自動指示接受授權條款。
- --credentialName=name
- 服務認證的名稱。依預設,會使用所找到的第一個認證。
- --encodeAlgorithm=[xor|aes]
- 指定如何對所匯入服務配置中的機密性資訊進行編碼。 支援的編碼值有 xor 和 aes。預設編碼演算法為 xor。
- --encodeKey=key
- 指定利用 AES 加密來編碼時所要使用的金鑰。 如果沒有提供這個選項,會使用預設金鑰。
- --p[parameter]=value
- 指定有助於產生及匯入服務配置的參數。
- serviceName
- IBM Cloud 服務的名稱。
以下是 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 | 在嘗試登入,或在未登入的情況下嘗試執行作業時,發生 IBM Cloud 鑑別錯誤。 |
28 | 與 IBM Cloud 通訊時,發生一般錯誤。 |
29 | 與配置服務通訊時,發生一般錯誤。 |
30 | 發生一般服務配置錯誤。 |
31 | 發生一般特性安裝錯誤。 |
255 | 發生不明錯誤。 |