您正在查看的是 Apigee Edge 文档。
转到 Apigee X 文档。 信息
本主题提供代理部署的快速概览。您可以使用管理界面、命令行脚本或 API 部署代理。
视频:观看一小段视频,了解在 API 代理部署期间实现零停机时间的最佳实践。
何时部署代理
必须先部署代理,然后才能调用它。通常,部署时由您决定。在测试环境中工作时,您可以以迭代方式进行多次部署。另一方面,将代理从测试环境部署到生产环境的决定通常取决于您的开发团队制定的生命周期规则。
在以下情况下,部署或重新部署代理:
- 创建新的代理(自动部署)
- 修改现有代理
- 创建代理的新修订版本
- 创建新版代理
- 将代理从一个环境推送到另一个环境,例如从测试环境推送到生产环境。
- 删除并重新创建密钥库。
在何处部署代理
将代理部署到环境。默认情况下,Apigee Edge 中的所有组织都具有两个环境,分别是测试和生产环境。这些环境仅用于为您提供一个领域,供您处理和测试 API 变更,以及向应用提供 API。下图显示了已部署到 test
环境的代理(以绿点表示)。
如何部署代理
部署代理的方式取决于您开发代理的位置。如果您在界面中操作,只需点击几下鼠标即可轻松部署代理。创建新代理时,系统会自动部署该代理;您无需执行任何特殊操作。重新部署现有代理的过程几乎一样简单。您只需选择要部署到哪个部署环境,其余工作均由管理界面来完成。如需了解详情,请参阅在界面中部署代理。
如果您要离线开发代理和相关组件(即直接在文件系统上处理代理 XML 文件和其他代码),Apigee Edge 提供了可供您使用的便捷命令行部署工具。您还可以获取示例 Shell 脚本,配置并运行该脚本来上传和部署代理文件。如需了解详情,请参阅从命令行部署代理。
最后,您可以使用 Edge Management API 来部署代理。部署 API 提供原子功能,您的开发团队可以协调这些原子功能,以自动执行和优化 API 开发生命周期。请参阅使用 Management API 部署 API 代理。
什么是 API 代理修订版本?
借助修订版本,您可以在创建 API 代理更新并将其部署到环境时管理 API 代理更新。修订版本会按顺序进行编号,让您能够通过部署 API 代理的先前修订版本来还原更改。
如果多个修订版本共用相同的 API 代理基本路径,则在给定时间只能在一个环境中部署一个 API 代理的修订版本。
通常,必须先取消部署现有修订版本,然后才能部署新修订版本。其他高级选项包括覆盖已部署的修订版本或选择根本不递增修订版本。例如,当您进行细微更改时,您可能不想递增修订版本。这些高级选项可通过直接调用 Edge Management API 来实现。请参阅使用 Management API 部署 API 代理。
您可以将 API 代理的修订版本部署到 prod
环境中,同时继续在 test
环境中创建该 API 代理的新修订版本。准备就绪后,您可以从 test
环境中“升级”API 代理的更高修订版本,以取代 prod
环境中 API 代理的先前修订版本。
如需详细了解修订版本,请参阅使用 Management API 部署 API 代理和在界面中部署代理。
视频:观看短视频以详细了解 API 修订版本。