Начало работы
Базовые команды
docker run создаёт и запускает контейнер. -d запускает в фоне, -p сопоставляет порт хоста с портом контейнера. pull скачивает образы из registry (по умолчанию Docker Hub).
# check version
docker --version
# pull an image
docker pull nginx:latest
# run a container
docker run -d --name mynginx -p 8080:80 nginx
# list running containers
docker ps
# list all containers (including stopped)
docker ps -a
# stop and remove a container
docker stop mynginx
docker rm mynginx
# list images
docker imagesЖизненный цикл контейнера
create + start — это то, что run делает внутри. stop отправл яет SIGTERM для корректной остановки; kill сразу отправляет SIGKILL. pause использует cgroup freezer — удобно для снятия состояния, не останавливая процесс.
# create a container without starting it
docker create --name web nginx
# start a created (or stopped) container
docker start web
# stop gracefully (SIGTERM then SIGKILL after 10s)
docker stop web
# force kill immediately
docker kill web
# restart a container
docker restart web
# pause/resume (freezes process with cgroups)
docker pause web
docker unpause webОсновы образов
Образы состоят из слоёв только для чтения. rmi завершится ошибкой, если на образ всё ещё ссылается контейнер, — сначала удалите контейнер. history показывает каждую инструкцию, создавшую слой, и его размер — полезно для оптимизации сборки.
# list local images
docker images
docker image ls
# remove an image
docker rmi nginx:latest
docker image rm nginx
# remove all dangling (untagged) images
docker image prune
# remove all unused images
docker image prune -a
# show image history (each layer)
docker history nginx:latestИнформация о системе
docker info показывает конфигурацию демона: storage driver, runtime, registry, статус swarm. system df показывает, сколько места можно освободить: висячие образы и остановленные контейнеры зря занимают диск. Флаг --format использует Go-шаблоны для структурированного вывода.
# docker system-wide info
docker info
docker version
# disk usage breakdown (images, containers, volumes)
docker system df
# detailed disk usage with reclaimable space
docker system df -v
# running containers count
docker ps -q | wc -l
# show docker root directory and storage driver
docker info --format '{{.DockerRootDir}} {{.Driver}}'Очистка и prune
prune безопасно удаляет остановленные и висячие ресурсы. system prune -a дополнительно удаляет образы, на которые не ссылается ни один контейнер. Флаг --volumes удаляет тома, не используемые контейнерами, — это необратимая потеря данных, применяйте осторожно в production.
# remove stopped containers
docker container prune
# remove dangling images
docker image prune
# remove unused volumes (CAUTION: data loss)
docker volume prune
# remove unused networks
docker network prune
# remove everything unused at once
docker system prune
# also remove volumes (very aggressive)
docker system prune -a --volumesПолучение справки
Docker группирует команды в пространства управления (docker image, docker container, docker network, docker volume). Работают и старые (docker rmi), и новые (docker image rm) формы. --help у любой подкоманды показывает флаги и примеры использования.
# list all commands
docker --help
docker help
# help for a specific command
docker run --help
docker image --help
# list management commands (grouped)
docker image --help
docker container --help
docker network --help
# show daemon config
docker info
# command reference online
# https://docs.docker.com/reference/Управление образами
Загрузка образов
Теги — изменяемые метки: один и тот же тег со временем может указывать на разные образы. Для воспроизводимых деплоев фиксируйте образ по digest (@sha256:...). Загрузка с --platform позволяет получить образ для другой архитектуры — полезно для сборок ARM на x86-хостах.
# pull latest tag
docker pull nginx
# pull specific tag
docker pull nginx:1.25-alpine
# pull all tags of a repository
docker pull -a alpine
# pull from a different registry
docker pull ghcr.io/user/repo:tag
# pull by digest (immutable, reproducible)
docker pull nginx@sha256:abc123...
# pull multiple platforms (multi-arch)
docker pull --platform linux/arm64 nginxСборка образов
Последняя точка — это контекст сборки: файлы, отправляемые демону. Держите его маленьким с помощью .dockerignore, чтобы ускорить сборку. --no-cache принудител ьно пересобирает слои при отладке. BuildKit включает кеширование многоступенчатых сборок, SSH-монтирования и монтирование секретов.
# build from Dockerfile in current dir, tag it
docker build -t myapp:1.0 .
# build with a different Dockerfile name
docker build -f Dockerfile.prod -t myapp:prod .
# build with build args
docker build --build-arg VERSION=1.2.3 -t myapp .
# build with no cache
docker build --no-cache -t myapp .
# build for a different platform
docker build --platform linux/arm64 -t myapp:arm .
# build using BuildKit (advanced features)
DOCKER_BUILDKIT=1 docker build -t myapp .Тегирование образов
Теги — это псевдонимы, указывающие на один и тот же ID образа. Обычный workflow: собрать образ с версионным тегом, затем добавить теги latest и major-версии. Тег с URL registry подготавливает образ к push в этот registry.
# tag a local image
docker tag myapp:1.0 myapp:latest
# tag for pushing to Docker Hub
docker tag myapp:1.0 username/myapp:1.0
# tag for a private registry
docker tag myapp:1.0 registry.local:5000/myapp:1.0
# tag with multiple tags at once
docker tag myapp:1.0 myapp:stable
docker tag myapp:1.0 myapp:1
# tag by digest reference
docker tag myapp@sha256:abc... myapp:pinnedПубликация образов
Перед push образ нужно пометить тегом с адресом registry. push загружает только те слои, которых ещё нет в registry. Для приватных registry с самоподписанными сертификатами настройте демон в /etc/docker/daemon.json через insecure-registries.
# login to Docker Hub
docker login
# login to a private registry
docker login registry.local:5000 -u user -p pass
# push to Docker Hub
docker push username/myapp:1.0
# push all tags in a repository
docker push -a username/myapp
# push to private registry
docker push registry.local:5000/myapp:1.0
# logout when done
docker logoutИнспекция образов
inspect возвращает подробный JSON: архитектуру, ОС, слои, env, entrypoint, конфигурацию. history раскрывает команду и размер каждого слоя — основа оптимизации образов. manifest inspect проверяет удалённый registry без загрузки образа.
# low-level image metadata (JSON)
docker inspect nginx:latest
# specific field via Go template
docker inspect --format '{{.Arch}} {{.Os}}' nginx
# show image layers and sizes
docker history nginx:latest
# no-trunc to see full command for each layer
docker history --no-trunc nginx:latest
# inspect an image in a registry (manifest)
docker manifest inspect nginx:latestСохранение и загрузка образов
save/load сохраняет слои и историю образа — правильный выбор для переноса образов офлайн. export/import сплющивает образ в один слой и теряет историю. Для передачи по сети предпочитайте push/pull в registry, а не tar-файлы.
# save an image to a tar file
docker save -o myapp.tar myapp:1.0
# save multiple images
docker save -o bundle.tar myapp:1.0 nginx:latest
# load an image from a tar file
docker load -i myapp.tar
# pipe between hosts (no intermediate file)
docker save myapp:1.0 | gzip | ssh host 'gunzip | docker load'
# export a container filesystem (not an image)
docker export mycontainer | gzip > fs.tar.gzУправление контейнерами
Запуск контейнеров
-it объединяет -i (держать stdin открытым) и -t (выделить tty) для интерактивных сессий. --rm удаляет контейнер после выхода — идеально для разовых команд. --restart unless-stopped переживает перезагрузки, но уважает ручную остановку.
# run in background with a name and port mapping
docker run -d --name web -p 8080:80 nginx
# run interactively with a terminal
docker run -it --name shell alpine sh
# run and auto-remove on exit
docker run --rm alpine echo hello
# run with a volume
docker run -d -v mydata:/data alpine
# run with environment variables
docker run -d -e MYSQL_ROOT_PASSWORD=secret mysql
# run with a restart policy
docker run -d --restart unless-stopped nginxВыполнение команд (exec)
exec запускает новый процесс внутри уже работающего контейнера — исходный entrypoint продолжает работать. Используйте его для отладки, административных задач и разовых скриптов. По умолчанию используется USER образа; переопределите через -u.
# open an interactive shell in a running container
docker exec -it web sh
# run a command and return
docker exec web ls /usr/share/nginx/html
# run as a specific user
docker exec -u root web whoami
# set environment variables for the command
docker exec -e DEBUG=1 web env
# run with a working directory
docker exec -w /tmp web pwd
# run as detached (rarely useful)
docker exec -d web touch /tmp/markerПросмотр логов
logs показывает stdout/stderr, захваченный logging driver контейнера. Приложения должны писать в stdout, а не в файлы, чтобы интегрироваться с docker logs. --since/--until принимают метки времени RFC3339 или длительности Go (30m, 2h).
# follow (tail) logs
docker logs -f web
# show last 100 lines
docker logs --tail 100 web
# show logs since a timestamp
docker logs --since 2024-01-01T00:00:00 web
# show logs from the last 30 minutes
docker logs --since 30m web
# add timestamps to each line
docker logs -t web
# show logs for a specific timeframe
docker logs --since 10m --until 5m webИнспекция контейнера
inspect возвращает богатый JSON с конфигурацией, состоянием, сетью и монтированиями. Go-шаблоны извлекают отдельные поля — крайне полезно для скриптов. LogPath показывает, где драйвер json-file хранит логи на хосте.
# full JSON metadata
docker inspect web
# container IP address
docker inspect --format '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' web
# container log path (json-file driver)
docker inspect --format '{{.LogPath}}' web
# mounts and volumes
docker inspect --format '{{json .Mounts}}' web
# container state (running, exited, etc.)
docker inspect --format '{{.State.Status}} {{.State.ExitCode}}' web
# all container ports
docker inspect --format '{{json .NetworkSettings.Ports}}' webЗапуск, остановка и перезапуск
start возобновляет остановленный контейнер с его исходной конфигурацией. update изменяет ограничения и политику перезапуска работающего контейнера без пересоздания — удобно для ужесточения лимитов в production.
# start a stopped container
docker start web
# stop with a custom timeout (seconds)
docker stop -t 30 web
# restart (keeps container intact)
docker restart web
# rename a container
docker rename web webserver
# update container config (e.g. restart policy)
docker update --restart unless-stopped web
# pause/resume (cgroup freezer)
docker pause web
docker unpause webКопирование файлов
cp работает в обе стороны и с остановленными контейнерами — удобно для срочных исправлений и вытаскивания логов. Он не рассчитан на частую синхронизацию; для разработки используйте bind mount или том. Приём tar+exec эффективно передаёт большие деревья файлов.
# copy a file from host to container
docker cp file.txt web:/tmp/
# copy from container to host
docker cp web:/etc/nginx/nginx.conf ./nginx.conf
# copy a directory
docker cp ./app web:/usr/src/app
# copy with archive mode (preserves perms)
docker cp -a ./config web:/etc/app
# copy to a stopped container (works too)
docker cp script.sh web:/script.sh
# tar stream from host to container stdin
docker exec -i web tar xzf - -C /app < app.tar.gzОсновы Dockerfile
FROM — базовый образ
FROM — первая инструкция, задающая базовый слой. Выбирайте минимальные базы (alpine, distroless, scratch), чтобы уменьшить поверхность атаки и размер. Фиксация по digest гарантирует воспроизводимость сборки, так как теги могут меняться.
# use an official base image
FROM ubuntu:22.04
# pin a specific digest for reproducibility
FROM ubuntu@sha256:abc123def...
# multi-arch build (buildx picks the host arch)
FROM --platform=$BUILDPLATFORM golang:1.21 AS builder
# use a minimal image
FROM alpine:3.18
# scratch = empty image, for static binaries
FROM scratch
# use a previous build stage
FROM builder AS finalRUN — выполнение команд
Каждый RUN создаёт слой. Объединяйте связанные команды через && и очищайте всё в том же слое, чтобы образ оставался маленьким. Exec-форма (JSON-массив) не вызывает shell, поэтому нет подстановки переменных и цепочек команд, зато сигналы обрабатываются правильно.
# install packages
RUN apt-get update && apt-get install -y curl
# clean up in the same layer to reduce size
RUN apt-get update && apt-get install -y --no-install-recommends curl \
&& rm -rf /var/lib/apt/lists/*
# combine commands with && to reduce layers
RUN mkdir -p /app/config && chown 1000:1000 /app/config
# use exec form (preferred) to ensure signals
RUN ["npm", "install"]
# use a shell for variables and chaining
RUN VERSION=1.0 && wget https://example.com/v${VERSION}.tar.gzCOPY и ADD
Для локальных файлов предпочитайте COPY — он явный и предсказуемый. ADD добавляет магию: скачивание по URL и автоматическую распаковку tar/zip. Эта магия может удивить; используйте ADD только когда нужна распаковка. Обе инструкции создают слой.
# copy a file into the image
COPY package.json /app/
# copy a directory
COPY src/ /app/src/
# copy with ownership
COPY --chown=node:node package.json /app/
# copy from a previous build stage
COPY --from=builder /app/dist /app/dist
# ADD can fetch URLs and extract archives
ADD https://example.com/app.tar.gz /tmp/
# ADD extracts local tar archives automatically
ADD app.tar.gz /usr/src/WORKDIR
WORKDIR задаёт рабочий каталог для последующих инструкций и по умолчанию для контейнера. Если каталога нет, он создаётся. Всегда предпочитайте WORKDIR вместо cd в RUN — cd не сохраняется между слоями. Для ясности используйте абсолютные пути.
# set the working directory
WORKDIR /usr/src/app
# subsequent RUN, CMD, COPY use this dir
COPY . .
RUN npm install
# WORKDIR creates the directory if it does not exist
WORKDIR /opt/data/logs
# use a relative path (relative to previous WORKDIR)
WORKDIR sub
# avoid this anti-pattern (use absolute paths)
WORKDIR /app
RUN cd /app && do_something # cd is lost after RUNUSER
USER задаёт пользователя (и при необходимости группу) для RUN, CMD и ENTRYPOINT. Запуск не от root — ключевая практика безопасности. Пользователь должен существовать в образе. Числовые UID переносимы между образами и избавляют от проблем с поиском имени.
# create a non-root user and switch to it
RUN groupadd -r app && useradd -r -g app appuser
USER appuser
# run subsequent instructions as this user
RUN whoami # appuser
# use a numeric UID for portability
USER 1000
# USER in compose/runtime overrides this
USER 1000:1000
# common pattern: node image ships a 'node' user
FROM node:20-alpine
USER node.dockerignore
.dockerignore уменьшает контекст сборки, отправляемый демону: сборка быстрее, контекст меньше, а секреты вроде .env не попадут в слои образа. Синтаксис похож на .gitignore. Всегда исключайте node_modules и артефакты сборки, которые пересоздаются при сборке.
# .dockerignore — exclude files from the build context
# version control
.git
.gitignore
# dependencies (fetched inside the image)
node_modules
npm-debug.log
# build artifacts
dist
build
*.log
# local env files (NEVER bake secrets)
.env
.env.local
# docker files themselves
Dockerfile
docker-compose*.yml
# OS files
.DS_Store
Thumbs.dbПродвинутый Dockerfile
CMD против ENTRYPOINT
ENTRYPOINT задаёт исполняемый файл; CMD — аргументы по умолчанию, которые можно переопределить. Используйте exec-форму (JSON-массив), чтобы процесс получал сигналы напрямую: shell-форма о борачивает команду в /bin/sh -c и ломает корректную остановку. Частый приём: ENTRYPOINT-скрипт + аргументы по умолчанию в CMD.
# CMD: default command, easily overridden
CMD ["nginx", "-g", "daemon off;"]
# override at runtime
# docker run myimage nginx -v
# ENTRYPOINT: fixed command, CMD becomes args
ENTRYPOINT ["nginx"]
CMD ["-g", "daemon off;"]
# runtime args append to ENTRYPOINT
# docker run myimage -v -> nginx -v
# shell form (avoid — no signal handling)
CMD nginx -g "daemon off;"
# script as entrypoint that accepts args
ENTRYPOINT ["./entrypoint.sh"]
CMD ["--help"]ENV — переменные окружения
ENV создаёт переменные уровня образа, видимые при сборке и в runtime. Для значений, нужных только при сборке, используйте ARG, чтобы не тащить конфигурацию в финальный образ. В exec-форме CMD/ENTRYPOINT ${VAR} не раскрывается shell — оберните в sh -c.
# set a persistent env var (baked into image)
ENV NODE_ENV=production
ENV PATH=/app/node_modules/.bin:$PATH
# use in subsequent RUN instructions
ENV VERSION=1.2.3
RUN wget https://example.com/v${VERSION}.tar.gz
# multiple in one line
ENV NODE_ENV=production PORT=3000 LOG_LEVEL=info
# override at runtime
# docker run -e NODE_ENV=development myapp
# view env vars of a container
docker exec web env
# reference env vars in CMD
ENV APP_PORT=3000
CMD ["sh", "-c", "node server.js ${APP_PORT}"]ARG — аргументы сборки
Значения ARG существуют только во время сборки той стадии, где они объявлены. В runtime-контейнер они не попадают — чтобы передать значение дальше, используйте ENV. ARG, объявленные до FROM, «глобальны», но в каждой стадии их нужно объявить заново, чтобы использовать.
# declare a build argument with a default
ARG VERSION=latest
FROM base:${VERSION}
# use ARG only during build (not at runtime)
ARG NODE_ENV=production
RUN echo "Building for ${NODE_ENV}"
# multi-stage: ARG must be redeclared per stage
ARG VERSION
FROM base:${VERSION}
ARG VERSION
RUN echo ${VERSION}
# pass at build time
# docker build --build-arg VERSION=1.0 .
# ARG not available in CMD (use ENV to pass through)
ARG PORT=3000
ENV PORT=${PORT}
CMD ["sh", "-c", "serve --port ${PORT}"]EXPOSE
EXPOSE — это документация, он не публикует порты. Публикация происходит через -p (host:container) в runtime или ports: в Compose. EXPOSE помогает инструментам понять предполагаемые порты и включает автоматическое связывание в устаревших сетях.
# document which port the container listens on
EXPOSE 80
# expose multiple ports
EXPOSE 80 443
# expose with protocol
EXPOSE 53/udp
# EXPOSE does NOT publish the port
# you still need -p at runtime
# docker run -p 8080:80 myapp
# in compose, expose vs ports
# expose: only to linked services
# ports: published to the host
# view exposed ports
docker inspect --format '{{json .Config.ExposedPorts}}' myappLABEL и метаданные
LABEL прикрепляет к образу метаданные в виде ключ-значение. Используйте метки OCI org.opencontainers.image.* для совместимости с registry и инструментами. Метки удобны для отслеживания версии, источника, лицензии и информации о сборке CI.
# add a label (key=value metadata)
LABEL maintainer="[email protected]"
LABEL version="1.0"
LABEL description="My web app"
# multiple labels in one instruction
LABEL org.opencontainers.image.title="myapp" \
org.opencontainers.image.version="1.0" \
org.opencontainers.image.source="https://github.com/me/myapp"
# view labels
docker inspect --format '{{json .Config.Labels}}' myapp
# filter images by label
docker images --filter "label=version=1.0"
# deprecated: MAINTAINER (use LABEL maintainer instead)
# MAINTAINER Alice <[email protected]>VOLUME в Dockerfile
VOLUME объявляет точку монтирования; при первом запуске Docker создаёт анонимный том, если вы не смонтировали путь хоста. Это сигнал, что каталог хранит состояние. Подводный камень: объяв ление VOLUME после COPY может перекрыть скопированные файлы пустым томом.
# declare an anonymous volume mount point
VOLUME /data
# multiple mount points
VOLUME /data /config /logs
# at runtime, Docker creates an anonymous volume
# docker run -v mydata:/data myapp (named instead)
# VOLUME in Dockerfile: any files copied to /data
# are copied into the new anonymous volume on first run
# inspect volumes
docker inspect --format '{{json .Mounts}}' myapp
# avoid: VOLUME after COPY can hide your data
COPY ./config /config
VOLUME /config # new empty volume shadows /configМногоступенчатые сборки
Базовая многоступенчатая сборка
Многоступенчатые сборки копируют в runtime-образ только финальные артефакты — инструменты сборки, исходники и dev-зависимости остаются в стадии builder. Результат: крошечный и безопасный runtime-образ. Называйте стадии через AS, чтобы ссылаться на них в COPY --from.
# stage 1: build
FROM node:20 AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build
# stage 2: runtime (small)
FROM nginx:alpine
COPY --from=builder /app/dist /usr/share/nginx/html
EXPOSE 80
CMD ["nginx", "-g", "daemon off;"]Выбор стадии сборки
--target собирает только до указанной стадии, пропуская последующие. Это позволяет держать один Dockerfile для dev, test и production: цель test для CI, final для production. BuildKit автоматически распараллеливает независимые стадии.
# build only up to a named stage
# docker build --target builder -t myapp:dev .
FROM node:20 AS builder
RUN npm ci && npm run build
FROM node:20-alpine AS test
COPY --from=builder /app /app
RUN npm test
FROM nginx:alpine AS final
COPY --from=builder /app/dist /usr/share/nginx/html
# target a specific stage
# docker build --target test .Тонкие runtime-образы
Для статических бинарнико в (Go, Rust) scratch даёт минимально возможный образ с нулевой поверхностью атаки. Добавьте CA-сертификаты для HTTPS. Distroless предлагает минимальную базу с корневыми CA и пользователем не-root — идеально для динамических языков или когда нужен runtime без shell.
# build stage
FROM golang:1.21 AS builder
WORKDIR /src
COPY . .
RUN CGO_ENABLED=0 go build -o app -ldflags="-s -w" .
# scratch = empty image, only the static binary
FROM scratch
COPY --from=builder /src/app /app
COPY --from=builder /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/
ENTRYPOINT ["/app"]
# result: ~10MB image
# or use distroless for a minimal OS base
FROM gcr.io/distroless/static
COPY --from=builder /src/app /app
ENTRYPOINT ["/app"]Паттерн builder для компилируемых языков
Компилируйте в полном образе SDK, затем копируйте артефакт в образ только для runtime (JRE). Это резко уменьшает размер (JDK ~600 МБ против JRE ~200 МБ) и убирает инструменты сборки из production. Предварительная загрузка зависимостей до COPY улучшает кеширование слоёв.
# stage 1: compile
FROM maven:3.9 AS builder
WORKDIR /build
COPY pom.xml .
RUN mvn dependency:go-offline
COPY src ./src
RUN mvn package -DskipTests
# stage 2: runtime with only the JRE
FROM eclipse-temurin:21-jre-alpine
COPY --from=builder /build/target/*.jar /app/app.jar
EXPOSE 8080
ENTRYPOINT ["java", "-jar", "/app/app.jar"]
# benefits: no JDK, no source, no Maven cache in runtimeКопирование из внешних образов
COPY --from может брать файлы из любого образа — удобно, чтобы собрать инструменты из разных баз без стадии сборки. На стадии можно ссылаться и по индексу (с нуля), но именование через AS понятнее. Фиксируйте внешние образы по digest для воспроизводимости.
# copy a binary from another image (no build stage needed)
FROM alpine:3.18
COPY --from=nginx:alpine /usr/sbin/nginx /usr/sbin/nginx
COPY --from=nginx:alpine /etc/nginx /etc/nginx
RUN apk add --no-cache libpcre2
EXPOSE 80
CMD ["nginx", "-g", "daemon off;"]
# use a specific digest for reproducibility
COPY --from=redis:7@sha256:abc... /usr/local/bin/redis-server /usr/local/bin/
# copy from a built stage referenced by index
COPY --from=0 /build/output /appВозможности BuildKit
BuildKit открывает кеш-монтирования (кеши npm/pip сохраняются между сборками, не раздувая образ), монтирование секретов (учётные данные никогда не попадают в слой), проброс SSH для приватных репозиториев и синтаксис heredoc для аккуратных многострочных RUN. Добавьте директиву # syntax, чтобы зафиксировать версию frontend Dockerfile.
# enable BuildKit
# DOCKER_BUILDKIT=1 docker build .
# syntax directive for latest frontend
# syntax=docker/dockerfile:1
FROM alpine
# mount a cache (persists across builds, not in image)
RUN --mount=type=cache,target=/root/.npm npm ci
# mount a secret (never written to layers)
RUN --mount=type=secret,id=npmrc,target=/root/.npmrc npm ci
# mount an SSH socket for private repos
RUN --mount=type=ssh git clone [email protected]:me/repo.git
# heredoc for multi-line scripts
RUN <<EOF
set -ex
apk add --no-cache curl
mkdir -p /app/data
EOFТома
Создание и использование томов
Именованные тома управляются Docker — это рекомендуемый способ хранить данные. Они переживают удаление контейнера и не зависят от структуры файловой системы хоста. Суффикс :ro монтирует том только для чтения. inspect показывает путь на диске в /var/lib/docker/volumes.
# create a named volume
docker volume create mydata
# use it in a container
docker run -d -v mydata:/data alpine sh -c "sleep 1h"
# inspect the volume
docker volume inspect mydata
# mount read-only
docker run -v mydata:/data:ro alpine ls /data
# mount with a different filesystem (e.g. tmpfs)
docker run --tmpfs /cache alpine
# default volume driver: local
docker volume create --driver local mydataСписок и инспекция томов
ls перечисляет именованные тома; inspect показывает драйвер и точку монтирования. Чтобы узнать, какие контейнеры используют том, отфильтруйте ps по тому. На Linux тома лежат в /var/lib/docker/volumes/<name>/_data — обращайтесь через docker exec, а не правьте файлы с хоста.
# list all volumes
docker volume ls
# filter by name
docker volume ls -q --filter name=mydata
# show volume details (driver, mountpoint, options)
docker volume inspect mydata
# find the on-disk path
docker volume inspect --format '{{.Mountpoint}}' mydata
# find containers using a volume
docker ps -a --filter volume=mydata --format '{{.Names}}'
# check volume disk usage
docker system df -v | grep mydataДрайверы томов
Драйвер local поддерживает NFS, блочные устройства и tmpfs через опции монтирования. Для облачного хранилища (EBS, Azure Disk) используйте плагин-драйвер. Драйверы абстрагируют хранилище, поэтому контейнеры переносятся между хостами без изменения команды запуска — это важно для Swarm/Kubernetes.
# local driver (default, on host disk)
docker volume create --driver local mydata
# NFS volume
docker volume create --driver local \
--opt type=nfs \
--opt o=addr=10.0.0.5,rw \
--opt device=:/export/data nfsvol
# tmpfs (in-memory, ephemeral)
docker run --tmpfs /cache alpine
# block device
docker volume create --driver local \
--opt type=ext4 \
--opt device=/dev/sdb1 blockvol
# third-party drivers (e.g. cloud)
docker volume create --driver rexray/ebs ebsvolРезервное копирование томов
Сделайте бэкап тома, смонтировав в временный контейнер и том, и каталог хоста, затем упакуйте содержимое в tar. Восстановление повторяет проце сс в обратном порядке. Этот приём работает с любым драйвером томов и лежит в основе скриптов автоматического бэкапа.
# back up a volume to a tar file
docker run --rm -v mydata:/data -v $(pwd):/backup alpine \
tar czf /backup/mydata.tar.gz -C /data .
# restore a volume from a tar file
docker volume create mydata2
docker run --rm -v mydata2:/data -v $(pwd):/backup alpine \
tar xzf /backup/mydata.tar.gz -C /data
# migrate data between volumes
docker run --rm -v src:/src -v dst:/dst alpine \
cp -a /src/. /dst/
# snapshot using a temporary container
docker run --rm -v mydata:/data alpine ls -la /dataУдаление томов
Том нельзя удалить, пока на него ссылается контейнер (сначала удалите контейнер). prune удаляет только неиспользуемые тома. Удаление тома необратимо — данные теряются навсегда. Всегда делайте бэкап production-томов перед prune.
# remove a named volume (must not be in use)
docker volume rm mydata
# remove all unused volumes
docker volume prune
# remove volumes older than 24h not used
docker volume prune --filter "until=24h"
# force remove (even if a stopped container referenced it)
docker volume rm -f mydata
# remove with a label filter
docker volume prune --filter "label=temporary"
# CAUTION: data is gone permanently
docker volume rm mydataОбщие тома между контейнерами
Несколько контейнеров могут монтировать один том, чтобы разделять состояние. --volumes-from копирует монтирования томов другого контейнера — удобно для sidecar-паттернов. Добавьте :ro для потребителей только на чтение. Согласуйте конкурентную запись, чтобы избежать повреждения данных; некоторым приложениям нужна блокировка.
# share a volume between two containers
docker run -d --name db -v shared:/data alpine sleep 1h
docker run -d --name app -v shared:/data alpine sleep 1h
# use --volumes-from to copy a container's mounts
docker run -d --name helper --volumes-from db alpine sleep 1h
# read-only shared volume
docker run -d --name reader -v shared:/data:ro alpine sleep 1h
# compose: shared volume across services
# volumes:
# shared:
# services share 'shared' via volumes: ['shared:/data']
# verify both see the same data
docker exec db sh -c "echo hi > /data/msg"
docker exec app cat /data/msgBind-монтирования
Базовое bind-монтирование
Bind-монтирования напрямую отображают путь хоста в контейнер — идеально для живой разработки, когда правки на хосте видны сразу. Используйте абсолютные пути хоста. Суффикс :ro запрещает контейнеру писать обратно на хост. Современный синтаксис использует --mount для наглядности.