本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# SiteWise 边缘网关上的合作伙伴数据源
使用 AWS IoT SiteWise Edge 网关时，您可以将合作伙伴数据源连接到您的 SiteWise Edge 网关，并在您的 SiteWise Edge 网关和 AWS 云中接收来自合作伙伴的数据。这些合作伙伴数据源是与合作伙伴合作开发 AWS 的 AWS IoT Greengrass 组件。添加合作伙伴数据源时， AWS IoT SiteWise 将创建此组件并将其部署到您的 SiteWise Edge 网关上。
**注意**
您可以在每个网关中为每个合作伙伴添加一个数据源。
要添加合作伙伴数据来源，请执行以下操作：
1. [在 SiteWise Edge 中添加合作伙伴数据源](cpa-add-source.md)
1. 转到合作伙伴的门户网站（如果适用），然后配置合作伙伴数据源，使其连接到 SiteWise Edge 网关。
**Topics**
+ [安全性](#cpa-security)
+ [Docker在您的 SiteWise Edge 网关上进行设置](cpa-install-docker.md)
+ [在 SiteWise Edge 中添加合作伙伴数据源](cpa-add-source.md)
+ [SiteWise 边缘网关合作伙伴数据源选项](connect-partner-data-source.md)
## 安全性
作为我们的客户和合作伙伴之间[AWS责任共担模式](https://aws.amazon.com/compliance/shared-responsibility-model/)的一部分，以下内容描述了谁对安全的不同方面负责：
**客户责任**
+ 审查合作伙伴。
+ 配置授予合作伙伴的网络访问权限。
+ 监控 E SiteWise dge 网关计算机资源（CPU、内存和文件系统）的合理使用情况。
**AWS 责任**
+ 将合作伙伴与客户 AWS 云资源隔离开来，但合作伙伴需要的云资源除外。在本例中为 AWS IoT SiteWise 摄取。
+ 将合作伙伴解决方案限制为合理使用 SiteWise 边缘网关计算机资源（CPU 和内存）。
**合作伙伴的责任**
+ 使用安全的默认值。
+ 通过补丁和其他适当更新确保解决方案随着时间的推移而保持安全。
+ 对客户数据保密。
# Docker在您的 SiteWise Edge 网关上进行设置
AWS IoT SiteWise 提供了一个允许您在各种平台和环境中运行 SiteWise Edge 应用程序的Docker映像。此Docker图像概括了从您的工业设备收集、处理数据并将其发送到云端所需的所有必要组件和依赖关系。 AWS 通过使用 Docker 镜像，您可以在兼容 Docker 的主机（例如服务器、 SiteWise 边缘设备或基于云的容器服务）上部署和运行 Edge 应用程序。
要添加合作伙伴数据来源，必须在本地设备上安装 [Docker Engine](https://docs.docker.com/engine/) 1.9.1 或更高版本。
**注意**
版本 20.10 是经验证可与 SiteWise Edge 网关软件配合使用的最新版本。
## 验证Docker是否已安装
要验证Docker是否已安装，请在连接到 SiteWise Edge 网关的终端上运行以下命令：
```
docker info
```
如果命令返回`docker is not recognized`结果，或者安装了旧版本Docker的，请先[安装 Docker Engin](https://docs.docker.com/engine/install/) e，然后再继续。
## 设置 Docker
运行Docker容器组件的系统用户必须具有 root 或管理员权限，或者您必须将其配置Docker为以非 root 用户或非管理员用户身份运行。
在 Linux 设备上，必须向`docker`组中添加一个`ggc_user`用户才能调用Docker命令`sudo`。
要将或用于运行Docker容器组件的非 root 用户添加到`ggc_user``docker`组中，请运行以下命令：
```
sudo usermod -aG docker ggc_user
```
有关更多信息，请参阅[Docker引擎的 Linux 安装后步骤。](https://docs.docker.com/engine/install/linux-postinstall/)
# 在 SiteWise Edge 中添加合作伙伴数据源
要将合作伙伴数据源连接到您的 SiteWise Edge 网关，请将其添加为数据源。当您将其添加为数据源时， AWS IoT SiteWise 会将私有 AWS IoT Greengrass 组件部署到您的 SiteWise Edge 网关。
## 先决条件
要添加合作伙伴数据来源，您必须执行以下操作：
+ 对于 EasyEdge 和 CloudRail，在合作伙伴处创建一个账户，然后绑定账户。
+ [Docker在您的 SiteWise Edge 网关上进行设置](cpa-install-docker.md)
## 使用合作伙伴数据源创建 SiteWise Edge 网关
如果要创建新的 SiteWise Edge 网关，请完成中的步骤[创建自托管 SiteWise Edge 网关](create-gateway-ggv2.md)。创建 SiteWise Edge 网关后，[将合作伙伴数据源添加到现有 SiteWise Edge 网关](#cpa-existing-gateway)按照中的步骤添加合作伙伴数据源。
## 将合作伙伴数据源添加到现有 SiteWise Edge 网关
1. 导航至 [AWS IoT SiteWise 控制台](https://console.aws.amazon.com/iotsitewise/)。
1. 在左侧导航栏中，选择 **Edge 部分的 **Edge** 网关**。
1. 选择要将合作伙伴数据源连接到的 SiteWise Edge 网关。
1. 对于**数据来源**，选择**添加数据来源**。
1. 在**添加数据源**屏幕上，选择**源类型**，选择连接您的 SiteWise Edge 网关的合作伙伴。每个数据来源都有自己的配置选项。数据来源分为两类： AWS 来源和合作伙伴来源。
使用合作伙伴数据来源，您可以为每个网关选择一个来源。有关数据来源合作伙伴集成选项的列表，请参阅 [SiteWise 边缘网关合作伙伴数据源选项](connect-partner-data-source.md)。请注意，您最多可以添加 100 个 OPC UA 数据源（AWS 源）。要开始使用 OPC UA 数据来源，请参阅[AWS IoT SiteWise 边缘网关的 OPC UA 数据源](configure-sources-opcua.md)。
1. 输入源名称。
1. 在下面选择您的数据来源的选项卡，然后按照配置过程进行操作。
------
#### [ CloudRail ]
保存 SiteWise 边缘网关的数据源后，大部分CloudRail配置都是在CloudRail门户中完成的。但是，需要对连接进行授权。
**注意**
CloudRail 连接仅在 Linux 上可用。
1. [创建一个 CloudRail 账户](https://devices.cloudrail.com/signup)，以便开始连接 AWS IoT SiteWise。
1. 确保您的网关上已安装 Docker。有关更多信息，请参阅 [Docker在您的 SiteWise Edge 网关上进行设置](cpa-install-docker.md)。
1. 阅读**授权访问和部署**协议，然后选择**授权**。选中该复选框将授予 AWS 合作伙伴访问您的数据源的权限，并 AWS 允许在合作伙伴的组件上进行部署。
**注意**
**测量前缀 - *可选***在您的 CloudRail 门户中设置。
**注意**
合作伙伴软件由 AWS 合作伙伴开发、维护和支持。 AWS 对接口、配置或软件概不负责。
有关更多信息，请参阅 [CloudRail](connect-partner-data-source.md#cp-cloudrail)。
------
#### [ EasyEdge ]
保存 SiteWise 边缘网关的数据源后，大部分EasyEdge配置都是在EasyEdge门户中完成的。但是，需要对连接进行授权。
**注意**
EasyEdge 连接仅在 Linux 上可用。
1. [创建一个 EasyEdge 账户](https://accounts.easyedge.io/signup?partner=aws)，以便开始连接 AWS IoT SiteWise。
1. 确保您的网关上已安装 Docker。有关更多信息，请参阅 [Docker在您的 SiteWise Edge 网关上进行设置](cpa-install-docker.md)。
1. 阅读**授权访问和部署**协议，然后选择**授权**。选中该复选框将授予 AWS 合作伙伴访问您的数据源的权限，并 AWS 允许在合作伙伴的组件上进行部署。
**注意**
**测量前缀 - *可选***在您的 EasyEdge 门户中设置。
**注意**
合作伙伴软件由 AWS 合作伙伴开发、维护和支持。 AWS 对接口、配置或软件概不负责。
有关更多信息，请参阅 [EasyEdge](connect-partner-data-source.md#cp-easyedge)。
------
#### [ Litmus Edge ]
您可以通过两种方式激活 Litmus 配置。使用 Litmus Edge Manager 门户上的信息通过 AWS IoT SiteWise 直接激活 Litmus Edge。或者，您可以通过 Litmus Edge Manager 手动激活适用于 AWS IoT SiteWise 的 Litmus Edge。
**注意**
Litmus Edge 连接仅在 Linux 上可用。
**要使用激Litmus Edge活码激活 AWS IoT SiteWise**
在 AWS IoT SiteWise 控制台上添加带有 Litmus Edge 激活码的 Litmus Edge 数据来源时，请按照此过程操作。
1. 选择**立即使用代码激活**。其他配置选项即会出现。
1. 输入Litmus Edge Manager以Litmus Edge连接到您的 SiteWise Edge 网关。有关更多信息，请参阅 Litmus Edge Manager 文档中的 [Step 3a: Set Data and Device Management Endpoint](https://docs.litmus.io/edgemanager/quickstart-guide/activate-an-edge-device/step-3-activation-request)。
1. 提供要Litmus Edge Manager激活的激活Litmus Edge码 AWS IoT SiteWise
1. （可选）提供 AWS IoT SiteWise C **Litmus Edge ManagerA 证书**。该证书可防止在未经授权的 Litmus Edge Manager 上激活 Litmus Edge。
1. 确保您的网关上已安装 Docker。有关更多信息，请参阅 [Docker在您的 SiteWise Edge 网关上进行设置](cpa-install-docker.md)。
**注意**
AWS IoT SiteWise 将合作伙伴应用程序部署为 Docker 容器。该应用程序已部署 `NET_ADMIN` 权限，便于通过 Litmus Edge Manager 管理 Litmus Edge Docker 容器。Litmus Edge 需要此特权访问才能在您的设备上运行。有关 Litmus Edge Docker 要求的更多信息，请参阅 Litmus Edge 文档*QuickStart 指南*中的 [Docker 安装](https://docs.litmus.io/litmusedge-v1/quickstart-guide/installation-and-deployments/docker-installation)。
1. 阅读**授权访问和部署**协议，然后选择**授权**。选中该复选框将授予 AWS 合作伙伴访问您的数据源的权限，并 AWS 允许在合作伙伴的组件上进行部署。
**要通过 Litmus Edge 手动激活，请执行以下步骤：**
1. 选择**稍后在 Litmus Edge 上激活**。
1. 确保您的网关上已安装 Docker。有关更多信息，请参阅 [Docker在您的 SiteWise Edge 网关上进行设置](cpa-install-docker.md)。
**注意**
AWS IoT SiteWise 将合作伙伴应用程序部署为 Docker 容器。该应用程序已部署 `NET_ADMIN` 权限，便于通过 Litmus Edge Manager 管理 Litmus Edge Docker 容器。Litmus Edge 需要此特权访问才能在您的设备上运行。有关 Litmus Edge Docker 要求的更多信息，请参阅 Litmus Edge 文档*QuickStart 指南*中的 [Docker 安装](https://docs.litmus.io/litmusedge-v1/quickstart-guide/installation-and-deployments/docker-installation)。
1. 阅读**授权访问和部署**协议，然后选择**授权**。选中该复选框将授予 AWS 合作伙伴访问您的数据源的权限，并 AWS 允许在合作伙伴的组件上进行部署。
1. 部署完成后，请按照 Litmus Edge《QuickStart Guide》**文档中的 [Access the Litmus Edge Web UI](https://docs.litmus.io/litmusedge/quickstart-guide/access-the-litmus-edge-web-ui) 说明进行操作。
**注意**
合作伙伴软件由 AWS 合作伙伴开发、维护和支持。 AWS 对接口、配置或软件概不负责。
有关更多信息，请参阅 [Litmus Edge](connect-partner-data-source.md#cp-litmus)。
------
1. 选择 **Save**。
# SiteWise 边缘网关合作伙伴数据源选项
AWS IoT SiteWise 允许您连接和摄取来自各种合作伙伴数据源的数据，例如工业设备、传感器和其他第三方系统。要连接合作伙伴数据源，您需要执行几个步骤，包括配置要向其发送数据的数据源 AWS IoT SiteWise、设置必要的权限和身份验证，以及将数据映射到您的资产模型。此过程可确保您的合作伙伴数据无缝集成到您的 AWS IoT SiteWise 环境中，从而使您能够同时对其和其他数据来源进行监控和分析。
本部分列出了在 SiteWise Edge 网关上进行第三方数据源集成的可用合作伙伴。使用以下信息配置合作伙伴数据来源。
**注意**
您可以在每个网关中为每个合作伙伴添加一个数据源
## CloudRail
**门户：**
[https://devices.cloudrail.com/](https://devices.cloudrail.com/)
**要求**
有关 CloudRail 要求的更多信息，请参阅 CloudRail 网站上的 [FAQS](https://cloudrail.com/faqs/)。
**CloudRail 文档：**
[边缘计算： SiteWise 边缘](https://devices.cloudrail.com/documentation?service=AWSIoTSitewiseEdge#awsiotsitewiseEdge1)
## EasyEdge
**门户：**
[https://studio.easyedge.io/](https://studio.easyedge.io/)
**要求**
[EasyEdge 要求](https://docs.easyedge.io/getting-started/requirements.html) - 有关 EasyEdge 要求的信息，包括配置防火墙所需的端点和端口。**注意**：您需要一个 EasyEdge 账户才能访问此文档。
**EasyEdge 文档：**
[EasyEdge对于 AWS](https://www.easyedge.io/easyedge-for-aws/)
## Litmus Edge
**对 Litmus Edge Manager 的访问权限：**
要访问 Litmus Edge，请设置一个 [Litmus Edge Manager 账户](https://docs.litmus.io/edgemanager/quickstart-guide/access-to-litmus-edge-manager)。
**要求**
[Litmus Edge 要求](https://docs.litmus.io/litmusedge/quickstart-guide/system-requirements) - 部署 Litmus Edge 的推荐配置和系统要求。
**Litmus 文档：**
+ [集成到 AWS IoT SiteWise](https://docs.litmus.io/litmusedge-v1/litmusedge-with-aws-iot-sitewise)
+ [Litmus Edge 文档](https://docs.litmus.io/litmusedge/)