托管的目标概览

您正在查看 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 代理迁移到托管的目标代理