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