组织和环境维护

本部分介绍各种管理操作,例如,在安装私有云的 Apigee Edge 中创建、管理和移除 Apigee 组织、环境和虚拟主机。

有关组织、环境和虚拟主机的介绍,请参阅关于星球、区域、Pod、组织、环境和虚拟主机

检查用户、组织和环境的状态

在将所有其他组件封装到边缘私有云的本地安装中,管理服务器发挥着至关重要的作用。您可以通过发出以下 curl 命令检查管理服务器上的用户、组织和部署状态:

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 状态。如果这些失败,请执行以下操作:

  1. 检查位于 /opt/apigee/var/log/apigee/management-server 的管理服务器日志是否存在任何错误。
  2. 对 Management Server 进行调用,以检查其是否正常运行。
  3. 从 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 地址和包含主机别名的主机标头。

例如,如果您在端口 9001 上创建了一个主机别名为 myapis.apigee.net 的虚拟主机,则通过该虚拟主机向 API 执行 curl 请求可以使用以下某种格式:

  • 如果您有 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 地址,并在主机标头中传递主机别名。

没有虚拟主机的 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