向组织添加徽章

如需载入组织，您必须创建载入配置文件，然后将其传递给 setup-org 命令。以下部分介绍了这些步骤。

如需了解如何使用 Management API 载入组织，请参阅 创建组织、 环境和虚拟主机。

创建载入配置文件

本部分包含一个示例配置文件，用于使用 setup-org 载入组织。

复制以下示例，并根据需要进行修改以适应您的组织：

# Specify the IP or DNS name of the Management Server.
IP1=MANAGEMENT_SERVER_IP_ADDRESS

MSIP="$IP1"

# Specify the Edge sys admin credentials.
ADMIN_EMAIL="admin@email.com"
APIGEE_ADMINPW=admin_password  # If omitted, you are prompted for it.

# Specify organization name.
ORG_NAME=myorg  # lowercase only, no spaces, underscores, or periods.

# Specify the organization administrator user.
# Either specify an existing user, or specify the information
# necessary to create a new user.
# Do not use the sys admin as the organization administrator.
#
# Create a new user for the organization administrator.
NEW_USER="y"
# New user information if NEW_USER="y".
USER_NAME=new@user.com
FIRST_NAME=new
LAST_NAME=user
# Org admin password must be at least 8 characters long and contain one uppercase
# letter, one lowercase letter, and one digit or special character
USER_PWD="newUserPword"
ORG_ADMIN=new@user.com
#
# Or, specify an existing user as the organization admin,
# omit USER_NAME, FIRST_NAME, LAST_NAME, USER_PWD.
# NEW_USER="n"
# ORG_ADMIN=existing@user.com

# Specify environment name.
ENV_NAME=prod  # lowercase only

# Specify virtual host information.
VHOST_PORT=9001
VHOST_NAME=default

# If you have a DNS entry for the virtual host.
VHOST_ALIAS=myorg-test.apigee.net

# If you do not have a DNS entry for the virtual host,
# specify the IP and port of each router as a space-separated list:
# VHOST_ALIAS="firstRouterIP:9001 secondRouterIP:9001"

# Optionally configure TLS/SSL for virtual host.
# VHOST_SSL=y     # Set to "y" to enable TLS/SSL on the virtual host.
# KEYSTORE_JAR=   # JAR file containing the cert and private key.
# KEYSTORE_NAME=  # Name of the keystore.
# KEYSTORE_ALIAS= # The key alias.
# KEY_PASSWORD=   # The key password, if it has one.

# Specify the analytics group.
# AXGROUP=axgroup-001 # Default name is axgroup-001.

请注意：

  • 对于 VHOST_ALIAS，如果您 已有用于访问虚拟主机的 DNS 记录，请指定主机 别名，并可选择指定端口，例如“myapi.example.com”。如果您还没有 DNS 记录，可以使用路由器的 IP 地址。

    如需详细了解如何配置虚拟主机，请参阅设置 虚拟主机。

  • 如需了解 TLS/SSL 配置，请参阅 密钥库和 信任库以及为私有云配置对 API 的 TLS 访问权限，详细了解如何创建 JAR 文件 以及配置 TLS/SSL 的其他方面。
  • 如需详细了解如何配置虚拟主机，请参阅为私有云配置对 API 的 TLS 访问权限。
  • 您无法创建两个同名的组织。在这种情况下，第二次创建将会 失败。

执行 setup-org

创建载入配置文件后，您需要将其传递给 setup-org 脚本以执行载入流程。您必须在管理服务器 节点上运行该脚本。

载入组织时，setup-org 脚本会执行以下操作：

  • 创建新组织。
  • 创建环境。
  • 为环境创建虚拟主机。
  • 将指定用户设置为组织管理员。请注意：
    • 您可以为组织管理员使用现有用户或创建新用户。
    • 组织管理员不得 与系统管理员相同。
  • 将组织与“网关”Pod 相关联。（这是默认设置，无法更改 。）
  • 将环境与所有消息处理器相关联。
  • 启用分析功能。

如需执行 setup-org，请执行以下操作：

  1. 在管理服务器节点上安装 apigee-provision： 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision install
  2. 在管理服务器节点上运行 setup-org 脚本，并将其指向您在 Create an onboarding configuration file 中创建的配置文件：
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

    配置文件必须可供“apigee”用户读取。

  3. 验证您是否已成功载入组织。一种方法是在浏览器中请求以下网址，以登录 New Edge 界面：
    http://IP_address:3001

    其中 IP_address 是您安装 New Edge 界面的服务器的 IP 地址。

    如需了解其他验证步骤，请参阅验证载入。

  4. 创建您的第一个代理！

验证载入

载入完成后，在管理服务器节点上发出以下 curl 命令，验证系统状态：

  1. 执行以下命令，检查管理服务器上的用户和组织状态： 
    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/org_name/deployments
  2. 执行以下命令，检查分析功能： 
    curl -u adminEmail:admin_password http://localhost:8080/v1/organizations/org_name/environments/env_name/provisioning/axstatus
  3. 执行以下命令，检查节点 2 （如安装拓扑所示）上的 PostgreSQL 数据库状态： 
    psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee

    在命令提示符处，输入以下命令以查看您的 组织分析表：

    \d analytics."org_name.env_name.fact"

    使用以下命令退出 psql：

    \q
  4. 使用网络浏览器访问 New Edge 界面。请注意，您已在安装结束时记下 管理控制台网址。
    1. 启动您偏好的浏览器，然后输入 New Edge 界面的网址。该网址类似于以下网址，其中 IP 地址是节点 1（如安装拓扑所示）的 IP 地址，或者您为替代配置安装 New Edge 界面的任何节点的 IP 地址：
      http://192.168.56.111:3001

      3001 是 New Edge 界面使用的默认端口号。

      如果您直接在托管 New Edge 界面的服务器上启动浏览器，则可以使用以下形式的网址： 

      http://localhost:3001
    2. 在控制台登录页面上，指定 Apigee 系统管理员用户名/密码。
  5. 注册新的 Apigee 用户账号，并使用新的用户凭据登录。在 控制台登录页面上，点击登录 按钮。

    浏览器会重定向到 http://192.168.56.111:3001/edge 并打开一个信息中心，您可以在其中配置您创建的组织（如果您使用 Apigee 管理员凭据登录）。

创建您的第一个代理

载入新组织并验证载入过程是否 成功后，您现在可以创建您的第一个代理。如需了解详情，请参阅构建第一个 API 代理。

您可能会发现以下其他资源很有用：