组织和环境维护

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

如需了解组织、环境和虚拟主机的简介，请参阅星球、区域、Pod、组织、环境和虚拟主机简介。

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

在 Edge Private Cloud 的本地安装中，管理服务器在将所有其他组件整合在一起方面发挥着至关重要的作用。您可以在管理服务器上通过发出以下 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. 针对管理服务器发出调用，以检查其是否正常运行。
3. 从 ELB 中移除服务器，然后重启管理服务器：

   /opt/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 标头。

如果您有虚拟主机的 DNS 条目

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

curl http://myapis.apigee.net: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