您正在查看 Apigee Edge 文档。
前往 Apigee X 文档。信息
借助托管的目标,您可以在 Apigee 托管的原生运行时环境中运行 Node.js 应用。托管目标的目标很简单:让您能够在原生、安全、可伸缩且隔离的环境中部署应用,Edge API 代理可以将其作为目标服务调用。
如下图所示,Edge API 代理会调用已部署到 Hosted Targets 环境的 Node.js 应用。请注意,“托管的目标”环境的范围在 Apigee 组织:环境内。
若要让 Edge API 代理与正确构建和部署的托管目标应用进行通信,需要在代理的目标端点中进行简单的配置。要开始使用,请参阅托管目标教程。
托管目标支持哪些应用运行时?
目前,您只能将 Node.js 应用部署到托管目标。
安装托管目标
托管的目标平台适用于所有 Edge Public Cloud 组织。您无需安装任何内容即可使用托管式目标平台。
验证是否已启用托管目标
如果您想要验证您的组织是否已启用托管目标,请获取组织详细信息并确保 features.isEdgeFunctionsEnabled
属性设置为 true。该属性为只读属性。
例如:
https://api.enterprise.apigee.com/v1/organizations/myorg
{ "createdAt":1507572884047, "createdBy":"jdoe@apigee.com", "displayName":"myorg", "environments":[ "prod", "dev", "test", "portal" ], "lastModifiedAt":1507578673194, "lastModifiedBy":"jdoe@apigee.com", "name":"jdoe", "properties":{ "property":[ { "name":"features.isSmbOrganization", "value":"false" }, { "name":"self.service.virtual.host.enabled", "value":"true" }, { "name":"features.isCpsEnabled", "value":"true" }, { "name":"features.isEdgeFunctionsEnabled", "value":"true" } ] }, "type":"paid" }
您需要了解的有关托管目标的注意事项
借助托管的目标平台,Node.js 应用可以在不依赖于任何 Apigee 专用运行时技术的原生环境中运行。您可以在部署应用之前在本地调试和测试应用,并确保部署后的版本将与本地版本完全一样。在部署时,您可以选择任何应用运行时版本,以便在托管的目标平台中运行应用。例如,您可能专门选择在 v8.10.0 环境中运行 Node.js 应用。
限制
如需了解托管目标的使用限制,请参阅 Apigee 产品限制。
基本步骤
如果您熟悉 Edge 代理开发,只需了解几个简单的步骤即可成功使用托管式目标。从本质上讲,您可以为托管目标创建、部署和管理 Edge 代理,就像为任何其他 Apigee Edge 代理执行的操作一样。
要使用托管目标,您需要执行以下任务。教程详细介绍了这些任务。
- 在本地开发和测试 Node.js 应用。
- 在应用项目的根目录中创建清单文件。清单是一个 YAML 文件,指定了构建和部署应用所需的信息。
- 将您的应用作为托管资源类型添加到 Edge 代理。
- 在代理的目标端点中,添加一个空的
<HostedTarget/>
标记。此标记会指示 Edge 将 Node.js 应用部署到托管的目标环境。例如:
<?xml version="1.0" encoding="UTF-8"?> <TargetEndpoint name="default"> <PreFlow name="PreFlow"> <Request /> <Response /> </PreFlow> <PostFlow name="PostFlow"> <Request /> <Response /> </PostFlow> <Flows /> <HostedTarget /> </TargetEndpoint>
Hosted Targets 应用的范围
托管的目标应用的范围限定为 Edge 组织-环境。此范围与任何 Edge 代理的范围相同。
托管目标应用能否访问代理数据?
托管的目标应用目前无法访问代理运行时环境。这意味着您无法直接从 Hosted Targets 应用访问流变量、缓存和其他实体。
借助嵌入式 Node.js(Edge 中基于 Trireme 的传统 Node.js 支持),您可以使用 apigee-access 访问 Edge 中的流变量和其他实体。不过,托管目标不支持 Node.js 部署的 apigee-access
模块。
另请参阅是否可以解决缺少 apigee-access 的问题?
将现有应用代码迁移到托管目标
目前,从传统的基于 Trireme 的嵌入式 Node.js 应用迁移到托管目标没有自动化路径。不过,您可以手动将现有应用代码转换为 Hosted Targets。如需查看示例,请参阅将现有 Node.js 代理迁移到托管的目标代理。