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

步驟 3：安裝 apigeectl

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

下載並安裝 `apigeectl`

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

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

Linux

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

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

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

Mac OS

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

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

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

Windows

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

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

在系統上建立目錄，做為 Apigee Hybrid 安裝的基本目錄。
使用下列指令，將下載的 .zip 檔案內容解壓縮至目前目錄：
```
tar xvzf filename.zip -C path-to-base-directory
```
使用 cd 指令將目錄變更為基本目錄。
根據預設，tar 檔案內容會展開至目錄，且目錄名稱會包含版本和平台。例如：.\apigeectl_1.9.4-d591b23_windows_64。使用下列指令將該目錄重新命名為 apigeectl：
```
rename apigeectl_1.9.4-d591b23_windows_64 apigeectl
```
使用下列指令切換至該目錄：
```
cd .\apigeectl
```
這個目錄是 apigeectl 主目錄。這是 apigeectl 可執行指令所在的位置。
使用 version 指令驗證 apigeectl 版本：
```
./apigeectl version
```
```
Version: 1.9.4
```
使用下列指令建立環境變數，以保留這個主目錄路徑：
```
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 目錄的路徑：
```
export HYBRID_FILES=$PWD
```
```
echo $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 目錄的路徑：
```
export HYBRID_FILES=$PWD
```
```
echo $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.9.4rc1-437dccc_windows_64.zip
08/05/2021  01:38 PM    <DIR>          hybrid-files

將目錄變更為 hybrid-files 資料夾。
建立環境變數，以保留 hybrid-files 目錄的路徑：
```
set HYBRID_FILES=%CD%
```
```
echo %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 (NEXT) Step 4: Set up service accounts 5 6 7 8 9 10

步驟 3：安裝 apigeectl 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

下載並安裝 apigeectl

Linux

Mac OS

Windows

設定專案目錄結構

Linux

Mac OS

Windows

步驟 3：安裝 apigeectl

下載並安裝 `apigeectl`