本頁面由 Cloud Translation API 翻譯而成。

步驟 4：安裝 apigeectl

本步驟說明如何下載及安裝 apigeectl。

下載並安裝 `apigeectl`

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

下列步驟說明如何下載及安裝 apigeectl：

Linux

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

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

在系統上建立目錄，做為 Apigee Hybrid 安裝作業的基礎目錄。
使用下列指令，將下載的 gzip 檔案內容解壓縮至您剛剛建立的基礎目錄：
```
tar xvzf filename.tar.gz -C path-to-base-directory
```
使用 cd 指令將目錄變更為基礎目錄。
根據預設，tar 內容會解壓縮為名稱中含有版本和平台的目錄。例如：./apigeectl_1.6.9-d591b23_linux_64。使用下列指令將該目錄重新命名為 apigeectl：
```
mv apigeectl_1.6.9-d591b23_linux_64 apigeectl
```
使用下列指令切換至目錄：
```
cd ./apigeectl
```
這個目錄是 apigeectl 主目錄。這是 apigeectl 可執行指令所在的位置。
使用 version 指令驗證 apigeectl 的版本：
```
./apigeectl version
```
```
Version: 1.6.9
```
請使用下列指令建立環境變數，以便儲存這個主目錄路徑：
```
export APIGEECTL_HOME=$PWD
```
使用下列指令確認變數是否包含正確的路徑：
```
echo $APIGEECTL_HOME
```

Mac OS

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

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

在系統上建立目錄，做為 Apigee Hybrid 安裝作業的基礎目錄。
使用下列指令，將下載的 gzip 檔案內容解壓縮至您剛剛建立的基礎目錄：
```
tar xvzf filename.tar.gz -C path-to-base-directory
```
使用 cd 指令將目錄變更為基礎目錄。
根據預設，tar 內容會解壓縮為名稱中含有版本和平台的目錄。例如：./apigeectl_1.6.9-d591b23_mac_64。使用下列指令將該目錄重新命名為 apigeectl：
```
mv apigeectl_1.6.9-d591b23_mac_64 apigeectl
```
使用下列指令切換至目錄：
```
cd ./apigeectl
```
這個目錄是 apigeectl 主目錄。這是 apigeectl 可執行指令所在的位置。
使用 version 指令驗證 apigeectl 的版本：
```
./apigeectl version
```
```
Version: 1.6.9
```
請使用下列指令建立環境變數，以便儲存這個主目錄路徑：
```
export APIGEECTL_HOME=$PWD
```
使用下列指令確認變數是否包含正確的路徑：
```
echo $APIGEECTL_HOME
```

Windows

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

curl -LO ^
  https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.6.9/apigeectl_windows_64.zip

在系統上建立目錄，做為 Apigee Hybrid 安裝作業的基礎目錄。
使用下列指令，將下載的 .zip 檔案內容解壓縮至目前目錄：
```
tar xvzf filename.zip -C path-to-base-directory
```
使用 cd 指令將目錄變更為基礎目錄。
根據預設，tar 檔案內容會展開為名稱中包含版本和平台的目錄。例如：.\apigeectl_1.6.9-d591b23_windows_64。使用下列指令將該目錄重新命名為 apigeectl：
```
rename apigeectl_1.6.9-d591b23_windows_64 apigeectl
```
使用下列指令切換至目錄：
```
cd .\apigeectl
```
這個目錄是 apigeectl 主目錄。這是 apigeectl 可執行指令所在的位置。
使用 version 指令驗證 apigeectl 的版本：
```
./apigeectl version
```
```
Version: 1.6.9
```
請使用下列指令建立環境變數，用來儲存這個主目錄路徑：
```
set APIGEECTL_HOME=%CD%
```
使用下列指令確認變數是否包含正確的路徑：
```
echo %APIGEECTL_HOME%
```

設定專案目錄結構

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

Linux

請使用下列指令，確認您位於基礎目錄 (apigeectl 目錄所在的目錄)：
```
cd $APIGEECTL_HOME/..
```
使用下列指令建立名為 hybrid-files 的新資料夾。您可以為目錄命名，但在文件中，我們會一律使用 hybrid-files 這個名稱。稍後，您將在這個資料夾中儲存設定檔、服務帳戶金鑰和 TLS 憑證。這個資料夾可讓您將設定檔與 apigeectl 軟體安裝作業分開。
```
mkdir hybrid-files
```

目前的目錄結構如下所示：

pwd && ls

/hybrid-base-directory
  apigeectl
  hybrid-files

使用下列指令將目錄變更為 hybrid-files 資料夾：
```
cd hybrid-files
```
在 hybrid-files 目錄中建立下列子目錄，以便整理稍後建立的檔案：
```
mkdir overrides
mkdir certs
```
在 hybrid-files 目錄中，建立以下指向 $APIGEECTL_HOME 的符號連結。這些連結可讓您從 hybrid-files 目錄內執行 apigeectl 指令，如以下範例所示：
注意：如果您不是第一次使用這個程序，可能已經有下列符號連結。使用下列指令，檢查連結是否已存在。如果目錄已存在，請略過這個步驟。
```
ls -l | grep ^l
```
```
ln -s $APIGEECTL_HOME/tools tools
ln -s $APIGEECTL_HOME/config config
ln -s $APIGEECTL_HOME/templates templates
ln -s $APIGEECTL_HOME/plugins plugins
```
如要確認是否已正確建立符號連結，請執行下列指令，並確認連結路徑指向正確的位置：
```
ls -l | grep ^l
```

