# 开启 Amazon ECS 容器元数据
<a name="enable-metadata"></a>

您可以将 `ECS_ENABLE_CONTAINER_METADATA` 容器代理变量设置为 `true`，从而在容器实例级别启用容器元数据。您可以在 `/etc/ecs/ecs.config` 配置文件中设置此变量，并重新启动代理。您也可以在启动代理容器时将其设置为 Docker 环境变量。有关更多信息，请参阅 [Amazon ECS 容器代理配置](ecs-agent-config.md)。

如果在代理启动时将 `ECS_ENABLE_CONTAINER_METADATA` 设置为 `true`，则会为从那时起创建的任何容器创建元数据文件。Amazon ECS 容器代理无法为那些在 `ECS_ENABLE_CONTAINER_METADATA` 容器代理变量设置为 `true` 之前创建的容器创建元数据文件。为确保所有容器都收到元数据文件，应在容器实例启动时设置此代理变量。以下是一个示例用户数据脚本，该脚本将设置此变量以及将容器实例注册到您的集群中。

```
#!/bin/bash
cat <<'EOF' >> /etc/ecs/ecs.config
ECS_CLUSTER=your_cluster_name
ECS_ENABLE_CONTAINER_METADATA=true
EOF
```