How to Use Docker Labels for Metadata Management

Docker labels allow you to add metadata to your Docker objects (images, containers, etc.). This article covers how to use Docker labels for metadata management.

Adding Labels to Docker Images

Add labels to a Docker image in the Dockerfile:

FROM nginx
LABEL maintainer="your_email@example.com"
LABEL version="1.0"
LABEL description="A basic Nginx image"

Building the Image

Build the Docker image with labels:

docker build -t my_nginx_with_labels .

Viewing Labels

View labels of an image:

docker inspect --format='{{json .Config.Labels}}' my_nginx_with_labels

Filtering Containers by Labels

Run a container with labels:

docker run -d --label project=example --name my_container nginx

List containers filtered by label:

docker ps --filter "label=project=example"

Conclusion

Docker labels are a flexible way to manage metadata for your Docker objects, making it easier to organize and automate your container workflows.