第 3 步:安装 apigeectl

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

下载并安装 apigeectl

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

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

Linux

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

    curl -LO \
        https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.8.8/apigeectl_linux_64.tar.gz
  2. 在您的系统上创建一个目录,作为 Apigee Hybrid 安装的基本目录
  3. 使用以下命令将下载的 gzip 文件内容解压缩到您刚创建的基本目录中:

    tar xvzf filename.tar.gz -C path-to-base-directory
  4. 使用 cd 命令将目录更改为基本目录。
  5. 默认情况下,tar 内容会扩展到其名称中包含版本和平台的目录。例如:./apigeectl_1.8.8-d591b23_linux_64。使用以下命令将该目录重命名为 apigeectl

    mv apigeectl_1.8.8-d591b23_linux_64 apigeectl
  6. 使用以下命令切换到该目录:
    cd ./apigeectl

    此目录是 apigeectl 主目录。它是 apigeectl 可执行命令所在的位置。

  7. 使用 version 命令验证 apigeectl 的版本:
    ./apigeectl version
    Version: 1.8.8
  8. 使用以下命令创建一个环境变量来保存此主目录路径:
    export APIGEECTL_HOME=$PWD
  9. 使用以下命令验证该变量是否保存了正确的路径:
    echo $APIGEECTL_HOME

Mac OS

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

    curl -LO \
        https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.8.8/apigeectl_mac_64.tar.gz
  2. 在您的系统上创建一个目录,作为 Apigee Hybrid 安装的基本目录
  3. 使用以下命令将下载的 gzip 文件内容解压缩到您刚创建的基本目录中:

    tar xvzf filename.tar.gz -C path-to-base-directory
  4. 使用 cd 命令将目录更改为基本目录。
  5. 默认情况下,tar 内容会扩展到其名称中包含版本和平台的目录。例如:./apigeectl_1.8.8-d591b23_mac_64。使用以下命令将该目录重命名为 apigeectl

    mv apigeectl_1.8.8-d591b23_mac_64 apigeectl
  6. 使用以下命令切换到该目录:
    cd ./apigeectl

    此目录是 apigeectl 主目录。它是 apigeectl 可执行命令所在的位置。

  7. 使用 version 命令验证 apigeectl 的版本:
    ./apigeectl version
    Version: 1.8.8
  8. 使用以下命令创建一个环境变量来保存此主目录路径:
    export APIGEECTL_HOME=$PWD
  9. 使用以下命令验证该变量是否保存了正确的路径:
    echo $APIGEECTL_HOME

Windows

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

    curl -LO ^
      https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.8.8/apigeectl_windows_64.zip
  2. 在您的系统上创建一个目录,作为 Apigee Hybrid 安装的基本目录
  3. 使用以下命令将下载的 .zip 文件内容解压缩到当前目录中:

    tar xvzf filename.zip -C path-to-base-directory
  4. 使用 cd 命令将目录更改为基本目录。
  5. 默认情况下,tar 文件内容会扩展到其名称中包含版本和平台的目录。例如:.\apigeectl_1.8.8-d591b23_windows_64。使用以下命令将该目录重命名为 apigeectl

    rename apigeectl_1.8.8-d591b23_windows_64 apigeectl
  6. 使用以下命令切换到该目录:
    cd .\apigeectl

    此目录是 apigeectl 主目录。它是 apigeectl 可执行命令所在的位置。

  7. 使用 version 命令验证 apigeectl 的版本:
    ./apigeectl version
    Version: 1.8.8
  8. 使用以下命令创建一个环境变量来保存此主目录路径:
    set APIGEECTL_HOME=%CD%
  9. 使用以下命令验证该变量是否保存了正确的路径:
    echo %APIGEECTL_HOME%

设置项目目录结构

建议使用以下目录结构。它将 Apigee Hybrid 版本软件与您必须创建的配置文件分开。通过使用 $APIGEECTL_HOME 变量和您创建的符号链接,您可以根据需要轻松切换到新的软件版本。另请参阅升级 Apigee Hybrid

Linux

  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 目录的路径:
    export HYBRID_FILES=$PWD
    echo $HYBRID_FILES
  6. hybrid-files 目录中,创建以下子目录,以整理您稍后创建的文件:
    mkdir overrides
    mkdir certs
  7. 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
  8. 如需检查符号链接是否已正确创建,请执行以下命令,并确保链接路径指向正确的位置:
    ls -l | grep ^l

Mac OS

  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 目录的路径:
    export HYBRID_FILES=$PWD
    echo $HYBRID_FILES
  6. hybrid-files 目录中,创建以下子目录,以整理您稍后创建的文件:
    mkdir overrides
    mkdir certs
  7. 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
  8. 如需检查符号链接是否已正确创建,请执行以下命令,并确保链接路径指向正确的位置:
    ls -l | grep ^l

Windows

  1. 使用以下命令确保您位于基本目录(apigeectl 目录所在的目录)中:
    cd %APIGEECTL_HOME%\..
  2. 使用以下命令创建名为 hybrid-files 的新文件夹。您可为目录指定所需的任意名称,但文档中将始终使用名称 hybrid-files。稍后,您需要将配置文件、服务账号密钥和 TLS 证书存储在此文件夹中。此文件夹可让您将配置文件与 apigeectl 软件安装分开。
    mkdir hybrid-files
  3. 当前目录结构现在如下所示:
    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.8.8rc1-437dccc_windows_64.zip
    08/05/2021  01:38 PM    <DIR>          hybrid-files
  4. 将目录切换为 hybrid-files 文件夹。
  5. 创建一个环境变量来保存 hybrid-files 目录的路径:
    set HYBRID_FILES=%CD%
    echo %HYBRID_FILES%
  6. hybrid-files 目录中,创建以下子目录,以整理您稍后创建的文件:
    mkdir overrides
    mkdir certs
  7. hybrid-files 目录中,创建以下指向 $APIGEECTL_HOME 的符号链接。这些链接可让您从 hybrid-files 目录运行 apigeectl 命令,如以下示例所示:
    mklink /d config %APIGEECTL_HOME%\config\
    mklink /d plugins %APIGEECTL_HOME%\plugins\
    mklink /d templates %APIGEECTL_HOME%\templates\
    mklink /d tools %APIGEECTL_HOME%\tools\
  8. 如需检查符号链接是否已正确创建,请使用 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 10