边缘安装概览

适用于私有云的 Edge v. 4.17.05

典型的 Edge 安装由分布在多个节点中的 Edge 组件组成。 在节点上安装 Edge 后，可以在节点上安装并配置一个或多个 Edge 组件 节点。

安装流程

在节点上安装 Edge 的过程分为多个步骤：

  • 在节点上停用 SELinux 或将其设置为宽容模式。如需了解更多详情，请参阅安装 Edge apigee-setup 实用程序。 。
  • 决定是否要启用 Cassandra 身份验证。
  • 决定是否要为 Postgres 设置主备用复制。
  • 从推荐拓扑列表中选择 Edge 配置。例如，您可以在单个节点上安装 Edge 以进行测试，也可以在 13 个节点上安装 Edge 以用于生产环境。如需了解详情，请参阅安装拓扑。
  • 在所选拓扑中的每个节点上，安装 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 RPM，必须由 root 用户或具有完整 sudo 访问权限的用户运行相应命令。对于完整的 sudo 访问权限，这意味着用户有权执行 sudo 与 root 相同的操作。

任何想要运行以下命令或脚本的用户都必须是 root 或用户 具有完整的 sudo 访问权限：

  • apigee-service 实用程序：
    • apigee-service 命令：install、 uninstall、update。
    • apigee-all 命令：install、Uninstall、update。
  • setup.sh 脚本来安装 Edge 组件（除非您已使用 “apigee-service install”更改为 安装所需的每千次展示收入如果不需要，则获取 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 命令使用的所有文件或资源都必须对“apigee”用户可访问。这个 包括 Edge 许可文件和所有配置文件。

创建配置文件时，您可以将其所有者更改为“apigee:apigee”以确保 可以通过 Edge 命令访问它：

  1. 以任何用户身份在编辑器中创建该文件。
  2. 对文件所有者执行“apigee:apigee”或者，如果您更改了运行 “apigee”运行的则对运行 Edge 的用户执行 chown 操作 服务。

分隔 根用户和非根用户之间的边缘安装任务

虽然以根用户或 具有完整的 sudo 访问权限，这并非总是可行。相反，您可以将 进程转换为由 root 执行的任务，以及由具有 对“apigee”的完整 sudo 访问权限用户。

  1. root 执行的任务：
    1. 下载并运行 bootstrap_4.17.05.sh 文件：
      >curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
      >sudo bash /tmp/bootstrap_4.17.05.sh apigeeuser=uName apigeepassword=pWord

      此步骤将安装 apigee-service 实用程序，并创建 “apigee”用户。
    2. 配置用户，使其对“apigee”拥有完整的 sudo 访问权限用户（如描述） 。
    3. 安装 apigee-setup 实用程序：
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup 安装
    4. 使用 apigee-setup 实用程序进行安装 节点上的边缘 RPM：
      > /opt/apigee/apigee-service/bin/apigee-service compName 安装

      您在节点上安装的 Edge 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。
  2. 根用户在节点上安装 Edge RPM 后，拥有对“apigee”用户的完整 sudo 访问权限的用户会完成配置流程：
    1. 使用 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

安装配置的位置 文件

您必须向 apigee-setup 实用程序传递一个配置文件，其中包含 Edge 安装相关信息。静默安装的唯一要求是 配置文件必须可供“apigee”访问或读取用户。例如，将文件 在 /usr/local/var 中或 /usr/local/share 目录 并将其 chown 为“apigee:apigee”。

配置文件中的所有信息都是必需的，但 Edge 系统管理员的密码除外。如果您省略密码，apigee-setup 实用程序会提示您输入密码 。

如需了解更多详情，请参阅在节点上安装 Edge 组件 。

处理安装失败问题

如果 Edge 组件安装失败，您可以尝试更正 问题，然后再次运行安装程序。安装程序旨在在检测到失败或您日后想在安装后更改或更新组件时重复运行。

通过互联网或非互联网安装

如需在节点上安装 Edge，该节点必须能够访问 Apigee 代码库：

  • 具有外部互联网连接的节点

    具有外部互联网连接的节点访问 Apigee 代码库以安装 Edge RPM 和依赖项。
  • 没有外部互联网连接的节点

    没有外部互联网连接的节点可以访问 Apigee 的镜像版本 内部设置的代码库此代码库包含所有 Edge RPM，但您必须 确保您拥有内部代码库提供的所有其他依赖项 。

    要创建内部 Apigee 代码库，您确实需要一个具有外部互联网的节点 以便下载 Edge RPM 和依赖项。创建 你可以将其移至其他节点，或将该节点设为可供边缘访问 节点进行安装。

使用本地 Edge 代码库 维护您的 Edge 版本

使用本地代码库（即镜像代码库）的原因之一是在节点上安装 Edge 没有外部互联网连接（如上一部分中所述）。

不过，使用本地代码库的另一个好处是，即使对于具有外部代码库的节点， 或互联网连接。从 Apigee 公共代码库安装 Edge 时，您始终会安装最新的 Edge RPM。因此，如果您要下载并存储 则您应为该 Edge 版本创建一个本地代码库。然后，您可以使用该本地代码库为任何版本的 Edge 执行安装。

例如，您首先使用本地代码库安装 Edge 开发环境。然后， 准备好迁移到生产环境时，您需要从本地的 代码库。通过从本地代码库进行安装，您可以保证 环境一致

镜像代码库非常灵活。例如，您可以从 最新的 Edge RPM 或特定版本的 Edge。创建代码库后，您还可以更新该代码库，以添加不同 Edge 版本的 RPM。如需了解更多详情，请参阅安装 Edge apigee-setup 实用程序。 。

解析 RPM 安装依赖项

Apigee Edge 发行版文件作为一组 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 Cloud 的最新动态和提示。

日志文件

apigee-setup 的日志文件 setup.sh 脚本是 写入 /tmp/setup-root.log。

每个组件的日志文件都包含在 /opt/apigee/var/log 目录中。每个组件 都有自己的子目录例如，管理服务器的日志位于 目录：

/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

Edge 界面

/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 实用程序。例如，如需在 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 - 第三方 组件。例如 apigee-cassandra。
  • edge - Apigee 中的 Edge 组件。例如，edge-management-server。
  • edge-mint - 变现服务 组件。例如 edge-mint-management-server。
  • baas - API BaaS 组件。例如 baas-usergrid。

组件操作的完整列表取决于组件本身，但所有 组件支持以下操作：

  • 启动、停止、重启
  • 状态、版本
  • 备份、恢复
  • 安装、卸载