Образ, контейнер и команды

Образ содержит файловую систему приложения и настройки запуска по умолчанию. Контейнер создаётся из образа и получает собственное состояние. Например, два тестировщика могут запустить один образ API с разными настройками: код одинаковый, а процессы и результаты работы независимы.

Уже созданный образ не меняется от правки файла на ноутбуке или от записи внутри контейнера. Чтобы включить исправление кода в новый образ, нужна новая сборка. Метка qa-api:v1 — удобное имя; она может быть переназначена другому образу. Поэтому для точного воспроизведения полезно фиксировать также идентификатор или digest. Docker Docs об устройстве образа.

docker image ls
docker run --name version-check python:3.12-alpine python --version
docker ps -a

В первом списке ищите образы. Во втором списке — экземпляр version-check, который уже мог завершиться. Имя контейнера не является именем образа, хотя оба используются в командах Docker.

В docker run сначала идут параметры Docker, затем имя образа, затем команда и её аргументы внутри контейнера. Порядок имеет значение: то, что написано после имени образа, обычно уже относится к запускаемой программе.

docker run --rm --name python-check python:3.12-alpine python -c "print(6 * 7)"

--name задаёт имя экземпляра, python:3.12-alpine выбирает образ, а python -c выполняет короткую программу. Ожидаемый вывод — 42. Здесь команда после образа заменяет его команду по умолчанию. Полный порядок аргументов приведён в справочнике запуска контейнеров.

Популярная ошибка — переставить --name после python:3.12-alpine. Docker может принять его за имя программы, которую надо выполнить. Если видите сообщение о неизвестном исполняемом файле, проверьте не только образ, но и границу между параметрами Docker и командой приложения.

Сервис обычно работает долго, а команда проверки версии — недолго. Для диагностики нужны оба вида контейнеров. docker ps показывает работающие экземпляры, docker ps -a добавляет завершившиеся. Сначала найдите конкретное имя и состояние, затем переходите к его выводу.

docker ps
docker ps -a
docker logs version-check
docker rm version-check

Эта последовательность продолжает пример первого шага, в котором не было --rm: контейнер сохранился после завершения. В примере второго шага --rm включён, поэтому рассчитывать на последующее чтение его логов нельзя. Выбирайте флаг осознанно, особенно когда расследуете ошибку старта.

docker rm удаляет контейнер, а не базовый образ Python. После удаления имя можно использовать снова. Ошибка о занятом имени означает, что такой экземпляр уже существует, иногда в состоянии Exited; повторное скачивание образа её не исправляет.