步驟 4：安裝 apigeectl

本步驟說明如何下載及安裝 apigeectl、設定安裝目錄，以及建立 Apigee Hybrid 運作所需的 Google Cloud 服務帳戶和 TLS 憑證。

下載並安裝 apigeectl

apigeectl 是指令列介面 (CLI)，可用於在 Kubernetes 叢集中安裝及管理 Apigee hybrid。

下列步驟說明如何取得 apigeectl：

  1. 使用下列指令，將最新版本號碼儲存在變數中：
    export VERSION=$(curl -s \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt?ignoreCache=1)
  2. 使用下列指令，檢查變數是否已填入版本號碼。如果您想使用其他版本，可以改為將該版本儲存在環境變數中。
    echo $VERSION
     
      1.4.0

  3. 使用下列指令，下載適用於您作業系統的版本套件：

    Mac 64 位元：

    curl -LO \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_mac_64.tar.gz

    Linux 64 位元：

    curl -LO \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_linux_64.tar.gz

    Mac 32 位元：

    curl -LO \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_mac_32.tar.gz

    Linux 32 位元：

    curl -LO \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_linux_32.tar.gz
  4. 在系統上建立目錄，做為 Apigee Hybrid 安裝作業的基礎目錄。

  5. 使用下列指令，將下載的 gzip 檔案內容解壓縮至您剛剛建立的基礎目錄：

    tar xvzf filename.tar.gz -C path-to-base-directory
  6. 使用 cd 指令將目錄變更為基礎目錄。

  7. 根據預設，tar 內容會解壓縮為名稱中含有版本和平台的目錄。例如：./apigeectl_1.4.0-d591b23_linux_64。使用下列指令將該目錄重新命名為 apigeectl：

    mv apigeectl_1.4.0-d591b23_linux_64 apigeectl
  8. 使用下列指令切換至目錄： 
    cd ./apigeectl

    這個目錄是 apigeectl 主目錄。這是 apigeectl 可執行指令所在的位置。

  9. 請使用下列指令建立環境變數，以便儲存這個主目錄路徑：
    export APIGEECTL_HOME=$PWD
  10. 使用下列指令確認變數是否包含正確的路徑：
    echo $APIGEECTL_HOME

設定專案目錄結構

建議您採用下列目錄結構。它會將 Apigee Hybrid 發布軟體與您必須建立的設定檔分開。您可以使用所建立的 $APIGEECTL_HOME 變數和符號連結，輕鬆切換至新版軟體。另請參閱「升級 Apigee Hybrid」。

  1. 請使用下列指令，確認您位於基礎目錄 (apigeectl 目錄所在的目錄)：
    cd $APIGEECTL_HOME/..
  2. 使用下列指令建立名為 hybrid-files 的新資料夾。您可以為目錄命名，但在文件中，我們會一律使用 hybrid-files 這個名稱。稍後，您將在這個資料夾中儲存設定檔、服務帳戶金鑰和 TLS 憑證。這個資料夾可讓您將設定檔與 apigeectl 軟體安裝作業分開。
    mkdir hybrid-files
  3. 目前的目錄結構如下所示： 
    pwd && ls
/hybrid-base-directory
  apigeectl
  hybrid-files
  4. 使用下列指令將目錄變更為 hybrid-files 資料夾： 
    cd hybrid-files
  5. 在 hybrid-files 目錄中建立下列子目錄，以便整理稍後建立的檔案：
    mkdir overrides
mkdir service-accounts
mkdir certs
  6. 在 hybrid-files 目錄中，建立以下指向 $APIGEECTL_HOME 的符號連結。這些連結可讓您從 hybrid-files 目錄內執行 apigeectl 指令，如以下範例所示： 
    ln -s $APIGEECTL_HOME/tools tools
ln -s $APIGEECTL_HOME/config config
ln -s $APIGEECTL_HOME/templates templates
ln -s $APIGEECTL_HOME/plugins plugins
  7. 如要確認是否已正確建立符號連結，請執行下列指令，並確認連結路徑指向正確的位置：
    ls -l | grep ^l

您現在有了起點，可在 Kubernetes 叢集中設定、部署及管理 Apigee Hybrid。接下來，您將建立 Google Cloud 服務帳戶和憑證，以便設定混合式執行階段元件。

1 2 3 4 6 7