支援終止通知：2026 年 10 月 7 日 AWS 將停止 的支援 AWS IoT Greengrass Version 1。2026 年 10 月 7 日之後，您將無法再存取 AWS IoT Greengrass V1 資源。如需詳細資訊，請造訪[從 遷移 AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html)。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# AWS IoT Greengrass 在核心裝置上安裝和執行
**注意**
本教學課程提供在 Raspberry Pi 上執行 AWS IoT Greengrass 核心軟體的指示，但您可以使用任何支援的裝置。
在本節中，您會在核心裝置上設定、安裝和執行 AWS IoT Greengrass 核心軟體。
**安裝和執行 AWS IoT Greengrass**
1. 從本指南的核心[AWS IoT Greengrass 軟體](what-is-gg.md#gg-core-download-tab)區段中，下載 AWS IoT Greengrass 核心軟體安裝套件。選擇最適合您核心裝置 CPU 架構、發行版和作業系統的套件。
+ 對於 Raspberry Pi，請下載 Armv7l 架構和 Linux 作業系統的 套件。
+ 對於 Amazon EC2 執行個體，請下載 x86\$164 架構和 Linux 作業系統的 套件。
+ 對於 NVIDIA Jetson TX2，請下載 Armv8 (AArch64) 架構和 Linux 作業系統的套件。
+ 對於 Intel Atom，請下載 x86\$164 架構和 Linux 作業系統的 套件。
1. 在先前的步驟中，您下載了五個檔案到您的電腦：
+ `greengrass-OS-architecture-1.11.6.tar.gz` – 此壓縮檔案包含 AWS IoT Greengrass 核心裝置上執行的 核心軟體。
+ `certificateId-certificate.pem.crt` – 裝置憑證檔案。
+ `certificateId-public.pem.key` – 裝置憑證的公有金鑰檔案。
+ `certificateId-private.pem.key` – 裝置憑證的私有金鑰檔案。
+ `AmazonRootCA1.pem` – Amazon 根憑證授權機構 (CA) 檔案。
在此步驟中，您會將這些檔案從電腦傳輸到核心裝置。請執行下列操作：
1. 如果您不知道 Greengrass 核心裝置的 IP 地址，請在核心裝置上開啟終端機並執行下列命令。
**注意**
對於某些裝置，此命令可能不會傳回正確的 IP 地址。請參閱您的裝置文件，以擷取裝置 IP 地址。
```
hostname -I
```
1. 將這些檔案從您的電腦傳輸到核心裝置。檔案傳輸步驟會根據電腦的作業系統而有所不同。選擇您的作業系統，以取得展示如何將檔案傳輸到 Raspberry Pi 裝置的步驟。
**注意**
Raspberry Pi 的預設使用者名稱為 **pi**、預設密碼為 **raspberry**。
NVIDIA Jetson TX2 的預設使用者名稱為 **nvidia**、預設密碼為 **nvidia**。
------
#### [ Windows ]
若要將壓縮檔案從您的電腦傳輸到 Raspberry Pi 裝置，請使用工具 (像是 [WinSCP](https://winscp.net/eng/download.php)) 或 [PuTTY](https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html) **pscp** 命令。若要使用 **pscp** 命令，請在電腦開啟 [命令提示] 視窗，並執行下列動作：
```
cd path-to-downloaded-files
pscp -pw Pi-password greengrass-OS-architecture-1.11.6.tar.gz pi@IP-address:/home/pi
pscp -pw Pi-password certificateId-certificate.pem.crt pi@IP-address:/home/pi
pscp -pw Pi-password certificateId-public.pem.key pi@IP-address:/home/pi
pscp -pw Pi-password certificateId-private.pem.key pi@IP-address:/home/pi
pscp -pw Pi-password AmazonRootCA1.pem pi@IP-address:/home/pi
```
**注意**
此命令中的版本編號必須符合您的 AWS IoT Greengrass Core 軟體套件版本。
------
#### [ macOS ]
若要將壓縮檔案從您的 Mac 傳輸到 Raspberry Pi 核心裝置，請在您的電腦上開啟「終端機」視窗，並執行下列命令。*path-to-downloaded-files* 通常是 `~/Downloads`。
**注意**
您可能會收到提示，要求您輸入兩組密碼。若是跳出提示請您輸入兩組密碼，則第一組密碼為 Mac 的 `sudo` 命令密碼，第二組則為 Raspberry Pi 的密碼。
```
cd path-to-downloaded-files
scp greengrass-OS-architecture-1.11.6.tar.gz pi@IP-address:/home/pi
scp certificateId-certificate.pem.crt pi@IP-address:/home/pi
scp certificateId-public.pem.key pi@IP-address:/home/pi
scp certificateId-private.pem.key pi@IP-address:/home/pi
scp AmazonRootCA1.pem pi@IP-address:/home/pi
```
**注意**
此命令中的版本編號必須符合您的 AWS IoT Greengrass Core 軟體套件版本。
------
#### [ UNIX-like system ]
若要將壓縮檔案從您的電腦傳輸到 Raspberry Pi 核心裝置，請在您的電腦開啟 [終端機] 視窗，並執行下列命令：
```
cd path-to-downloaded-files
scp greengrass-OS-architecture-1.11.6.tar.gz pi@IP-address:/home/pi
scp certificateId-certificate.pem.crt pi@IP-address:/home/pi
scp certificateId-public.pem.key pi@IP-address:/home/pi
scp certificateId-private.pem.key pi@IP-address:/home/pi
scp AmazonRootCA1.pem pi@IP-address:/home/pi
```
**注意**
此命令中的版本編號必須符合您的 AWS IoT Greengrass Core 軟體套件版本。
------
#### [ Raspberry Pi web browser ]
如果您使用 Raspberry Pi 的 Web 瀏覽器下載壓縮檔案，檔案應該位於 Pi 的`~/Downloads`資料夾中，例如 `/home/pi/Downloads`。否則，壓縮的檔案應該位於 Pi 的`~`資料夾中，例如 `/home/pi`。
------
1. 在 Greengrass 核心裝置上，開啟終端機，然後導覽至包含 AWS IoT Greengrass Core 軟體和憑證的資料夾。將 *path-to-transferred-files* 取代為您在核心裝置上傳輸檔案的路徑。例如，在 Raspberry Pi 上執行 `cd /home/pi`。
```
cd path-to-transferred-files
```
1. 解壓縮 AWS IoT Greengrass 核心裝置上的 核心軟體。執行下列命令來解壓縮您傳輸至核心裝置的軟體封存。此命令使用 `-C /`引數，在核心裝置的根`/greengrass`資料夾中建立 資料夾。
```
sudo tar -xzvf greengrass-OS-architecture-1.11.6.tar.gz -C /
```
**注意**
此命令中的版本編號必須符合您的 AWS IoT Greengrass Core 軟體套件版本。
1. 將憑證和金鑰移至 AWS IoT Greengrass Core 軟體資料夾。執行下列命令來建立憑證的資料夾，並將憑證和金鑰移至其中。將 *path-to-transferred-files* 取代為您在核心裝置上傳輸檔案的路徑，並將 *certificateId* 取代為檔案名稱中的憑證 ID。例如，在 Raspberry Pi 上，將 *path-to-transferred-files* 取代為 **/home/pi**
```
sudo mv path-to-transferred-files/certificateId-certificate.pem.crt /greengrass/certs
sudo mv path-to-transferred-files/certificateId-public.pem.key /greengrass/certs
sudo mv path-to-transferred-files/certificateId-private.pem.key /greengrass/certs
sudo mv path-to-transferred-files/AmazonRootCA1.pem /greengrass/certs
```
1. Core AWS IoT Greengrass 軟體使用指定軟體參數的組態檔案。此組態檔案會指定憑證檔案的檔案路徑，以及要使用的 AWS 雲端 端點。在此步驟中，您會為核心建立 AWS IoT Greengrass 核心軟體組態檔案。請執行下列操作：
1. 取得核心 AWS IoT 物件的 Amazon Resource Name (ARN)。請執行下列操作：
1. 在[AWS IoT 主控台](https://console.aws.amazon.com/iot)的**管理**下，於 **Greengrass 裝置**下，選擇**群組 (V1)**。
1. 在 **Greengrass 群組**頁面上，選擇您先前建立的群組。
1. 在**概觀**下，選擇 **Greengrass 核心**。
1. 在核心詳細資訊頁面上，複製**AWS IoT 物件 ARN**，並儲存它以在 AWS IoT Greengrass 核心組態檔案中使用。
1. 取得 AWS 帳戶 目前區域中 的裝置 AWS IoT 資料端點。裝置使用此端點做為 AWS AWS IoT 實物連線至 。請執行下列操作：
1. 在 [AWS IoT 主控台](https://console.aws.amazon.com/iot)中，選擇**設定**。
1. 在**裝置資料端點**下，複製**端點**並儲存以用於 AWS IoT Greengrass 核心組態檔案。
1. 建立 AWS IoT Greengrass 核心軟體組態檔案。例如，您可以執行下列命令，使用 GNU nano 建立 檔案。
```
sudo nano /greengrass/config/config.json
```
使用下列 JSON 文件取代 檔案的內容。
```
{
"coreThing" : {
"caPath": "AmazonRootCA1.pem",
"certPath": "certificateId-certificate.pem.crt",
"keyPath": "certificateId-private.pem.key",
"thingArn": "arn:aws:iot:region:account-id:thing/MyGreengrassV1Core",
"iotHost": "device-data-prefix-ats.iot.region.amazonaws.com",
"ggHost": "greengrass-ats.iot.region.amazonaws.com",
"keepAlive": 600
},
"runtime": {
"cgroup": {
"useSystemd": "yes"
}
},
"managedRespawn": false,
"crypto": {
"caPath": "file:///greengrass/certs/AmazonRootCA1.pem",
"principals": {
"SecretsManager": {
"privateKeyPath": "file:///greengrass/certs/certificateId-private.pem.key"
},
"IoTCertificate": {
"privateKeyPath": "file:///greengrass/certs/certificateId-private.pem.key",
"certificatePath": "file:///greengrass/certs/certificateId-certificate.pem.crt"
}
}
}
}
```
然後，執行下列動作：
+ 如果您下載的 Amazon 根 CA 憑證與 Amazon 根 CA 1 不同，請將 *AmazonRootCA1.pem* 的每個執行個體取代為 Amazon 根 CA 檔案的名稱。
+ 將 *certificateId* 的每個執行個體取代為憑證和金鑰檔案名稱中的憑證 ID。
+ 將 *arn：aws：iot：*region*：*account-id*：thing/MyGreengrassV1Core* 取代為您先前儲存的核心物件的 ARN。
+ 以核心物件的名稱取代 *MyGreengrassV1core*。
+ 以您稍早儲存 AWS IoT 的裝置資料端點取代 *device-data-prefix-ats.iot.region.amazonaws.com*。
+ 將*區域*取代為您的 AWS 區域。
如需您可以在此組態檔案中指定之組態選項的詳細資訊，請參閱 [AWS IoT Greengrass 核心組態檔案](gg-core.md#config-json)。
1. 確認您的核心裝置已連線到網際網路。然後， AWS IoT Greengrass 在您的核心裝置上啟動 。
```
cd /greengrass/ggc/core/
sudo ./greengrassd start
```
您應該會看到 `Greengrass successfully started` 訊息。請記下 PID。
**注意**
若要設定核心裝置在系統開機 AWS IoT Greengrass 時啟動，請參閱 [設定初始化系統，啟動 Greengrass 協助程式](gg-core.md#start-on-boot)。
您可以執行下列命令，以確認 AWS IoT Greengrass Core 軟體 (Greengrass 協助程式） 正常運作。將 *PID-number* 取代為您的 PID：
```
ps aux | grep PID-number
```
您應該會看到一個 PID 項目，包含指向執行中 Greengrass 協助程式的路徑 (例如 `/greengrass/ggc/packages/1.11.6/bin/daemon`)。如果您遇到啟動問題 AWS IoT Greengrass，請參閱 [故障診斷 AWS IoT Greengrass](gg-troubleshooting.md)。