Edge for Private Cloud v. 4.17.05
典型的 Edge 安装由分布在多个节点上的 Edge 组件组成。在节点上安装 Edge 后,您还要在该节点上安装和配置一个或多个 Edge 组件。
安装流程
在节点上安装 Edge 的过程涉及多个步骤:
- 在节点上停用 SELinux 或将其设置为宽容模式。如需了解详情,请参阅安装 Edge apigee-setup 实用程序。
- 决定是否要启用 Cassandra 身份验证。
- 决定是否要为 Postgres 设置主备用模式。
- 从推荐的拓扑列表中选择边缘配置。例如,您可以在单个节点上安装 Edge 进行测试,或者在 13 个节点上安装正式版。如需了解详情,请参阅安装拓扑。
- 在所选拓扑中的每个节点上,安装 Edge apigee-setup 实用程序:
- 将 Edge bootstrap_4.17.05.sh 文件下载到 /tmp/bootstrap_4.17.05.sh。
- 安装 Edge apigee-service 实用程序和依赖项。
- 安装 Edge apigee-setup 实用程序和依赖项。
如需了解详情,请参阅安装 Edge apigee-setup 实用程序。
- 根据您选择的拓扑,使用 apigee-setup 实用程序在每个节点上安装一个或多个 Edge 组件。
请参阅在节点上的在节点上安装 Edge 组件。 - 在管理服务器节点上,使用 apigee-setup 实用程序安装 apigee-provision(您在创建和管理 Edge 组织时使用的实用程序)。
请参阅与组织建立合作关系了解详情。
谁可以执行安装
Apigee Edge 分发文件以一组 RPM 和依赖项的形式安装。如需安装、卸载和更新 Edge 每千次展示收入,该命令必须由 root 用户或具有完全 sudo 访问权限的用户运行。对于完整的 sudo 访问权限,这意味着用户具有 sudo 访问权限,以执行与 root 相同的操作。
想要运行以下命令或脚本的任何用户必须是 root 用户或拥有完全 sudo 访问权限的用户:
-
apigee-service 实用程序:
- apigee-service 命令:安装、卸载、更新。
- apigee-all 命令:安装、卸载、更新。
- setup.sh 脚本以安装 Edge 组件(除非您已使用“apigee-service install” 来安装所需的 RPM。然后,请根据需要授予 root 权限或完全 sudo 访问权限。)
- update.sh 脚本以更新 Edge 组件
此外,Edge 安装程序会在您的系统中创建一个名为“apigee”的新用户。许多 Edge 命令都会调用 sudo,以“apigee”用户的身份运行。
想要运行上述命令以外的所有其他命令的用户必须是对“apigee”用户具有完全 sudo 访问权限的用户。这些命令包括:
-
apigee-service 实用命令,包括:
- apigee-service 命令,例如 start、stop、 restart、configure。
- apigee-all 命令,例如 start、stop、 restart、configure。
创建对“apigee”用户具有完全 sudo 访问权限的用户
如需将用户设置为对“apigee”用户具有完整的 sudo 访问权限,请使用“visudo”命令修改 sudoers 文件以进行添加:
installUser ALL=(apigee) NOPASSWD: ALL
其中,installUser 是边缘用户的用户名。
设置配置文件权限
“Edge”用户可以访问 Edge 命令所用的任何文件或资源。其中包括 Edge 许可文件和所有配置文件。
创建配置文件时,您可以将其所有者更改为“apigee:apigee”,以确保可以使用 Edge 命令访问该文件:
- 在编辑器中以任何用户身份创建该文件。
- 将该文件的所有者更改为“apigee:apigee”,或者,如果您将运行 Edge 服务的用户从“apigee”用户更改为 该帐号,则将该文件归为运行 Edge 服务的用户。
将 root 安装任务与 root 用户和非根用户分开
虽然最简单的方式是以 root 身份执行或具有完全 sudo 访问权限的用户执行整个 Edge 安装过程,但并不总是这样。相反,您可以将进程拆分为由 root 执行的任务,以及由对“apigee”用户拥有完全 sudo 访问权限的用户执行的任务。
- 按根执行的任务:
- 。
- 如上所述,配置用户拥有对“apigee”用户的完整 sudo 访问权限。
- 安装 apigee-setup 实用程序:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install - 使用 apigee-setup 实用程序在节点上安装边缘 RPM:
> /opt/apigee/apigee-service/bin/apigee-service compName 安装
您在节点上安装的边缘 RPM 取决于您的拓扑。可用组件列表包括:apigee-provision、apigee-validate、apigee-zookeeper、apigee-cassandra、apigee-openldap、edge-ui、edge-management-server、edge-ui、edge-router、edge-message-processor、apigee-postgresql、apigee-qpidd、edge-postgres-server、edge-qpid-server。
- 。
-
根用户在节点上安装边缘 RPM 后,对“apigee”用户具有完全 sudo 访问权限的用户将完成配置过程:
- 使用 setup.sh 实用程序在节点上完成 Edge 组件的配置。该命令形式取决于您在节点上安装的组件。如需查看完整列表,请参阅在节点上安装 Edge 组件。
例如,如需完成 ZooKeeper 和 Cassandra 的安装,请使用以下命令:
> /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
其中 configFile 是 Edge 配置文件。
或者,若要执行多合一安装,请使用以下命令:
> /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile
- 使用 setup.sh 实用程序在节点上完成 Edge 组件的配置。该命令形式取决于您在节点上安装的组件。如需查看完整列表,请参阅在节点上安装 Edge 组件。
安装配置文件的位置
您必须将配置文件传递给 apigee-setup 实用程序,其中包含有关 Edge 安装的信息。关于静默安装的唯一要求是,配置文件必须可供“apigee”用户访问或读取。例如,将该文件放在节点上的 /usr/local/var 或 /usr/local/share 目录中,并将它们读成“apigee:apigee”。
除了 Edge 系统管理员的密码之外,配置文件中所有其他信息都需要填写。如果您省略了密码,apigee-setup 实用程序会提示您在命令行中输入该密码。
如需了解详情,请参阅在节点上安装 Edge 组件。
处理安装失败问题
如果在边缘组件安装过程中失败,您可以尝试更正问题,然后重新运行安装程序。安装程序会在检测到故障时运行,或者以后您想要在安装后更改或更新组件时运行。
互联网或非互联网安装
要在节点上安装 Edge,节点必须能够访问 Apigee 代码库:
- 具有外部互联网连接的节点
具有外部互联网连接的节点会访问 Apigee 代码库,以安装边缘 RPM 和依赖项。 - 没有外部互联网连接的节点
没有外部互联网连接的节点可以访问您在内部设置的镜像版本的 Apigee 代码库。此代码库包含所有边缘每千次展示收入,但您必须确保内部网络上存储库具有所有其他依赖项。
若要创建内部 Apigee 代码库,您需要具有外部互联网访问权限的节点,才能下载边缘 RPM 和依赖项。创建内部代码库后,您可以将其移动到另一个节点,或者让该节点可供 Edge 节点访问以进行安装。
使用本地 Edge 代码库来维护 Edge 版本
如上一部分所述,使用本地或镜像代码库的一个原因是,在没有外部互联网连接的节点上安装 Edge。
但是,使用本地代码库还有另一个好处,即使对于外部互联网连接的节点也是如此。从 Apigee 公共代码库安装 Edge 时,始终安装最新的 Edge 每千次展示收入。因此,如果您要下载并存储特定版本的 Edge 的每千次展示收入,则应为该 Edge 版本创建一个本地代码库。然后,您可以使用该本地代码库为任何版本的 Edge 执行安装。
例如,您首先使用本地代码库安装 Edge 开发环境。然后,当您准备好迁移至生产环境时,可从本地代码库再次安装 Edge。通过本地代码库进行安装,可以确保您的开发和生产环境保持一致。
镜像代码库非常灵活。例如,您可以从最新的 Edge RPM 或特定版本的 Edge 创建镜像代码库。创建代码库后,您还可以更新代码库,以添加来自不同 Edge 版本的每千次展示收入。如需了解详情,请参阅安装 Edge apigee-setup 实用程序。
解析 RPM 安装依赖项
Apigee Edge 分发文件安装为一组 RPM 文件,每个 RPM 文件都有自己的安装依赖项链。其中许多依赖项都是由 Apigee 控制的第三方组件定义的,并且可能会随时发生变化。因此,本文档并未列出每个依赖项的明确版本号。
如果您在具有互联网连接的机器上执行安装,节点便可以下载必要的 RPM 和依赖项。但是,如果您从没有互联网连接的节点安装,则通常设置一个内部代码库,其中包含所有必要的依赖项。确保所有依赖项都包含在本地代码库中的唯一方法是尝试安装,识别任何缺失的依赖项并将其复制到本地代码库,直到安装成功为止。
常用的 Yum 命令
适用于 Linux 的 Edge 安装工具依赖于 Yum 来安装和更新组件。您可能必须使用多个 Yum 命令来管理节点上的安装。
- 清理所有 Yum 缓存:
sudo yum clean all - 如需更新 Edge 组件,请执行以下操作:
sudo yum update componentName
例如:
sudo yum update apigee-setup
sudo yum update edge-management-server
文件系统结构
Edge 会将所有文件安装到 /opt/apigee 目录中。
在本指南和 Edge 操作指南中,根安装目录记下为:
/opt/apigee
安装过程使用以下文件系统结构来部署适用于私有云的 Apigee Edge。
日志文件
apigee-setup 和 setup.sh 脚本的日志文件写入 /tmp/setup-root.log。
每个组件的日志文件都包含在 /opt/apigee/var/log 目录中。每个组件都有自己的子目录。例如,Management Server 的日志位于以下目录中:
/opt/apigee/var/log/edge-management-server
下表列出了日志文件的位置:
组件 |
位置信息 |
---|---|
管理服务器 |
/opt/apigee/var/log/edge-management-server |
路由器 |
/opt/apigee/var/log/edge-router 边缘路由器是使用 Nginx 实现的。如需查看其他日志,请参阅: /opt/apigee/var/log/edge-router/nginx /opt/nginx/logs |
消息处理器 |
/opt/apigee/var/log/edge-message-processor |
Apigee Qpid 服务器 |
/opt/apigee/var/log/edge-qpid-server |
Apigee Postgres 服务器 |
/opt/apigee/var/log/edge-postgres-server |
边缘界面 |
/opt/apigee/var/log/edge-ui |
ZooKeeper |
/opt/apigee/var/log/apigee-zookeeper |
OpenLDAP |
/opt/apigee/var/log/apigee-openldap |
Cassandra |
/opt/apigee/var/log/apigee-cassandra |
Qpidd 语 |
/opt/apigee/var/log/apigee-qpidd |
PostgreSQL 数据库 |
/opt/apigee/var/log/apigee-postgresql |
数据
组件 |
位置信息 |
---|---|
管理服务器 |
/opt/apigee/data/edge-management-server |
路由器 |
/opt/apigee/data/edge-router |
消息处理器 |
/opt/apigee/data/edge-message-processor |
Apigee Qpid 代理 |
/opt/apigee/data/edge-qpid-server |
Apigee Postgres 代理 |
/opt/apigee/data/edge-postgres-server |
ZooKeeper |
/opt/apigee/data/apigee-zookeeper |
OpenLDAP |
/opt/apigee/data/apigee-openldap |
Cassandra |
/opt/apigee/data/apigee-cassandra/data |
Qpidd 语 |
/opt/apigee/data/apigee-qpid/data |
PostgreSQL 数据库 |
/opt/apigee/data/apigee-postgres/pgdata |
安装后任务
安装完成后,您可以对 Edge 组件执行其他操作。
在安装后配置 Edge 组件
如需在安装后配置 Edge,您可以结合使用 .properties 文件与 Edge 实用程序。例如,如需在边缘界面上配置 TLS/SSL,请修改 .properties 文件以设置必要的属性。如需更改 .properties 文件,您需要重启受影响的 Edge 组件。
.properties 文件位于 /opt/apigee/customer/application 目录中。每个组件在该目录中都有自己的 .properties 文件。例如,router.properties 和 management-server.properties。
如要为组件设置属性,请修改相应的 .properties 文件,然后重启该组件:
> /opt/apigee/apigee-service/bin/apigee-service component restart
例如:
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
在您更新 Edge 时,系统会读取 /opt/apigee/customer/application 目录中的 .properties 文件。这意味着更新会保留您在该组件上设置的所有属性。
如需详细了解 Edge 配置,请参阅如何配置 Edge。
在 Edge 组件上调用命令
Edge 安装管理实用程序位于 /opt/apigee/apigee-service/bin 下,该实用程序可用于管理 Edge 安装。例如,您可以使用 apigee-all 实用程序来启动、停止、重启节点或确定节点上所有 Edge 组件的状态:
/opt/apigee/apigee-service/bin/apigee-all stop|start|restart|status|version
请使用 apigee-service 实用程序来控制和配置各个组件。apigee-service 实用程序的形式如下:
/opt/apigee/apigee-service/bin/apigee-service component action
例如,如需重启边缘路由器,请运行以下命令:
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
您可以通过检查 /opt/apigee 目录来确定节点上安装的组件列表。该目录包含安装在节点上的每个 Edge 组件的子目录。每个子目录都带有前缀:
- apigee - Edge 使用的第三方组件。例如 apigee-cassandra。
- edge - 来自 Apigee 的 Edge 组件。例如 edge-management-server。
- edge-mint - 创收组件。例如 edge-mint-management-server。
- baas - API BaaS 组件。例如 baas-usergrid。
组件的完整操作列表取决于组件本身,但所有组件都支持以下操作:
- 开始、停止、重启
- 状态、版本
- 备份、恢复
- 安装、卸载