通过命令行部署代理

<ph type="x-smartling-placeholder"></ph> 您正在查看 Apigee Edge 文档。
转到 Apigee X 文档。 信息

本主题介绍了如何从命令行部署代理。Apigee Edge 提供了 以及通过命令行进行部署的选项第一种方法是使用 Apigee Edge 部署工具 使用 Python 语言编写另一种是配置并运行 Shell 脚本。

在直接处理代理来源时，使用命令行部署技术 文件。离线工作的原因有很多。您可能希望使用 或者您正在制定要求使用 Java 编码的政策， 主要在 IDE 中工作。通过本部分介绍的技巧，您可以将 将源文件部署到您选择的 API 服务环境。

如果您主要使用管理界面，请参阅在界面中部署代理。

您正在查看 Apigee Edge 文档。
转到 Apigee X 文档。 信息

运行 Apigee Edge Python 部署工具

Apigee Edge Python 部署工具与 Edge Management API 搭配使用，可导入和部署 API 代理。该工具作为 GitHub 上的 API 平台示例发行版的一部分提供。请参阅 使用示例 API 代理。

使用 Apigee Edge Python 工具，您可以在一个简单的环境中导入（上传）和部署 API 过程。

必须从 API 平台发行版中的基本目录运行部署工具 示例分发，其中基本目录是 setup 的父级目录 和 tools 目录中。

在以下命令中，替换代理名称、您的 Edge 用户名和密码， 以及包含 API 代理的 “apiproxy" 目录：

python tools/deploy.py -n proxyname -u name:passW -o org -e env -d proxypath -p /

例如：

python tools/deploy.py -n weatherapi -u me@myCo.com:foo -o myCo -e test -d weatherapi -p /

此命令会压缩您的文件，将其推送到您的组织在 Apigee Edge 上， 指定环境

部署工具会自动发现 API 的当前修订版本 取消部署现有修订版本，并部署 API 的递增修订版本 代理。

成功后，您会看到以下格式的输出：

Writing ./<proxybasedir>/apiproxy/weatherapi.xml to apiproxy/weatherapi.xml
Writing ./<proxybasedir>/apiproxy/proxies/default.xml to apiproxy/proxies/default.xml
Writing ./<proxybasedir>/apiproxy/targets/default.xml to apiproxy/targets/default.xml
Imported new proxy version 1
Environment: test
  Revision: 1 BasePath = /
  State: deployed

默认情况下，该工具会将 API 代理上传到 https://api.enterprise.apigee.com， 与云端的 Edge 相对应。您还可以使用此工具将 API 代理上传到 通过指定 -h 标志来启用 Edge 的本地版本：

python tools/deploy.py -n weatherapi -u me@myCo.com:foo -o myCo -e test -d weatherapi -p / -h https://192.168.11.111:8080

在此示例中，您指定了边缘管理服务器的 IP 地址。如果您创建了 管理服务器的 DNS 记录，则可以指定以下格式的网址：

https://ms_URL:8080

该命令的完整标志列表如下：

  • -n：您的 API 代理的名称。
  • -u：您在 Apigee 中组织的用户名和密码 Edge。
  • -o：您在其中注册了账号的组织的名称。
  • -e：应在其中部署 API 代理的环境 （test 或 prod）。
  • -d：包含 API 代理文件的目录的路径。您的 API 代理 文件必须存储在名为“apiproxy”的目录下。该值是 “apiproxy”目录，而不是指向 “apiproxy”目录本身
  • -p：用作模式匹配以将传入消息路由到此 API 的 URI 路径 代理部署。在大多数情况下，您可以将此值设置为“/”，除非您 部署和路由要求用于 API 代理路由的主路径在 API 代理的 ProxyEndpoint 配置文件。
  • -h：Edge 网址。默认情况下，网址为 https://api.enterprise.apigee.com。 与云端的 Edge 相对应。对于本地部署，请使用 Edge 的网址 和端口 8080，如下所示： 
    https://ms_URL:8080

    或者，使用管理服务器的 IP 地址，如 https://192.168.11.111:8080。

配置并运行部署 shell 脚本

最简单的方法是运行随示例 API 代理提供的部署脚本。外壳 用于封装 Apigee Edge Python 部署工具的脚本。

从 /simplyProxy 目录运行以下命令：

$ sh deploy.sh

您应该会看到：

Enter your password for user {myname} in the Apigee Enterprise organization {org_name}, followed by [ENTER]:

输入密码，然后按 Enter 键。

然后，您应该会看到以下内容：

Deploying to test on https://api.enterprise.apigee.com using {myname} on enterprise.apigee.com and {org_name} on enterprise.apigee.com

如果您看到以下内容：

Enter your password for user Your USERNAME on enterprise.apigee.com in the Apigee Enterprise organization Your ORG on enterprise.apigee.com, followed by [ENTER]:

而是需要修改 /setup/setenv.sh 文件 平台样本分布情况。有关说明，请参阅 README 文件或 Apigee Edge API。

部署成功后，部署工具会将 /apiproxy, 导入项下的文件压缩 在 Apigee Edge 上将软件包部署到您的组织，然后将 API 代理部署到“test” 环境

现在可以调用您的 API 代理了。