标签的两个来源
labels 给服务容器写自定义标签；同时每个由编排创建的容器自带一组自动标签，例如项目名、服务名与配置哈希。自定义标签用于资产归属、筛选与审计，自动标签用于反查容器来源，两者在批量运维脚本里都很实用。
基本信息
| 自定义标签 | 在服务的标签字段里以映射或列表形式书写 |
|---|---|
| 自动标签 | 包含项目、服务与配置哈希等信息 |
| 用途 | 筛选容器、监控分组、资产归属 |
| 书写建议 | 带组织域名前缀，避免与公共标签冲突 |
| 注意 | 标签值会出现在检查输出中 |
典型使用场景
- 按团队或环境筛选容器
- 批量运维脚本按标签选中操作对象
- 监控与资产系统同步容器归属
- 按项目标签核对某套环境的资源
- 评审时确认标签里没有敏感内容
定义与筛选
定义与筛选
services:
api:
image: app/api:1.4.2
labels:
com.example.team: platform
com.example.env: prod查询标签
查询标签
docker ps --filter label=com.example.team=platform # 按自定义标签筛选
docker ps --filter label=com.docker.compose.project=shop --format '{{.Names}}' # 按自动标签筛选
docker inspect -f '{{json .Config.Labels}}' <容器> | head -c 300 # 查看容器全部标签标签来源与用途
| 标签 | 来源 | 用途 |
|---|---|---|
| 项目标签 | 编排工具自动写入 | 按项目筛选资源 |
| 服务标签 | 编排工具自动写入 | 按服务归类统计 |
| 配置哈希标签 | 编排工具自动写入 | 判断配置是否发生变化 |
| 自定义前缀标签 | 人工定义 | 资产归属与监控分组 |
自动标签由编排工具维护，用来反查容器归属；自定义标签建议带组织域名前缀，避免与公共标签发生冲突。
标签值会出现在检查输出与监控系统里，不要在其中写敏感信息，例如密码或内部凭据。
标签使用建议
- 自定义标签统一加组织域名前缀，便于长期演进
- 团队、环境、成本归属这类信息用稳定字段表达
- 批量脚本按标签筛选对象，避免依赖容器名的命名规则
- 定期核对标签与资产台账，清理已经下线的实例
- 评审配置时确认标签里不含敏感内容