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

# 使用 AWS AppConfig 客服人員本機開發模式
<a name="appconfig-agent-how-to-use-local-development"></a>

AWS AppConfig 代理程式支援*本機開發模式*。如果您啟用本機開發模式，代理程式會從磁碟上的指定目錄讀取組態資料。它不會從中擷取組態資料 AWS AppConfig。您可以透過更新指定目錄中的檔案來模擬組態部署。針對下列使用案例，我們建議使用本機開發模式：
+ 使用 部署不同的組態版本之前，請先進行測試 AWS AppConfig。
+ 在將變更遞交至程式碼儲存庫之前，請測試新功能的不同組態選項。
+ 測試不同的組態案例，以驗證它們是否如預期般運作。

**警告**  
請勿在生產環境中使用本機開發模式。此模式不支援重要的 AWS AppConfig 安全功能，例如部署驗證和自動復原。

使用下列程序來設定本機開發模式的 AWS AppConfig 代理程式。

**為本機開發模式設定 AWS AppConfig 代理程式**

1. 使用運算環境所述的方法安裝代理程式。 AWS AppConfig 代理程式適用於下列項目 AWS 服務：
   + [AWS Lambda](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-integration-lambda-extensions.html)
   + [Amazon EC2](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-integration-ec2.html)
   + [Amazon ECS 和 Amazon EKS](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-integration-containers-agent.html)

1. 如果代理程式正在執行，請將其停止。

1. 將 `LOCAL_DEVELOPMENT_DIRECTORY`新增至環境變數清單。在 檔案系統上指定目錄，為代理程式提供讀取許可。例如 `/tmp/local_configs`。

1. 在 目錄中建立 檔案。檔案名稱必須使用下列格式：

   ```
   {{application_name}}:{{environment_name}}:{{configuration_profile_name}}
   ```

   請見此處範例：

   ```
   Mobile:Development:EnableMobilePaymentsFeatureFlagConfiguration
   ```
**注意**  
若要檢視您可以新增至`LOCAL_DEVELOPMENT_DIRECTORY`目錄中檔案的功能標記範例，請參閱 [AWS AppConfig 客服人員本機開發模式的功能旗標範例](appconfig-agent-how-to-use-local-development-samples.md)。
（選用） 您可以根據您提供的副檔名，控制代理程式針對組態資料傳回的內容類型。例如，如果您使用 .json 副檔名命名檔案，代理程式會在應用程式請求檔案`application/json`時傳回 的內容類型。如果您省略 延伸模組，代理程式會`application/octet-stream`針對內容類型使用 。如果您需要精確控制，您可以提供 格式的 延伸`.{{type}}%{{subtype}}`。代理程式會傳回 的內容類型`.type/subtype`。

1. 執行下列命令以重新啟動代理程式並請求組態資料。

   ```
   curl http://localhost:2772/applications/{{application_name}}/environments/{{environment_name}}/configurations/{{configuration_name}}
   ```

代理程式會根據為代理程式指定的輪詢間隔檢查本機檔案的變更。如果未指定輪詢間隔，代理程式會使用預設間隔 45 秒。此輪詢間隔檢查可確保代理程式在本機開發環境中的行為與設定為與服務互動時的行為相同 AWS AppConfig 。

**注意**  
若要部署本機開發組態檔案的新版本，請使用新資料更新檔案。