本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# （可选）使用环境变量为 Amazon ECS 和 Amazon EKS 配置 AWS AppConfig 代理
<a name="appconfig-integration-containers-agent-configuring"></a>

您可以通过更改 AWS AppConfig 代理容器的以下环境变量来配置代理。

**注意**  
下表包含一个**示例值**列。根据您的显示器分辨率，您可能需要滚动到表的底部，然后向右滚动才能看到该列。


****  

| 环境变量 | Details | 默认 值 | 示例值 | 
| --- | --- | --- | --- | 
| `ACCESS_TOKEN` | 此环境变量定义从代理 HTTP 服务器请求配置数据时必须提供的令牌。必须在授权类型为 `Bearer` 的 HTTP 请求授权标头中设置令牌的值。见下列。<pre>GET /applications/my_app/...<br />                  Host: localhost:2772<br />                  Authorization: Bearer <token value></pre> | 无 | MyAccessToken | 
| `BACKUP_DIRECTORY` | 此环境变量使 AWS AppConfig 代理能够将其检索到的每个配置的备份保存到指定目录中。 备份到磁盘的配置未加密。如果您的配置包含敏感数据， AWS AppConfig 建议您在文件系统权限方面采用最小权限原则。有关更多信息，请参阅 [安全性 AWS AppConfig](appconfig-security.md)。  | None（无） | /path/to/备份 | 
| `HTTP_PORT` | 此环境变量指定运行代理的 HTTP 服务器的端口。 | 2772 | 2772 | 
| `HTTP_HOST` | HTTP\_HOST 变量控制 AWS AppConfig 代理如何绑定到网络接口。绑定行为因运行时环境而异，以确保最佳的安全性和可访问性。 |  ECS，EKS [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/appconfig/latest/userguide/appconfig-integration-containers-agent-configuring.html)<br />EC2 和本地部署[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/appconfig/latest/userguide/appconfig-integration-containers-agent-configuring.html) | 自定义配置选项。您可以使用以下值覆盖默认行为：[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/appconfig/latest/userguide/appconfig-integration-containers-agent-configuring.html) | 
| `LOG_LEVEL` | 此环境变量指定代理记录的详细程度。每个级别包括当前级别和所有更高级别。该值不区分大小写。从最详细到最不详细，日志级别分别为：`trace`、`debug`、`info`、`warn`、`error`、`fatal` 和 `none`。`trace` 日志包含关于 Agent 的详细信息，包括时间信息。 | info | trace<br />debug<br />info<br />warn<br />错误<br />fatal<br />none | 
| `LOG_PATH` | 写入日志的磁盘位置。如果未指定，则日志将写入 stderr。 | 无 | /path/to/logs/agent.log | 
| `MANIFEST` | 此环境变量将 AWS AppConfig Agent 配置为利用其他每个配置的功能，例如多帐户检索和将配置保存到磁盘。有关使用这些功能的更多信息，请参阅 [使用清单启用其它检索功能](appconfig-agent-how-to-use-additional-features.md)。 | 无 | 使用 AWS AppConfig 配置作为清单时:`MyApp:MyEnv:MyManifestConfig`.<br />当从磁盘加载清单时：`file:/path/to/manifest.json` | 
| `MAX_CONNECTIONS` | 此环境变量配置代理用于从 AWS AppConfig检索配置的最大连接数。 | 3 | 3 | 
| `POLL_INTERVAL` | 此环境变量控制代理轮 AWS AppConfig 询更新配置数据的频率。您可以指定间隔的秒数。您还可以指定一个带有时间单位的数字：s 表示秒，m 表示分钟，h 表示小时。如果未指定单位，则代理默认为秒。例如，60 秒、60 秒和 1 分钟会产生相同的轮询间隔。 | 45 秒 | 45<br />45 秒<br />5m<br />1 小时 | 
| `PREFETCH_LIST` | 此环境变量指定代理启动后立即请求 AWS AppConfig 的配置数据。可以使用逗号分隔的列表提供多个配置标识符。 | 无 | MyApp:MyEnv:MyConfig<br />abcd123:efgh456:ijkl789<br />MyApp:MyEnv:Config1,MyApp:MyEnv:Config2 | 
| `PRELOAD_BACKUPS` | 如果设置为`true`， AWS AppConfig 代理会将中找到的配置备份加载`BACKUP_DIRECTORY`到内存中，并立即检查服务中是否存在更新的版本。如果设置为 `false`， AWS AppConfig 代理仅在无法从服务中检索配置数据（例如，如果网络出现问题）时，才从配置备份中加载内容。 | true | true<br />false | 
| PROXY\_HEADERS | 此环境变量指定 PROXY\_URL 环境变量中引用的代理所需的标头。其值是以逗号分隔的标头列表。 | 无 | header: value<br />h1: v1, h2: v2 | 
| PROXY\_URL | 此环境变量指定用于从代理到的连接的代理 URL AWS 服务，包括 AWS AppConfig。 HTTPS并支持 HTTP URL。 | 无 | http://localhost:7474<br />https://my-proxy.example.com | 
| `REQUEST_TIMEOUT` | 此环境变量控制代理等待响应的 AWS AppConfig时间。如果服务没有响应，则请求将失败。<br />如果请求用于初始数据检索，则代理会向应用程序返回错误。<br />如果在对更新的数据进行后台检查期间发生超时，代理会记录错误，并在短暂延迟后重试。<br />您可以指定超时的毫秒数。您还可以指定一个带有时间单位的数字：ms 表示毫秒，s 表示秒。如果未指定单位，则代理默认为毫秒。例如，5000、5000ms 和 5s 会产生相同的请求超时值。 | 3000 毫秒 | 3000<br />3000 毫秒<br />5 秒 | 
| ROLE\_ARN | 此环境变量指定 IAM 角色的亚马逊资源名称 (ARN)。 AWS AppConfig 代理扮演此角色来检索配置数据。 | 无 | arn: aws: iam:: 123456789012: role/MyRole | 
| ROLE\_EXTERNAL\_ID | 此环境变量指定要与代入角色 ARN 一起使用的外部 ID。 | 无 | MyExternalId | 
| ROLE\_SESSION\_NAME | 此环境变量指定要与代入的 IAM 角色的凭证关联的会话名称。 | 无 | AWSAppConfigAgentSession | 
| SERVICE\_REGION | 此环境变量指定了 AWS AppConfig Agent AWS 区域 用来调用 AWS AppConfig 服务的替代方案。如果未定义，代理将尝试确定当前区域。如果不能，则代理无法启动。 | 无 | us-east-1<br />eu-west-1 | 
| `WAIT_ON_MANIFEST` | 此环境变量将 AWS AppConfig Agent 配置为等到清单处理完毕后再完成启动。 | true | true<br />false |