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

# 使用本機部署測試 AWS IoT Greengrass 元件
<a name="test-components"></a>

如果您在核心裝置上開發 Greengrass 元件，您可以建立本機部署來安裝和測試它。遵循本節中的步驟來建立本機部署。

如果您在不同的電腦上開發元件，例如本機開發電腦，則無法建立本機部署。相反地，請將元件發佈至 AWS IoT Greengrass 服務，以便您可以將其部署至 Greengrass 核心裝置進行測試。如需詳細資訊，請參閱 [發佈元件以部署到您的核心裝置](publish-components.md) 和 [將 AWS IoT Greengrass 元件部署至裝置](manage-deployments.md)。

**在 Greengrass 核心裝置上測試元件**

1. 核心裝置會記錄事件，例如元件更新。您可以檢視此日誌檔案，以探索元件的錯誤並進行故障診斷，例如無效的配方。此日誌檔案也會顯示您的元件列印到標準輸出 (stdout) 的訊息。建議您在核心裝置上開啟額外的終端機工作階段，以即時觀察新的日誌訊息。開啟新的終端機工作階段，例如透過 SSH，並執行下列命令來檢視日誌。`/greengrass/v2` 將 取代為 AWS IoT Greengrass 根資料夾的路徑。

------
#### [ Linux or Unix ]

   ```
   sudo tail -f /greengrass/v2/logs/greengrass.log
   ```

------
#### [ PowerShell ]

   ```
   gc C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
   ```

------

   您也可以檢視元件的日誌檔案。

------
#### [ Linux or Unix ]

   ```
   sudo tail -f /greengrass/v2/logs/com.example.HelloWorld.log
   ```

------
#### [ PowerShell ]

   ```
   gc C:\greengrass\v2\logs\com.example.HelloWorld.log -Tail 10 -Wait
   ```

------

1. 在原始終端機工作階段中，執行下列命令以使用 元件更新核心裝置。`/greengrass/v2` 將 取代為 AWS IoT Greengrass 根資料夾的路徑，並將 *\$1/greengrassv2* 取代為本機開發資料夾的路徑。

------
#### [ Linux or Unix ]

   ```
   sudo /greengrass/v2/bin/greengrass-cli deployment create \
     --recipeDir ~/greengrassv2/recipes \
     --artifactDir ~/greengrassv2/artifacts \
     --merge "com.example.HelloWorld=1.0.0"
   ```

------
#### [ Windows Command Prompt (CMD) ]

   ```
   C:\greengrass\v2\bin\greengrass-cli deployment create ^
     --recipeDir %USERPROFILE%\greengrassv2\recipes ^
     --artifactDir %USERPROFILE%\greengrassv2\artifacts ^
     --merge "com.example.HelloWorld=1.0.0"
   ```

------
#### [ PowerShell ]

   ```
   C:\greengrass\v2\bin\greengrass-cli deployment create `
     --recipeDir ~/greengrassv2/recipes `
     --artifactDir ~/greengrassv2/artifacts `
     --merge "com.example.HelloWorld=1.0.0"
   ```

------
**注意**  
您也可以使用 `greengrass-cli deployment create`命令來設定元件組態參數的值。如需詳細資訊，請參閱[建立](gg-cli-deployment.md#deployment-create)。

1. 使用 `greengrass-cli deployment status`命令來監控元件部署的進度。

------
#### [ Unix or Linux ]

   ```
   sudo /greengrass/v2/bin/greengrass-cli deployment status \
     -i deployment-id
   ```

------
#### [ Windows Command Prompt (CMD) ]

   ```
   C:\greengrass\v2\bin\greengrass-cli deployment status ^
     -i deployment-id
   ```

------
#### [ PowerShell ]

   ```
   C:\greengrass\v2\bin\greengrass-cli deployment status `
     -i deployment-id
   ```

------

1. 在 Greengrass 核心裝置上執行元件時進行測試。當您完成此版本的元件時，您可以將其上傳至 AWS IoT Greengrass 服務。然後，您可以將元件部署到其他核心裝置。如需詳細資訊，請參閱[發佈元件以部署到您的核心裝置](publish-components.md)。