步驟 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 (NEXT) Step 5: Set up service accounts 6 7