本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# SiteWise Edge 閘道上的合作夥伴資料來源
<a name="partner-data-sources"></a>

使用 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. 前往合作夥伴的 Web 入口網站，如適用，並設定合作夥伴資料來源，使其連線至 SiteWise Edge 閘道。

**Topics**
+ [

## 安全
](#cpa-security)
+ [

# 在 SiteWise Edge 閘道Docker上設定
](cpa-install-docker.md)
+ [

# 在 SiteWise Edge 中新增合作夥伴資料來源
](cpa-add-source.md)
+ [

# SiteWise Edge 閘道合作夥伴資料來源選項
](connect-partner-data-source.md)

## 安全
<a name="cpa-security"></a>

作為 AWS我們客戶和合作夥伴之間[共同責任模型](https://aws.amazon.com/compliance/shared-responsibility-model/)的一部分，以下說明誰負責不同的安全層面：

**客戶責任**  
+ 審核合作夥伴。
+ 設定提供給合作夥伴的網路存取權。
+ 監控 SiteWise Edge 閘道機器資源 (CPU、記憶體和檔案系統） 的合理使用情況。

**AWS 責任**  
+ 將合作夥伴與客戶 AWS 雲端資源隔離，但合作夥伴所需的資源除外。在此情況下，即為 AWS IoT SiteWise 擷取。
+ 將合作夥伴解決方案限制為合理使用 SiteWise Edge 閘道機器資源 (CPU 和記憶體）。

**合作夥伴責任**  
+ 使用安全預設值。
+ 透過修補程式和其他適當的更新，在一段時間內保護解決方案的安全。
+ 將客戶資料保密。

# 在 SiteWise Edge 閘道Docker上設定
<a name="cpa-install-docker"></a>

AWS IoT SiteWise 提供的Docker映像可讓您在各種平台和環境中執行 SiteWise Edge 應用程式。此Docker映像會封裝從工業設備收集、處理和傳送資料至 AWS 雲端所需的所有必要元件和相依性。透過使用 Docker 映像，您可以在 Docker 相容主機上部署和執行 SiteWise Edge 應用程式，例如伺服器、邊緣裝置或雲端容器服務。

若要新增合作夥伴資料來源，您的本機裝置上必須安裝 [Docker 引擎](https://docs.docker.com/engine/) 1.9.1 或更新版本。

**注意**  
20.10 版是經過驗證可與 SiteWise Edge 閘道軟體搭配使用的最新版本。

## 確認Docker已安裝
<a name="cpa-install-docker-verify"></a>

若要驗證Docker是否已安裝，請從連線至 SiteWise Edge 閘道的終端機執行下列命令：

```
docker info
```

如果命令傳回`docker is not recognized`結果，或已安裝較舊版本的 Docker ，請在繼續之前[安裝 Docker 引擎](https://docs.docker.com/engine/install/)。

## 設定 Docker
<a name="cpa-install-docker-setup"></a>

執行Docker容器元件的系統使用者必須具有根或管理員許可，或者您必須Docker將 設定為以非根或非管理員使用者身分執行。

在 Linux 裝置上，您必須將`ggc_user`使用者新增至 `docker`群組，才能在沒有 的情況下呼叫Docker命令`sudo`。

若要將 `ggc_user`或您用來執行Docker容器元件的非根使用者新增至 `docker`群組，請執行下列命令：

```
sudo usermod -aG docker ggc_user
```

如需詳細資訊，請參閱 [Docker引擎的 Linux 安裝後步驟](https://docs.docker.com/engine/install/linux-postinstall/)。

# 在 SiteWise Edge 中新增合作夥伴資料來源
<a name="cpa-add-source"></a>

若要將合作夥伴資料來源連線至 SiteWise Edge 閘道，請將其新增為資料來源。當您將其新增為資料來源時， AWS IoT SiteWise 會將私有 AWS IoT Greengrass 元件部署到您的 SiteWise Edge 閘道。

## 先決條件
<a name="cpa-add-prereqs"></a>

若要新增合作夥伴資料來源，您必須執行下列動作：
+ 對於 EasyEdge和 CloudRail，與合作夥伴建立帳戶，然後繫結帳戶。
+ [在 SiteWise Edge 閘道Docker上設定](cpa-install-docker.md)

## 使用合作夥伴資料來源建立 SiteWise Edge 閘道
<a name="cpa-add-create-gateway"></a>

如果您想要建立新的 SiteWise Edge 閘道，請完成 中的步驟[建立自我託管 SiteWise Edge 閘道](create-gateway-ggv2.md)。建立 SiteWise Edge 閘道之後，請依照中的步驟[將合作夥伴資料來源新增至現有的 SiteWise Edge 閘道](#cpa-existing-gateway)新增合作夥伴資料來源。

## 將合作夥伴資料來源新增至現有的 SiteWise Edge 閘道
<a name="cpa-existing-gateway"></a>

1. 導覽至 [AWS IoT SiteWise 主控台](https://console.aws.amazon.com/iotsitewise/)。

1. 在左側導覽中，選擇 **Edge 區段中的 Edge 閘道**。 ****

1. 選擇您要連接合作夥伴資料來源的 SiteWise Edge 閘道。

1. 在**資料來源**下，選擇**新增資料來源**。

1. 在**新增資料來源**畫面上，選擇**來源類型**，以選取連接 SiteWise Edge 閘道的合作夥伴。每個資料來源都有自己的組態選項。資料來源有兩種類別： AWS 來源和合作夥伴來源。

   使用合作夥伴資料來源，您可以為每個閘道選擇一個來源。如需資料來源合作夥伴整合選項的清單，請參閱 [SiteWise Edge 閘道合作夥伴資料來源選項](connect-partner-data-source.md)。請注意，您最多可以新增 100 個 OPC UA 資料來源 (AWS 來源）。若要開始使用 OPC UA 資料來源，請參閱 [AWS IoT SiteWise Edge 閘道的 OPC UA 資料來源](configure-sources-opcua.md)。

1. 輸入來源的名稱。

1. 選取下方的資料來源標籤，然後遵循組態程序。

------
#### [ CloudRail ]

   在儲存 SiteWise Edge 閘道的資料來源CloudRail之後，入口網站中會完成大部分的CloudRail組態。不過，需要授權連線。

**注意**  
CloudRail 連線僅適用於 Linux。

   1. [建立 CloudRail帳戶](https://devices.cloudrail.com/signup)以開始使用 連線 AWS IoT SiteWise。

   1. 確定 Docker 已安裝在您的閘道上。如需詳細資訊，請參閱[在 SiteWise Edge 閘道Docker上設定](cpa-install-docker.md)。

   1. 閱讀**授權存取和部署**協議，然後選擇**授權**。勾選方塊會授予 AWS 合作夥伴存取您資料來源的權限 AWS ，並允許 在合作夥伴的元件上部署 。

**注意**  
**測量字首 - *選用***是在CloudRail入口網站中設定。

**注意**  
合作夥伴軟體是由 AWS 合作夥伴開發、維護和支援。 AWS 不負責介面、組態或軟體。

   如需詳細資訊，請參閱[CloudRail](connect-partner-data-source.md#cp-cloudrail)。

------
#### [ EasyEdge ]

   大部分EasyEdge組態會在儲存 SiteWise Edge 閘道的資料來源後，在EasyEdge入口網站中完成。不過，需要授權連線。

**注意**  
EasyEdge 連線僅適用於 Linux。

   1. [建立 EasyEdge帳戶](https://accounts.easyedge.io/signup?partner=aws)以開始使用 連線 AWS IoT SiteWise。

   1. 確定 Docker 已安裝在您的閘道上。如需詳細資訊，請參閱[在 SiteWise Edge 閘道Docker上設定](cpa-install-docker.md)。

   1. 閱讀**授權存取和部署**協議，然後選擇**授權**。勾選方塊會授予 AWS 合作夥伴存取您資料來源的權限 AWS ，並允許 在合作夥伴的元件上部署 。

**注意**  
**測量字首 - *選用***是在EasyEdge入口網站內設定。

**注意**  
合作夥伴軟體是由 AWS 合作夥伴開發、維護和支援。 AWS 不負責介面、組態或軟體。

   如需詳細資訊，請參閱[EasyEdge](connect-partner-data-source.md#cp-easyedge)。

------
#### [ Litmus Edge ]

   您可以透過兩種方式啟用Litmus組態。使用Litmus Edge Manager入口網站的資訊Litmus Edge直接透過 AWS IoT SiteWise 啟用 。或者，您可以透過 手動啟用 Litmus Edge 的 AWS IoT SiteWise Litmus Edge Manager。

**注意**  
Litmus Edge 連線僅適用於 Linux。

    

**在 上使用啟用碼Litmus Edge啟用 AWS IoT SiteWise**

   在 新增具有Litmus Edge啟用碼的Litmus Edge資料來源時，請使用此程序 AWS IoT SiteWise 主控台。

   1. 選取**立即使用程式碼啟用**。其他組態選項隨即出現。

   1. 輸入 Litmus Edge Manager 以Litmus Edge連線至 SiteWise Edge 閘道。如需詳細資訊，請參閱 Litmus Edge Manager 文件中的[步驟 3a：設定資料和裝置管理端點](https://docs.litmus.io/edgemanager/quickstart-guide/activate-an-edge-device/step-3-activation-request)。

   1. 提供要在 Litmus Edge上啟用的Litmus Edge Manager啟用碼 AWS IoT SiteWise

   1. 或者， AWS IoT SiteWise 提供 **Litmus Edge Manager CA 憑證**。憑證Litmus Edge可防止 在未經授權的 上啟用 Litmus Edge Manager。

   1. 確定 Docker 已安裝在您的閘道上。如需詳細資訊，請參閱[在 SiteWise Edge 閘道Docker上設定](cpa-install-docker.md)。
**注意**  
AWS IoT SiteWise 會將合作夥伴應用程式部署為 Docker 容器。應用程式使用 `NET_ADMIN`功能部署，以便透過 管理 Litmus Edge Docker 容器Litmus Edge Manager。 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 已安裝在您的閘道上。如需詳細資訊，請參閱[在 SiteWise Edge 閘道Docker上設定](cpa-install-docker.md)。
**注意**  
AWS IoT SiteWise 會將合作夥伴應用程式部署為 Docker 容器。應用程式使用 `NET_ADMIN`功能部署，以便透過 管理 Litmus Edge Docker 容器Litmus Edge Manager。 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* 文件中的[存取 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 Edge 閘道合作夥伴資料來源選項
<a name="connect-partner-data-source"></a>

AWS IoT SiteWise 可讓您從各種合作夥伴資料來源連接和擷取資料，例如工業設備、感應器和其他第三方系統。若要連接合作夥伴資料來源，您需要遵循幾個步驟，包括設定資料來源以傳送資料 AWS IoT SiteWise、設定必要的許可和身分驗證，以及將資料映射到您的資產模型。此程序可確保合作夥伴資料無縫整合至您的 AWS IoT SiteWise 環境，讓您與其他資料來源一起監控和分析。

本節列出 SiteWise Edge 閘道上第三方資料來源整合的可用合作夥伴。使用以下資訊來設定合作夥伴資料來源。

**注意**  
您可以為每個閘道中的每個合作夥伴新增一個資料來源

## CloudRail
<a name="cp-cloudrail"></a>

**入口網站：**  
[https://devices.cloudrail.com/](https://devices.cloudrail.com/)

**需求**  
如需CloudRail需求的詳細資訊，請參閱 CloudRail 網站上的[常見問答集](https://cloudrail.com/faqs/)。

**CloudRail 文件：**  
[邊緣運算：SiteWise Edge](https://devices.cloudrail.com/documentation?service=AWSIoTSitewiseEdge#awsiotsitewiseEdge1)

## EasyEdge
<a name="cp-easyedge"></a>

**入口網站：**  
[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
<a name="cp-litmus"></a>

**存取 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/)