Edge for Private Cloud v. 4.17.01
使用 setup-org 命令执行初始配置流程。您必须在 Management Server 节点上运行该命令。
在初始配置过程中,脚本会:
- 创建组织。
- 将指定用户设置为组织管理员。
- 此用户不得为系统管理员用户。也就是说,请勿将系统管理员用户用作组织管理员用户。
- 您可以为组织管理员指定现有用户,也可以配置脚本以创建新用户。
- 将组织与 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 记录,则可以使用路由器的 IP 地址。
如需详细了解如何配置虚拟主机,请参阅 Edge 演示安装要求。 - 如需了解 TLS/SSL 配置,请参阅密钥库和信任库以及为私有云配置对 API 的 TLS 访问,详细了解如何创建 JAR 文件以及配置 TLS/SSL 的其他方面。
新手入门流程
- 在管理服务器节点上安装 apigee-provision:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision install - 在管理服务器节点上运行命令:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org configFile
配置文件必须可供“apigee”用户访问或读取。
新手入门验证
完成初始配置后,通过在 Management Server 节点上发出以下 C网址 命令来验证系统的状态。
- 通过发出以下 C网址 命令来检查管理服务器上的用户和组织状态:
> curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/users
> curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations/organizations<单位名称><organization0/organizations><organization>. - 如果您启用了分析,请使用以下命令:
> curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations/<orgname>/environments/<envname>/provision/axstatus - 您也可以在机器 2 上运行以下命令,以检查 PostgreSQL 数据库状态以启动 psql:
> psql -h /opt/apigee/var/apigee-postgresql -U apigee apigee
在命令提示符处输入以下命令来查看组织的分析表:
apigee=# : \dname> analytics.
- 使用网络浏览器访问 Apigee Edge 界面。请记住,您已经在安装结束时记下了管理控制台网址。
- 启动首选浏览器并输入 Edge 界面的网址。如下所示,其中 IP 地址用于机器 1 或您安装了该界面的任何机器以进行备用配置:
http://192.168.56.111:9000/login
9000 是界面使用的端口号。如果您要直接在托管 Edge 界面的服务器上启动浏览器,可以使用采用以下格式的网址:
http://localhost:9000/login
注意:请确保端口 9000 已打开。 - 在控制台登录页面上,指定 Apigee 系统管理员用户名/密码。
注意:这是您在安装期间设置的全局系统管理员密码。或者,您也可以:
- 启动首选浏览器并输入 Edge 界面的网址。如下所示,其中 IP 地址用于机器 1 或您安装了该界面的任何机器以进行备用配置:
- 注册新的 Apigee 用户帐号,并使用新用户凭据登录。
- 点击“登录”后,浏览器会重定向到:
http://192.168.56.111:9000/platform/#/<orgname>/
并打开一个信息中心,您可以在其中配置之前创建的组织(如果使用 Apigee 管理员凭据登录)。 - 如果您刚开始接触 Edge,现在可以创建您的第一个 API 代理。如需了解详情,请参阅构建您的第一个 API 代理。
另请参阅示例部分(包括示例列表),以及 Mock Target API 页面,了解您可以在自己的 API 构建实验中使用的模拟目标 RESTful API。
- 点击“登录”后,浏览器会重定向到: