第 4 步：安装 apigeectl

此步骤介绍了如何下载和安装 apigeectl。

下载并安装 `apigeectl`

apigeectl 是用于在 Kubernetes 集群中安装和管理 Apigee Hybrid 的命令行界面 (CLI)。

以下步骤介绍了如何下载和安装 apigeectl：

Linux

使用以下命令将最新版本号存储在变量中：

export VERSION=$(curl -s \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt?ignoreCache=1)

使用以下命令检查该变量是否已填充版本号。如果要使用其他版本，您可以改为将其保存在环境变量中。
```
echo $VERSION
```
```
  1.7.6
```

使用以下命令下载适用于您的操作系统的软件包版本：

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

在您的系统上创建一个目录，作为 Apigee Hybrid 安装的基本目录。
使用以下命令将下载的 gzip 文件内容解压缩到您刚创建的基本目录中：
```
tar xvzf filename.tar.gz -C path-to-base-directory
```
使用 cd 命令将目录更改为基本目录。
默认情况下，tar 内容会扩展到其名称中包含版本和平台的目录。例如：./apigeectl_1.7.6-d591b23_linux_64。使用以下命令将该目录重命名为 apigeectl：
```
mv apigeectl_1.7.6-d591b23_linux_64 apigeectl
```
使用以下命令切换到该目录：
```
cd ./apigeectl
```
此目录是 apigeectl 主目录。它是 apigeectl 可执行命令所在的位置。
使用 version 命令验证 apigeectl 的版本：
```
./apigeectl version
```
```
Version: 1.7.6
```
使用以下命令创建一个环境变量来保存此主目录路径：
```
export APIGEECTL_HOME=$PWD
```
使用以下命令验证该变量是否保存了正确的路径：
```
echo $APIGEECTL_HOME
```

Mac OS

使用以下命令将最新版本号存储在变量中：

export VERSION=$(curl -s \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt)

使用以下命令检查该变量是否已填充版本号。如果要使用其他版本，您可以改为将其保存在环境变量中。
```
echo $VERSION
```
```
  1.7.6
```

使用以下命令下载适用于您的操作系统的软件包版本：

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

在您的系统上创建一个目录，作为 Apigee Hybrid 安装的基本目录。
使用以下命令将下载的 gzip 文件内容解压缩到您刚创建的基本目录中：
```
tar xvzf filename.tar.gz -C path-to-base-directory
```
使用 cd 命令将目录更改为基本目录。
默认情况下，tar 内容会扩展到其名称中包含版本和平台的目录。例如：./apigeectl_1.7.6-d591b23_mac_64。使用以下命令将该目录重命名为 apigeectl：
```
mv apigeectl_1.7.6-d591b23_mac_64 apigeectl
```
使用以下命令切换到该目录：
```
cd ./apigeectl
```
此目录是 apigeectl 主目录。它是 apigeectl 可执行命令所在的位置。
使用 version 命令验证 apigeectl 的版本：
```
./apigeectl version
```
```
Version: 1.7.6
```
使用以下命令创建一个环境变量来保存此主目录路径：
```
export APIGEECTL_HOME=$PWD
```
使用以下命令验证该变量是否保存了正确的路径：
```
echo $APIGEECTL_HOME
```

Windows

使用以下命令将最新版本号存储在变量中：

for /f "tokens=*" %a in ('curl -s ^
  https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt') ^
do set VERSION=%a

使用以下命令检查该变量是否已填充版本号。如果要使用其他版本，您可以改为将其保存在环境变量中。
```
echo %VERSION%
```
```
  1.7.6
```

使用以下命令下载适用于您的操作系统的软件包版本：

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

在您的系统上创建一个目录，作为 Apigee Hybrid 安装的基本目录。
使用以下命令将下载的 .zip 文件内容解压缩到当前目录中：
```
tar xvzf filename.zip -C path-to-base-directory
```
使用 cd 命令将目录更改为基本目录。
默认情况下，tar 文件内容会扩展到其名称中包含版本和平台的目录。例如：.\apigeectl_1.7.6-d591b23_windows_64。使用以下命令将该目录重命名为 apigeectl：
```
rename apigeectl_1.7.6-d591b23_windows_64 apigeectl
```
使用以下命令切换到该目录：
```
cd .\apigeectl
```
此目录是 apigeectl 主目录。它是 apigeectl 可执行命令所在的位置。
使用 version 命令验证 apigeectl 的版本：
```
./apigeectl version
```
```
Version: 1.7.6
```
使用以下命令创建一个环境变量来保存此主目录路径：
```
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.7.6rc1-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 的统一平台。接下来，您将创建配置 Hybrid 运行时组件所需的 Google Cloud 服务账号和凭据。

1 2 3 4 （下一步）第 5 步：设置服务账号 6 7 8 9

第 4 步：安装 apigeectl

下载并安装 apigeectl

Linux

Mac OS

Windows

设置项目目录结构

Linux

Mac OS

Windows

下载并安装 `apigeectl`