Edge for Private Cloud v4.18.05
Edge 私有云(即 Edge 实例)的本地安装由安装在一组服务器节点上的多个 Edge 组件组成。下图显示了构成 Edge 实例的星球、区域、Pod、组织、环境和虚拟主机之间的关系:
下表介绍了这些关系:
组件 | 包含 | 关联的传感器 | 默认 |
---|---|---|---|
星球 | 一个或多个区域 | 不适用 | |
区域 | 一个或多个 Pod | “dc-1” | |
Pod | 一个或多个 Edge 组件 | "central" "gateway" "analytics" |
|
组织 | 一个或多个环境 | 一个或多个包含消息处理器的 Pod 以及作为组织管理员的用户 | 无 |
环境 | 一个或多个虚拟主机 | 与上级组织关联的 Pod 中的一个或多个消息处理器 | 无 |
虚拟主机 | 一个或多个主机别名 | 无 |
关于星球
一个星球表示整个边缘硬件和软件环境,可以包含一个或多个区域。在 Edge 中,行星是区域的逻辑分组:安装 Edge 时,您不必明确创建或配置星球。
关于区域
区域是指一个或多个 pod 的分组。默认情况下,当您安装 Edge 时,安装程序会创建一个名为“dc-1”的区域,其中包含三个 pod,如下表所示:
区域 | 区域中的 Pod |
---|---|
“dc-1” | “网关”“中央”“分析” |
下图显示了默认区域:
此图显示了将流量定向到“网关”Pod 的负载平衡器。“网关”Pod 包含用于处理 API 请求的边缘路由器和消息处理器组件。除非您定义了多个数据中心,否则无需创建其他区域。
在更复杂的安装中,您可以创建两个或更多区域。创建多个区域的原因之一是按地理位置整理机器,从而最大限度地缩短网络传输时间。在这种情况下,您可以托管 API 端点,以使这些端点在地理位置上距离这些 API 的使用方。
在 Edge 中,每个区域称为一个数据中心。这样,美国东部的数据中心就可以处理从马萨诸塞州波士顿抵达的请求,而新加坡的数据中心就可以处理来自亚洲设备或计算机的请求。
例如,下图显示了两个区域,分别对应两个数据中心:
关于 Pod
Pod 是一个或多个 Edge 组件和 Cassandra 数据存储区的分组。Edge 组件可以安装在同一节点上,但通常安装在不同节点上。 Cassandra 数据存储区是供 Pod 中的 Edge 组件使用的数据存储区。
默认情况下,当您安装 Edge 时,安装程序会创建三个 pod,并将以下 Edge 组件和 Cassandra 数据存储区与每个 pod 关联:
Pod | Edge 组件 | Cassandra 数据存储区 |
|
---|---|---|---|
"gateway" | 路由器、消息处理器 | cache-datastore counter-datastore dc-datastore |
keyvaluemap-datastore kms-datastore |
"central" | 管理服务器、Zookeeper、LDAP、界面、Qpid | application-datastore apimodel-datastore audit-datastore auth-datastore |
Identityzone-datastore edgenotification-datastore management-server scheduler-datastore user-settings-datastore |
"analytics" | Postgres | analytics-datastore | reportcrud-datastore |
API 处理需要“网关”Pod 中的 Edge 组件和 Cassandra 数据存储区。这些组件和数据存储区必须正常运行,才能处理 API 请求。“中央”和“分析”Pod 中的组件和数据存储区并非处理 API 的必要条件,但它们向 Edge 添加了额外的功能。
下图显示了每个 Pod 中的组件:
您可以将其他消息处理器和路由器 Pod 添加到默认创建的三个 Pod 中。或者,您也可以向现有 Pod 添加其他 Edge 组件。例如,您可以向“网关”Pod 添加更多路由器和消息处理器,以处理增加的流量负载。
请注意,“网关”Pod 包含边缘路由器和消息处理器组件。路由器仅向同一 Pod 中的消息处理器发送请求,而不向其他 Pod 中的消息处理器发送请求。
在每个 Pod 的安装结束时,您可以使用以下 API 调用查看服务器注册详情。这是一款实用的监控工具。
curl -u adminEmail:pword http://ms_IP:8080/v1/servers?pod=podName
其中,ms_IP 是管理服务器的 IP 地址或 DNS 名称,podName 是以下其中一项:
gateway
central
analytics
例如,对于“网关”Pod:
curl -u adminEmail:pword http://ms_IP:8080/v1/servers?pod=gateway
Apigee 会返回类似于以下内容的输出:
[ { "externalHostName" : "localhost", "externalIP" : "192.168.1.11", "internalHostName" : "localhost", "internalIP" : "192.168.1.11", "isUp" : true, "pod" : "gateway", "reachable" : true, "region" : "dc-1", "tags" : { "property" : [ { "name" : "jmx.rmi.port", "value" : "1101" }, ... ] }, "type" : [ "message-processor" ], "uUID" : "276bc250-7dd0-46a5-a583-fd11eba786f8" }, { "internalIP" : "192.168.1.11", "isUp" : true, "pod" : "gateway", "reachable" : true, "region" : "dc-1", "tags" : { "property" : [ ] }, "type" : [ "dc-datastore", "management-server", "cache-datastore", "keyvaluemap-datastore", "counter-datastore", "kms-datastore" ], "uUID" : "13cee956-d3a7-4577-8f0f-1694564179e4" }, { "externalHostName" : "localhost", "externalIP" : "192.168.1.11", "internalHostName" : "localhost", "internalIP" : "192.168.1.11", "isUp" : true, "pod" : "gateway", "reachable" : true, "region" : "dc-1", "tags" : { "property" : [ { "name" : "jmx.rmi.port", "value" : "1100" }, ... ] }, "type" : [ "router" ], "uUID" : "de8a0200-e405-43a3-a5f9-eabafdd990e2" } ]
type
属性列出了组件类型。请注意,它列出了在 Pod 中注册的 Cassandra 数据存储区。当 Cassandra 节点安装在“网关”Pod 中时,您将看到向所有 Pod 注册的 Cassandra 数据存储区。
关于组织
组织是存放 Apigee 帐号中所有对象的容器,包括 API、API 产品、应用和开发者。一个组织与一个或多个 Pod 相关联,其中每个 Pod 必须包含一个或多个消息处理器。
在本地安装 Edge Private Cloud 时,默认情况下没有组织。创建组织时,您需要指定两条信息:
- 担任组织管理员的用户。然后,该用户可以向组织添加其他用户,并设置每个用户的角色。
- “网关”Pod,即包含消息处理器的 Pod。
一个组织可以包含一个或多个环境。默认的 Edge 安装过程会提示您创建两个环境:“test”和“prod”。不过,您可以根据需要创建更多环境,如“预演”“实验”等。
组织提供了一些 Apigee 功能的范围。例如,键值对映射 (KVM) 数据在组织级别提供,即来自所有环境。其他功能(如缓存)的范围限定为特定的环境。Apigee 分析数据按组织和环境的组合进行分区。
下面显示的是组织的主要对象,包括在组织中进行全局定义的对象,以及专门针对环境定义的对象:
关于环境
环境是组织中 API 代理的运行时执行上下文。您必须先将 API 代理部署到环境,然后才能对其进行访问。您可以将 API 代理部署到单个环境或多个环境。
一个组织可以包含多个环境。例如,您可以定义组织中的“dev”“test”和“prod”环境。
创建环境时,您会将其与一个或多个消息处理器相关联。您可以将环境视为运行 API 代理的一组指定消息处理器。每个环境都可以与相同或不同的消息处理器关联。
要创建环境,请指定两条信息:
- 包含该环境的组织。
- 负责处理向环境发出的 API 代理请求的消息处理器。这些消息处理器必须位于与环境的上级组织关联的 Pod 中。
默认情况下,当您创建环境时,Edge 会将“网关”Pod 中所有可用的消息处理器与该环境相关联。或者,您也可以指定一部分可用的消息处理器,以便不同的消息处理器处理发送至不同环境的请求。
一个消息处理器可与多个环境关联。例如,您的 Edge 安装包含两个消息处理器:A 和 B。然后,在组织中创建三个环境:“dev”“test”和“prod”:
- 对于“dev”环境,您应关联消息处理器 A,因为您预计不会有大量流量。
- 对于“测试”环境,请关联消息处理器 B,因为您预计不会有大量流量。
- 对于“prod”环境,您应关联消息处理器 A 和 B 来处理生产级卷。
分配给环境的消息处理器可以全部来自同一 Pod,也可以来自跨多个区域和数据中心的多个 Pod。例如,在组织中将环境定义为“全球”,其中包含来自三个区域(即美国、日本和德国的三个不同数据中心)的消息处理器。
将 API 代理部署到“全局”环境会导致 API 代理在三个数据中心的所有消息处理器上运行。到达其中任何一个数据中心的路由器的 API 流量都只会被定向到该数据中心的消息处理器,因为路由器只会将流量定向到同一 Pod 中的消息处理器。
关于虚拟主机
虚拟主机定义公开 API 代理的 Edge Router 端口,并进而定义应用用于访问 API 代理的网址。每个环境必须至少定义一个虚拟主机。
确保虚拟主机指定的端口号在路由器节点上是打开的。然后,您可以通过向以下网址发出请求来访问 API 代理:
http://routerIP:port/proxy-base-path/resource-name https://routerIP:port/proxy-base-path/resource-name
其中:
http
或https
:如果虚拟主机已配置为支持 TLS/SSL,请使用 HTTPS。如果虚拟主机不支持 TLS/SSL,请使用 HTTP。- routerIP:port 是虚拟主机的 IP 地址和端口号。
- proxy-base-path 和 resource-name 是在创建 API 代理时定义的。
通常,您不能向具有 IP 地址和端口号的客户发布 API。而应为路由器和端口定义 DNS 条目。例如:
http://myAPI.myCo.com/proxy-base-path/resource-name https://myAPI.myCo.com/proxy-base-path/resource-name
您还必须为虚拟主机创建与 DNS 条目的域名匹配的主机别名。在上面的示例中,您要指定主机别名 myAPI.myCo.com。如果没有 DNS 条目,请将主机别名设置为路由器的 IP 地址和虚拟主机的端口,如 routerIP:port。
如需了解详情,请参阅关于虚拟主机。
创建您的第一个组织、环境和虚拟主机
完成 Edge 安装过程后,您的第一步通常是通过“初始配置”流程创建组织、环境和虚拟主机。如需执行初始配置,请在边缘管理服务器节点上运行以下命令:
/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
此命令将定义用户、组织、环境和虚拟主机的配置文件作为输入。
例如,您可以创建:
- 您选择担任组织管理员的用户
- 名为“
example
”的组织 - 组织中名为
prod
的环境,与“网关”Pod 中的所有消息处理器相关联 - 环境中名为
default
的虚拟主机,它允许通过端口 9001 进行 HTTP 访问 - 虚拟主机的主机别名
运行该脚本后,您可以使用以下格式的网址访问 API:
http://routerIP:9001/proxy-base-path/resource-name
您稍后可以添加任意数量的组织、环境和虚拟主机。
有关详情,请参阅对组织进行初始配置。