Provision
—— XP

Первые команды Docker

теория~6 минут+160 XP

В подборках «самые важные команды Docker» обычно два десятка пунктов, но в первый месяц работы хватает семи: запустить контейнер, посмотреть, что работает, прочитать журнал, зайти внутрь, остановить и убрать за собой. Этот урок про команды Docker, которыми ты будешь пользоваться каждый день. До конца раздела других почти не понадобится: этих хватит и на запуск чужого готового образа, и на быструю отладку, когда контейнер ведёт себя не так.

Устроены они почти одинаково: docker, затем действие, затем имя контейнера. Многое тебе уже знакомо по разделу про Linux-сервер: systemctl start, status и journalctl делали для служб то же самое — запустить, посмотреть состояние, прочитать журнал. Здесь вместо службы контейнер.

Если ты уже запускал контейнеры и смотрел их логи — этот урок можно пролистать и сразу открыть практику «первые контейнеры». Сдалась с первого раза — значит, ничего нового здесь для тебя нет; не сдалась — вернись сюда за тем, на чём споткнулся.

Запустить: docker run

Начнём с запуска. Команда docker run берёт образ, при необходимости сама скачивает его из интернета и запускает контейнер.

ubuntu@stand:~$
docker run -d --name web -p 8080:80 nginx:1.30
ubuntu@stand:~$
Unable to find image 'nginx:1.30' locally
1.30: Pulling from library/nginx
Status: Downloaded newer image for nginx:1.30
3f2b1c9e8d7a4b6c5d0e1f2a3b4c5d6e7f8091a2b3c4d5e6f708192a3b4c5d6e

Разберём по частям. Флаг — это буква после команды, которая меняет её поведение, и здесь их три. -d запускает контейнер в фоне и возвращает терминал. --name web даёт контейнеру имя, по которому к нему будут обращаться остальные команды. -p 8080:80 открывает дверь снаружи: порт 8080 машины ведёт на порт 80 внутри контейнера, подробно о портах будет отдельный урок. Последнее слово nginx:1.30 — образ и его версия, она же тег.

Длинная строка в конце — полный идентификатор нового контейнера. Запоминать его не нужно: у нас есть имя.

Посмотреть: docker ps

Контейнер запущен, но работает ли он? Список работающих контейнеров печатает docker ps.

ubuntu@stand:~$
docker ps
ubuntu@stand:~$
CONTAINER ID   IMAGE        STATUS          PORTS                  NAMES
3f2b1c9e8d7a   nginx:1.30   Up 12 seconds   0.0.0.0:8080->80/tcp   web

Читать нужно три колонки. STATUS — состояние: Up 12 seconds значит «работает двенадцать секунд». PORTS читается слева направо, снаружи внутрь: всё, что пришло на 8080 машины, уходит на 80 контейнера. NAMES — то самое имя.

Упавший контейнер из этого списка пропадает, и новичок думает, что он исчез. На самом деле он лежит в состоянии Exited, и увидеть его можно флагом -a, от слова all — «все».

ubuntu@stand:~$
docker ps -a
ubuntu@stand:~$
CONTAINER ID   IMAGE        STATUS                     NAMES
3f2b1c9e8d7a   nginx:1.30   Up 40 seconds              web
9a8b7c6d5e4f   postgres:17  Exited (1) 2 minutes ago   db

Число в скобках после Exited — код завершения: ноль значит «закончил штатно», всё остальное — ошибка. Почему контейнер db упал, расскажет журнал.

Прочитать журнал: docker logs

Приложение в контейнере не пишет журнал в файл, а печатает его в свой вывод, и Docker сохраняет этот вывод. Читается он командой docker logs.

ubuntu@stand:~$
docker logs --tail 5 db
ubuntu@stand:~$
Error: Database is uninitialized and superuser password is not specified.
       You must specify POSTGRES_PASSWORD to a non-empty value for the
       superuser. For example, "-e POSTGRES_PASSWORD=password" on "docker run".

Флаг --tail 5 оставляет последние пять строк: журнал растёт, и целиком читать его незачем. Причина падения здесь сказана прямым текстом: базе не передали пароль. Так бывает почти всегда — docker logs первая команда, когда контейнер не поднялся.

Флаг -f (от follow — «следить») держит журнал открытым и дописывает новые строки, пока не нажмёшь Ctrl+C. Им смотрят, что происходит прямо сейчас.

Зайти внутрь: docker exec

Иногда нужно посмотреть изнутри: какой файл лежит, видит ли контейнер соседа. Для этого внутри работающего контейнера запускают ещё одну программу командой docker exec.

ubuntu@stand:~$
docker exec -it web sh
ubuntu@stand:~$
# ls /etc/nginx/conf.d
default.conf
# exit

Флаги -i и -t вместе дают интерактивный терминал: без них оболочка sh запустится и сразу закроется. Значок # — приглашение уже внутри контейнера. Выход — exit, контейнер при этом продолжает работать.

В маленьких образах нет bash, поэтому заходят через sh: он есть почти везде.

Остановить и удалить

Работу с контейнером заканчивают двумя командами, и это разные действия. docker stop останавливает контейнер, но оставляет его на диске: docker start поднимет тот же самый. docker rm удаляет остановленный контейнер совсем.

ubuntu@stand:~$
docker stop web
docker rm web
ubuntu@stand:~$
web
web

Обе команды в ответ просто печатают имя — значит, получилось. Образ при этом остаётся на диске, и следующий docker run возьмёт его без скачивания. Список скачанных образов показывает docker images.

ubuntu@stand:~$
docker images
ubuntu@stand:~$
IMAGE        ID             DISK USAGE   CONTENT SIZE   EXTRA
nginx:1.30   b972f831f200        259MB         64.3MB

Так таблица выглядит в Docker 29. DISK USAGE — сколько образ занимает на диске, CONTENT SIZE — сколько весят его сжатые слои, то есть сколько качать из реестра. В статьях про старые версии вместо них одна колонка SIZE, а имя и тег разнесены по колонкам REPOSITORY и TAG. Размеры пригодятся позже, когда будем уменьшать свои образы; у тебя числа будут чуть другими.

Словарь урока

docker run
Создать и запустить контейнер из образа; при необходимости образ скачивается сам.
docker ps -a
Список всех контейнеров, включая остановленные и упавшие.
Код завершения
Число, с которым закончился главный процесс контейнера. Ноль — штатно, остальное — ошибка. ↩ к тексту

Что спросят на собеседовании

  • Контейнер не запускается. С чего начнёшь?
    docker ps -a, чтобы увидеть состояние и код завершения, затем docker logs по этому контейнеру: причина почти всегда в последних строках журнала.
  • Чем docker exec отличается от docker run?
    run создаёт новый контейнер из образа, exec запускает ещё одну программу в уже работающем.

Что дальше

Команды на месте. Дальше — практика: поставить Docker на стенд и пройти всё это руками.

Проверь себя+160 XPдве попытки
1
Список контейнеров
Контейнер упал и пропал из docker ps. Как его увидеть?
2
Зайти внутрь
Что делает docker exec -it web sh?
3
Запуск
Зачем флаг -d в docker run?
4
Остановить и удалить
Чем docker stop отличается от docker rm?
ответь на все вопросы, чтобы проверить

Нашёл ошибку или непонятное место? Наведи на абзац — слева появится «+», нажми и напиши, что не так. Замечание увидит автор курса.Нашёл ошибку или непонятное место? Нажми «+» справа от заголовка раздела и напиши, что не так. Замечание увидит автор курса.