组织和环境维护

Edge for Private Cloud v. 4.16.05

本部分介绍了各种管理操作，例如在 Apigee Edge for Private Cloud 安装中创建、管理和移除 Apigee 组织、环境和虚拟主机。

如需了解组织、环境和虚拟主机，请参阅关于行星、区域、Pod、组织、环境和虚拟主机。

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

在 Edge 私有云的本地安装中，管理服务器在将所有其他组件整合在一起方面发挥着至关重要的作用。您可以通过发出以下 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. 检查 <inst_root>/apigee/var/log/apigee/management-server 中的管理服务器日志，看看是否有任何错误。
  2. 对管理服务器进行调用，以检查其是否正常运行。
  3. 从 ELB 中移除服务器，然后重启管理服务器：
    /<inst_root>/apigee/bin/apigee-service management-server restart

关于使用配置文件

下面显示的命令将配置文件作为输入。例如，您将配置文件传递给 setup-org 命令，以定义组织的所有属性，包括环境和虚拟主机。

如需查看完整的配置文件以及可在配置文件中设置的属性的相关信息，请参阅为组织进行初始配置。

关于设置虚拟主机

Edge 上的虚拟主机定义了公开 API 代理的网域和 Edge 路由器端口，以及应用用于访问 API 代理的网址。虚拟主机还定义了是通过 HTTP 协议还是通过加密的 HTTPS 协议访问 API 代理。

使用下面显示的脚本和 API 调用创建虚拟主机。创建虚拟主机时，您必须指定以下信息：

  • 虚拟主机的名称，用于在 API 代理中引用该虚拟主机。
  • 虚拟主机的路由器上的端口。通常，这些端口从 9001 开始，每个新虚拟主机递增 1。
  • 虚拟主机的主机别名。通常是虚拟主机的 DNS 名称。

    Edge 路由器会将传入请求的 Host 标头与主机别名列表进行比较，以确定处理请求的 API 代理。通过虚拟主机发出请求时，请指定与虚拟主机的主机别名匹配的域名，或指定路由器的 IP 地址和包含主机别名的 Host 标头。

例如，如果您在端口 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 地址，并在 Host 标头中传递主机别名。

    注意：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}