IBM® WebSphere® Application Server Liberty 建置套件會使 Liberty 伺服器在 Cloud Foundry 中成為可供使用。
開始之前
- 您必須安裝 Ruby 1.9.3 版或更新版本。
- 這份文件詳細說明如何利用 Linux 指令行來下載 IBM WebSphere Application Server Liberty 建置套件。
關於這項作業
請利用這個作業,將 IBM WebSphere Application Server Liberty 建置套件安裝在 Cloud Foundry 環境中。
如果您是 Cloud Foundry 管理者,您可以將 Liberty 建置套件安裝成管理者建置套件,使它在 Cloud Foundry 中成為可供所有使用者使用。
註: 建置套件的使用者不需要為了直接使用管理者的建置套件而指定 -b 選項。
https://github.com/cloudfoundry/ibm-websphere-liberty-buildpack也提供 IBM WebSphere Application Server Liberty 建置套件,您可以在這裡找到額外的說明文件。
程序
將建置套件安裝在 Cloud Foundry 環境中
- 從 IBM 修正程式中心下載建置套件壓縮檔。
- 執行 unzip 指令,將建置套件 ibm-websphere-liberty-buildpack-v*.zip 檔的內容解壓縮到下列建置套件目錄 ibm-websphere-liberty-buildpack
- IBM WebSphere Application Server Liberty 建置套件會下載專用於開發的預設 Liberty 及 IBM JRE 二進位檔。 如果您有其他想要使用的二進位檔的授權,它們必須能夠透過 HTTP 來存取。
請參閱建構用於個人二進位檔的 Liberty 儲存庫,以取得如何建構這個儲存庫的詳細資料。
- 更新 config/ibmjdk.yml 檔來指向您的 JRE 二進位檔。
- 更新 config/liberty.yml 檔來指向您的 Liberty 二進位檔。
- 如果您已獲授權將建置套件部署在您的環境中,您可以在包裝之前,建立一個包含所接受授權數目的 config/licenses.yml 檔。
IBM_JVM_LICENSE: <jvm license code>
IBM_LIBERTY_LICENSE: <liberty license code>
註: 您新增建置套件的授權之後,個別應用程式便不需要在環境變數中接受授權條款。
- 執行 gem install bundler 和 bundle install 指令來安裝包裝管理者建置套件時所需的 Ruby gem。
- 執行 bundle exec rake 套件作業來建立管理者建置套件。
rake 'package[zipfile,hosts,version]'
zipfile 參數是所產生的管理者建置套件的名稱,它包含一個並非現行目錄的相對位置。
例如,您可以在 zipfile 參數中指定 ../my-admin-buildpack.zip,以在上層目錄產生 my-admin-buildpack.zip 檔,而不是預設的 ibm-websphere-liberty-buildpack-480d2de.zip 檔。
例如,
rake 'package[../my-admin-buildpack.zip]'
hosts 參數是一份站台清單,包裝作業會從其中取出要併入管理者建置套件中的二進位檔。
依預設,只會取出公用 IBM 站台中的二進位檔。
IBM 代管站台不含協力廠商二進位檔。
必須指定 package 參數,以指出在離線模式使用管理者建置套件時,管理者建置套件可以包含協力廠商二進位檔。
在包裝期間,如果有可能下載,使用 * 會併入管理者建置套件中的所有二進位檔。
這個用法的範例如下:
rake 'package[,*,]'
version 參數是利用 Cloud Foundry 指令行介面將應用程式部署於 CloudFoundry 時,所顯示的版本資訊。
依預設,顯示的版本是最新確定的 ID,例如 480d2de。
下列範例說明顯示的版本資訊預設值。
Liberty Buildpack Version: 480d2de | git@github.com:cloudfoundry/ibm-websphere-liberty-buildpack.git#480d2de
- 依照下列方式,以 cf 用戶端來安裝管理者建置套件:
cf create-buildpack ibm-websphere-liberty-buildpack ibm-websphere-liberty-buildpack-480d2de.zip 1
- ibm-websphere-liberty-buildpack 是提供給管理者建置套件的名稱。
- ibm-websphere-liberty-buildpack-480d2de.zip 是 Rake 作業所建立之壓縮檔的路徑。
- 1 是提供給管理者建置套件的優先順序。號碼越低,優先順序越高。
請參閱
Cloud Foundry 說明文件,以取得進一步的詳細資料。
結果
現在,已安裝好 IBM WebSphere Application Server Liberty 建置套件。