此步骤介绍如何下载和安装 apigeectl,如何设置安装目录,以及如何创建 Apigee Hybrid 运行所需的 Google Cloud 服务账号和 TLS 凭据。
下载并安装 apigeectl
apigeectl
是用于在 Kubernetes 集群中安装和管理 Apigee Hybrid 的命令行界面 (CLI)。
以下步骤介绍了如何获取 apigeectl
:
- 使用以下命令将最新版本号存储在变量中:
export VERSION=$(curl -s \ https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt?ignoreCache=1)
-
使用以下命令检查该变量是否已填充版本号。如果要使用其他版本,您可以改为将其保存在环境变量中。
echo $VERSION
1.4.0
-
使用以下命令下载适用于您的操作系统的软件包版本:
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
- 在您的系统上创建一个目录,作为 Apigee Hybrid 安装的基本目录。
-
使用以下命令将下载的 gzip 文件内容解压缩到您刚创建的基本目录中:
tar xvzf filename.tar.gz -C path-to-base-directory
- 使用
cd
命令将目录更改为基本目录。 -
默认情况下,tar 内容会扩展到其名称中包含版本和平台的目录。例如:
./apigeectl_1.4.0-d591b23_linux_64
。使用以下命令将该目录重命名为apigeectl
:mv apigeectl_1.4.0-d591b23_linux_64 apigeectl
- 使用以下命令切换到该目录:
cd ./apigeectl
此目录是
apigeectl
主目录。它是apigeectl
可执行命令所在的位置。 - 使用以下命令创建一个环境变量来保存此主目录路径:
export APIGEECTL_HOME=$PWD
- 使用以下命令验证该变量是否保存了正确的路径:
echo $APIGEECTL_HOME
设置项目目录结构
建议使用以下目录结构。它将 Apigee Hybrid 版本软件与您必须创建的配置文件分开。通过使用 $APIGEECTL_HOME
变量和您创建的符号链接,您可以根据需要轻松切换到新的软件版本。另请参阅升级 Apigee Hybrid。
- 使用以下命令确保您位于基本目录(
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 service-accounts
mkdir certs
-
在
hybrid-files
目录中,创建以下指向$APIGEECTL_HOME
的符号链接。这些链接可让您从hybrid-files
目录运行apigeectl
命令,如以下示例所示:ln -s
$APIGEECTL_HOME
/tools toolsln -s
$APIGEECTL_HOME
/config configln -s
$APIGEECTL_HOME
/templates templatesln -s
$APIGEECTL_HOME
/plugins plugins - 要检查符号链接是否正确创建,请执行以下命令,并确保链接路径指向正确的位置:
ls -l | grep ^l
现在,您已经拥有了一个可供您在 Kubernetes 集群中配置、部署和管理 Apigee Hybrid 的统一平台。接下来,您将创建配置 Hybrid 运行时组件所需的 Google Cloud 服务账号和凭据。
1 2 3 4 (下一步)第 5 步:设置服务账号 6 7