配置Edge Server - 预览

先决条件

每个Edge Server实例都连接到Atlas项目中的一项服务。 在使用Edge Server实例之前，必须创建相关服务，并为Edge Server实例配置身份验证提供程序和权限。

有关详细信息，请参阅为Edge Server创建服务。

边缘服务器主机要求

运行Edge Server实例的主机可以是 EC2 实例或其他云服务器，或者是您现场预配的硬件。

安装和配置Edge Server实例

创建Edge Server服务或Device Sync服务后，必须创建Edge Server实例。 每个服务可能有许多Edge Server实例。 创建Edge Server实例时，您会获得一个安装脚本，该脚本可用于下载用于安装和管理Edge Server实例 edgectl 的工具。 您还会获得一个可用于注册Edge Server实例的令牌。 有关详细信息，请参阅创建Edge Server实例。

使用安装脚本在主机上设置并运行Edge Server实例。

curl -s https://services.cloud.mongodb.com/edge/install.sh | bash

edgectl init --app-id="<INSERT-YOUR-APP-ID-HERE>" --platform=compose

edgectl config --insecure-disable-auth=true

启动和停止边缘服务器

使用 edgectl 启动和停止Edge Server实例。

要启动所有Edge Server实例容器，请使用 start 命令：

edgectl start

要停止所有Edge Server实例容器，请使用 stop 命令：

edgectl stop

检查边缘服务器状态

当Edge Server实例正在运行时，您可以使用以下命令查看实例的状态：

edgectl status

这将为您提供有关Edge Server容器状态的信息，以及同步服务器的详细状态以及重要信息的细分。 它可能看起来类似于以下内容：

{
   "mongoContainerStatus": {
      "message": "running"
   },
   "mongoDBStatus": {
      "message": "ready"
   },
   "syncServerContainerStatus": {
      "message": "running"
   },
   "syncServerStatus": {
      "message": "ACTIVE"
   },
   "syncServerDetailedStatus": {
      "version": "v0.22.3",
      "status": "ACTIVE",
      "cloud_connected": true,
      "num_local_clients": 0,
      "query": {
         "Item": "truepredicate"
      }
   }
}

syncServerDetailedStatus 包含有关Edge Server实例状态的信息。 这包括有关与 Atlas 的连接以及连接的客户端的详细信息，如下所示：

更新Edge Server实例配置

您可以使用 edgectl 对现有Edge Server实例进行更改。 更改配置后，重新启动实例以应用更新。

edgectl config --YOUR-FLAG-HERE

edgectl stop

edgectl start

升级边缘服务器版本

随着Edge Server的发展，您可能需要升级Edge Server版本以利用新功能。 此外， Edge Server实例的主要版本不得比最新可用版本晚一个以上，否则将进入 FAILED 状态并且无法连接到Atlas 。

edgectl update

edgectl config

edgectl start

edgectl clean

edgectl start

edgectl prune

循环使用Edge Server API密钥

要循环使用Edge Server API密钥，请执行以下操作：

edgectl config --update-registration-token=true

指定Edge Server的查询

如果未指定查询，则Edge Server实例默认为 "*" 的全局查询，这会自动同步链接的数据源中所有集合中的所有数据。

您可以在 edgectl config 命令中使用一些参数来指定Edge Server实例同步查询：

• 传递一个简单的string查询：

  edgectl config --query="Store: store_id == 42"

• 传递多个查询标志以提供多个集合的查询：

  edgectl config --query="Person: age > 10" --query "Pet: type = 'cat'"

• 将路径传递到包含映射更复杂查询的 JSON 对象的文件：

  edgectl config --query-file="/Users/my.user/edge-server/query.json"

• 传递全局查询以对所有集合使用相同的查询：

  edgectl config --global-query="shouldSync == true"

除非使用全局查询，否则Edge Server查询采用 YOUR-SCHEMA-TITLE: YOUR-QUERY 的形式：

• YOUR-SCHEMA-TITLE：模式的title字段，通常与数据库中集合的名称匹配。 如果不同数据库中存在两个同名的集合，我们会在集合名称前加上数据库名称；例如， databaseName_collectionName 。

  链接的 Atlas 数据源可能包含许多集合，每个集合都有一个匹配的模式。 如果不使用默认的Edge Server查询 "*" 或同步所有内容的全局查询，则要同步的每个模式都必须有自己的查询。

  如果您使用的是模板应用，则为Item集合。

• YOUR-QUERY：该查询确定Edge Server可以与集合同步哪些文档。 您可以使用RQL来定义此查询，并对Flexible Sync RQL限制使用相同的注意事项。

edgectl config --global-query="truepredicate"

edgectl config --global-query="store_id == 42"

edgectl config --query="Inventory: store_id == 42"

edgectl config --query="Project: facility_id == 42" --query "Item: priority >= 3"

edgectl config --query-file="/Users/my.user/edge-server/query.json"

{
  "Project": "facility_id == 42",
  "Item": "priority >= 3"
}

模拟离线连接

Edge Server提供了一个演示模式，您可以使用它来模拟与Edge Server 失去连接的Atlas 实例。当Edge Server 实例处于离线演示模式时，您可以使用CRUD MongoDB驱动程序或工具或 应用程序继续对实例执行Atlas Device SDK 操作。

您可以使用连接到Edge Server实例的客户端在本地查看数据更改，但看不到Atlas中反映的更改。 同样，当 实例处于离线状态时，您在Atlas Edge Server中所做的更改不会同步到Edge Server 并反映在本地客户端上。

当您将Edge Server实例退出离线演示模式时，它会自动恢复与Atlas同步。 您可以看到Edge Server 中反映了Atlas 实例的数据，并且Atlas 中更改的数据对该实例和连接的客户端可见。

edgectl config --insecure-enable-offline-demo

edgectl offline-demo disable-connection

edgectl offline-demo enable-connection

在主机上运行多个Edge Server实例

在开发Edge Server架构时，您可能希望在单个主机（例如本地计算机）上运行多个Edge Server实例。 您可以使用edgectl配置文件功能来执行此操作。

创建Edge Server实例时，edgectl 会自动为您创建默认配置文件。 该配置文件将命令映射到特定的Edge Server实例。

在同一计算机上创建新的Edge Server实例时，edgectl 会将新配置文件设置为默认配置文件。 要发出使用默认配置文件以外的配置文件的命令，请为每个命令添加--profile标志。

edgectl start --profile=YOUR-PROFILE-NAME

您可以在以下位置查看配置文件及其关联的配置文件：

~/.mongodb-edge/profiles/

edgectl init --app-id="YOUR-APP-ID" --platform=compose --profile=YOUR-PROFILE-NAME

edgectl profile list

edgectl profile inspect YOUR-PROFILE-NAME

{
  "appId" : "YOUR-APP-ID",
  "platform" : "compose"
}

edgectl profile set-default YOUR-PROFILE-NAME

edgectl profile delete YOUR-PROFILE-NAME