适用于私有云的 Edge v. 4.17.09
本部分介绍了各种管理操作,例如,在安装适用于私有云的 Apigee Edge 中,创建、管理和移除 Apigee 组织、环境和虚拟主机。
如需了解组织、环境和虚拟主机,请参阅星球、区域、Pod、组织、环境和虚拟主机简介。
检查用户、组织和环境的状态
在 Edge Private Cloud 的本地安装中,管理服务器在将所有其他组件整合在一起方面发挥着至关重要的作用。您可以通过发出以下 C网址 命令,在管理服务器上检查用户、组织和部署状态:
curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/users curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations/<orgname>/deployments
系统应为所有调用显示 200 HTTP 状态。如果这些操作失败,请执行以下操作:
- 检查 /opt/apigee/var/log/apigee/management-server 中的管理服务器日志,确认是否存在任何错误。
- 对管理服务器进行调用,检查其是否正常运行。
- 从 ELB 中移除服务器,然后重启管理服务器:
/opt/apigee/bin/apigee-service management-server restart
关于使用配置文件
以下命令将配置文件作为输入。例如,您可以将配置文件传递给 setup-org 命令,以定义组织的所有属性,包括环境和虚拟主机。
如需查看完整的配置文件以及可在配置文件中设置的属性的相关信息,请参阅为组织设置新用户。
关于设置虚拟主机
Edge 上的虚拟主机定义了公开 API 代理的网域和 Edge Router 端口,以及按扩展名,应用用于访问 API 代理的网址。虚拟主机还定义了是使用 HTTP 协议还是使用加密 HTTPS 协议访问 API 代理。
使用下面显示的脚本和 API 调用创建虚拟主机。创建虚拟主机时,您必须指定以下信息:
- 您在 API 代理中用于引用该主机的虚拟主机的名称。
- 路由器上虚拟主机的端口。通常,这些端口从 9001 开始,每个新虚拟主机都会递增 1。
- 虚拟主机的主机别名。通常是虚拟主机的 DNS 名称。
边缘路由器会将传入请求的主机标头与主机别名列表进行比较,以确定处理请求的 API 代理。通过虚拟主机发出请求时,请指定与虚拟主机的主机别名匹配的域名,或者指定路由器的 IP 地址和包含主机别名的“Host”标头。
例如,如果您在端口 9001 上创建了一个主机别名为 myapis.apigee.net 的虚拟主机,则通过该虚拟主机向 API 发出的 c网址 请求可以使用以下形式之一:
- 如果您有 myapis.apigee.net 的 DNS 条目:
curl http://myapis.apigee.net:9001/{proxy-base-path}/{resource-path} - 如果您没有 myapis.apigee.net 的 DNS 条目:
curl http://<routerIP>:9001/{proxy-base-path}/{resource-path} -H 'Host: myapis.apigee.net'
在第二种表单中,您需要指定路由器的 IP 地址,并在主机标头中传递主机别名。
注意:curl 命令、大多数浏览器和许多其他实用程序都会自动将网域附加到 Host 标头中,作为请求的一部分,因此您实际上可以使用以下格式的 curl 命令:
curl http://<routerIP>:9001/{proxy-base-path}/{resource-path}
没有虚拟主机的 DNS 条目时的选项
如果您没有 DNS 条目,可以将主机别名设置为路由器的 IP 地址和虚拟主机的端口,格式为 <routerIP>:port。例如:
192.168.1.31:9001
当您使用以下形式的 curl 命令时:
curl http://<routerIP>:9001/{proxy-base-path}/{resource-path}
此选项是首选,因为它与 Edge 界面配合得很好。
如果您有多个路由器,请为每个路由器添加一个主机别名,并指定每个路由器的 IP 地址和虚拟主机的端口。
或者,您也可以将主机别名设置为某个值,例如 temp.hostalias.com。然后,您必须在每次请求中传递 host 标头:
curl -v http://<routerIP>:9001/{proxy-base-path}/{resource-path} -H 'Host: temp.hostalias.com'
或者,将主机别名添加到您的 /etc/hosts 文件中。例如,将下面这行内容添加到 /etc/hosts:
192.168.1.31 temp.hostalias.com
然后,您可以像有 DNS 条目一样发出请求:
curl -v http://myapis.apigee.net:9001/{proxy-base-path}/{resource-path}