向组织添加徽章

Edge for Private Cloud v. 4.16.09

使用 setup-org 命令执行初始配置流程。您必须在管理服务器节点上运行该命令。

在初始配置过程中,该脚本会:

  • 创建组织。
  • 将指定用户设置为组织管理员。
    • 此用户必须与系统管理员用户不同。也就是说,请勿将系统管理员用户用作组织管理员用户。
    • 您可以为组织管理员指定现有用户,也可以将脚本配置为创建新用户。
  • 将组织与 Pod 相关联,默认情况下,将其与“网关”Pod 相关联。
  • 创建环境。
  • 为环境创建虚拟主机。
  • 将环境与所有消息处理器相关联。
  • 启用分析功能。

用于初始配置的配置文件

将配置文件传递给 setup-org 命令。调用 setup-org 命令并指定 -f 选项,包括静默配置文件的路径:

> /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

静默安装的唯一要求是配置文件必须可供“apigee”用户访问或读取。

下面是一个静默配置文件示例。根据您的要求进行修改:

IP1=192.168.1.1

# Specify the IP or DNS name of the Management Server.
MSIP="$IP1"

# Specify the Edge sys admin credentials.
ADMIN_EMAIL="admin@email.com"
APIGEE_ADMINPW=adminPassword     # 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
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

# 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 记录,请参阅设置虚拟主机了解详情。
  • 对于 TLS/SSL 配置,请参阅密钥库和 truststore以及为私有云配置对 API 的 TLS 访问权限,详细了解如何创建 JAR 文件以及配置 TLS/SSL 的其他方面。

初始配置

  1. 在管理服务器节点上安装 apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision install
  2. 在管理服务器节点上运行以下命令:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

    “apigee”用户必须能够访问或读取配置文件。

入驻验证

完成初始配置后,在管理服务器节点上发出以下 CURL 命令,验证系统的状态。

  1. 通过发出以下 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
  2. 如果您启用了分析功能,请使用以下命令:
    > curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations/<orgname>/environments/<envname>/provisioning/axstatus
  3. 您还可以通过在机器 2 上运行以下命令来启动 psql,从而检查 PostgreSQL 数据库状态:
    > psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee

    在命令提示符处,输入以下命令以查看组织的分析表:
    apigee=# : \d analytics."<orgname>.prod.fact"

    使用以下命令退出 psql:
    apigee=# \q
  4. 使用网络浏览器访问 Apigee Edge 界面。请注意,您在安装结束时已经记下了管理控制台网址。
    1. 启动您的首选浏览器,然后输入 Edge 界面的网址。它类似于以下内容,其中 IP 地址是机器 1 的 IP 地址,或者是您在其中安装了界面的任何机器的 IP 地址(对于替代配置):
      http://192.168.56.111:9000/login

      9000 是界面使用的端口号。如果您直接在托管 Edge 界面的服务器上启动浏览器,则可以使用以下格式的网址:
      http://localhost:9000/login

      注意:确保端口 9000 处于打开状态。
    2. 在控制台登录页面上,指定 Apigee 系统管理员用户名/密码。
      注意:这是您在安装期间设置的全局系统管理员密码。或者,您也可以:
  5. 注册新的 Apigee 用户账号,并使用新的用户凭据登录。
    1. 点击“登录”,浏览器会重定向到:
      http://192.168.56.111:9000/platform/#/<orgname>/

      并打开一个信息中心,您可以在其中配置之前创建的组织(如果使用 Apigee 管理员凭据登录)。
    2. 如果您刚开始使用 Edge,现在可以创建您的第一个 API 代理。如需了解详情,请参阅构建第一个 API 代理。

      另请参阅有关示例的部分,包括示例列表,以及可在您自己的 API 构建实验中使用的模拟目标 RESTful API,请参阅模拟目标 API。