Mac OS

請使用下列指令，確認您位於基礎目錄 (apigeectl 目錄所在的目錄)：
```
cd $APIGEECTL_HOME/..
```
使用下列指令建立名為 hybrid-files 的新資料夾。您可以為目錄命名，但在文件中，我們會一律使用 hybrid-files 這個名稱。稍後，您將在這個資料夾中儲存設定檔、服務帳戶金鑰和 TLS 憑證。這個資料夾可讓您將設定檔與 apigeectl 軟體安裝作業分開。
```
mkdir hybrid-files
```

目前的目錄結構如下所示：

pwd && ls

/hybrid-base-directory
  apigeectl
  hybrid-files

使用下列指令將目錄變更為 hybrid-files 資料夾：
```
cd hybrid-files
```
在 hybrid-files 目錄中建立下列子目錄，以便整理稍後建立的檔案：
```
mkdir overrides
mkdir certs
```
在 hybrid-files 目錄中，建立以下指向 $APIGEECTL_HOME 的符號連結。這些連結可讓您從 hybrid-files 目錄內執行 apigeectl 指令，如以下範例所示：
注意：如果您不是第一次使用這個程序，可能已經有下列符號連結。使用下列指令，檢查連結是否已存在。如果目錄已存在，請略過這個步驟。
```
ls -l | grep ^l
```
```
ln -s $APIGEECTL_HOME/tools tools
ln -s $APIGEECTL_HOME/config config
ln -s $APIGEECTL_HOME/templates templates
ln -s $APIGEECTL_HOME/plugins plugins
```
如要確認是否已正確建立符號連結，請執行下列指令，並確認連結路徑指向正確的位置：
```
ls -l | grep ^l
```

Windows

請使用下列指令，確認您位於基礎目錄 (apigeectl 目錄所在的目錄)：
```
cd %APIGEECTL_HOME%\..
```
使用下列指令建立名為 hybrid-files 的新資料夾。您可以為目錄命名，但在文件中，我們會一律使用 hybrid-files 這個名稱。稍後，您將在這個資料夾中儲存設定檔、服務帳戶金鑰和 TLS 憑證。這個資料夾可讓您將設定檔與 apigeectl 軟體安裝作業分開。
```
mkdir hybrid-files
```

目前的目錄結構如下所示：

dir

 Directory of C:\Users\example\hybrid

08/05/2021  01:38 PM    <DIR>          .
08/05/2021  01:38 PM    <DIR>          ..
08/02/2021  01:11 PM    <DIR>          apigeectl
08/02/2021  11:13 AM         5,803,963 apigeectl_1.6.9rc1-437dccc_windows_64.zip
08/05/2021  01:38 PM    <DIR>          hybrid-files

將目錄變更為 hybrid-files 資料夾。
在 hybrid-files 目錄中建立下列子目錄，以便整理稍後建立的檔案：
```
mkdir overrides
mkdir certs
```
在 hybrid-files 目錄中，建立以下指向 $APIGEECTL_HOME 的符號連結。這些連結可讓您從 hybrid-files 目錄內執行 apigeectl 指令，如以下範例所示：
注意：您必須具備 Windows 電腦的管理員權限，才能執行 mklink 指令。您可以以管理員身分執行指令終端機，或使用 runas 指令來達成這項目標。例如：
```
runas /noprofile /user:mymachine\administrator "mklink /d config %APIGEECTL_HOME%\config"
```
```
mklink /d config %APIGEECTL_HOME%\config\
mklink /d plugins %APIGEECTL_HOME%\plugins\
mklink /d templates %APIGEECTL_HOME%\templates\
mklink /d tools %APIGEECTL_HOME%\tools\
```

如要確認是否已正確建立符號連結，請使用 dir：

dir

 Directory of C:\Users\example\hybrid\hybrid-files

08/05/2021  01:56 PM    <DIR>          .
08/05/2021  01:56 PM    <DIR>          ..
08/05/2021  01:46 PM    <DIR>          certs
08/05/2021  01:55 PM    <SYMLINKD>     config [C:\Users\example\hybrid\apigeectl\config\]
08/05/2021  01:46 PM    <DIR>          overrides
08/05/2021  01:56 PM    <SYMLINKD>     plugins [C:\Users\example\hybrid\apigeectl\plugins\]
08/05/2021  01:56 PM    <SYMLINKD>     templates [C:\Users\example\hybrid\apigeectl\templates\]
08/05/2021  01:56 PM    <SYMLINKD>     tools [C:\Users\example\hybrid\apigeectl\tools\]

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

1 2 3 4 (下一頁) 步驟 5：設定服務帳戶 6 7 8 (下一頁) 步驟 5：設定服務帳戶 6 9

步驟 4：安裝 apigeectl

下載並安裝 apigeectl

Linux

Mac OS

Windows

設定專案目錄結構

Linux

Mac OS

Windows

下載並安裝 `apigeectl`