Перейти до змісту
Intita
Лекція · 40 хв

Docker і Docker Compose

Що ви дізнаєтесь

  • Що таке образ, контейнер, bind mount, іменований том і публікація порту
  • Як читати Dockerfile і docker-compose.yml нашого курсу
  • Основні команди Docker Compose

Docker: образ, контейнер, томи, порт

Docker запускає програми в ізольованих «коробках» — контейнерах. Контейнер схожий на маленький окремий Linux-комп'ютер: у нього своя файлова система, свої процеси, своя мережа. Але він стартує за секунди, бо використовує ядро вашої системи.

Ключові поняття:

Поняття Що це Аналогія
Образ (image) Шаблон: ОС + програми + налаштування. Лише для читання Інсталяційний диск
Контейнер (container) Запущений екземпляр образу Встановлена й запущена програма
Bind mount (монтування папки) Папка вашого комп'ютера, «підключена» всередину контейнера: ./src:/var/www/html. Зміни видно з обох боків одразу Флешка, вставлена в комп'ютер
Іменований том (named volume) Сховище, яке створює й зберігає сам Docker; переживає видалення контейнера. Знадобиться для даних MySQL Камера схову: речі лишаються, навіть коли ви пішли
Публікація порту (ports) Відкриває порт контейнера на порту вашого комп'ютера: 8080:80 Переадресація дзвінка

В Compose обидва різновиди записують у розділ volumes: якщо ліворуч шлях (./src) — це bind mount, якщо просто ім'я (db-data:/var/lib/mysql) — іменований том. У нашому файлі поки лише bind mount.

Образ можна взяти готовий (наприклад, nginx:alpine з Docker Hub) або зібрати свій за рецептом — Dockerfile. Наш PHP-образ збирається саме так. Ось скорочена версія файлу docker/php/Dockerfile:

# базовий образ: PHP 8.4 (FPM) на Alpine Linux
FROM php:8.4-fpm-alpine

# системні пакети і розширення PDO для MySQL
RUN apk add --no-cache git unzip bash \
    && docker-php-ext-install pdo_mysql

# налаштування для розробки: помилки видно в браузері, київський час
RUN cp "$PHP_INI_DIR/php.ini-development" "$PHP_INI_DIR/php.ini" \
    && echo "date.timezone=Europe/Kyiv" > "$PHP_INI_DIR/conf.d/timezone.ini"

# менеджер пакетів PHP
COPY --from=composer:latest /usr/bin/composer /usr/bin/composer

# користувач app з вашими UID/GID
ARG UID=1000
ARG GID=1000
RUN addgroup -g ${GID} -S app && adduser -u ${UID} -S app -G app

# робоча папка всередині контейнера
WORKDIR /var/www/html
# PHP працює не від root
USER app
# PHP-FPM слухає порт 9000
EXPOSE 9000
# команда, яка запускається в контейнері
CMD ["php-fpm", "-F"]

З розширень ставимо лише pdo_mysql — через нього PHP працюватиме з базою даних MySQL (модулі 14–15); mbstring для рядків UTF-8 уже вбудований в офіційний образ. Файл php.ini-development вмикає показ помилок у браузері — під час навчання це саме те, що треба.

Примітка

PHP-FPM (FastCGI Process Manager) — це «двигун», який виконує PHP-скрипти на запит вебсервера. Сам по собі він не вміє відповідати браузеру по HTTP — для цього перед ним стоїть nginx.

Зверніть увагу на USER app з ідентифікаторами UID/GID: PHP у контейнері працює від імені звичайного користувача. Якщо його номер збігається з вашим номером користувача на комп'ютері, файли, які створить PHP, ви зможете вільно редагувати.

Docker на Windows і macOS

Контейнери — це технологія ядра Linux. На Windows і macOS встановлюють Docker Desktop, який непомітно запускає маленьку віртуальну машину з Linux, а вже в ній — ваші контейнери. Для вас це означає дві речі:

  • перед роботою Docker Desktop має бути запущений (іконка кита в треї), інакше команди docker повідомлять, що не можуть під'єднатися до демона;
  • на Windows Docker Desktop працює через WSL 2. Якщо проєкт лежить усередині WSL (наприклад, у ~/projects), файли читаються помітно швидше, ніж із диска C:.

На Linux Docker працює напряму, без віртуальної машини, тож потрібно лише встановити Docker Engine і плагін Compose. Інструкції для кожної системи — на docs.docker.com/get-started/get-docker.

Примітка

План Б: якщо Docker недоступний. Коли Docker не вдається встановити чи запустити, тимчасово можна скористатися вбудованим вебсервером PHP (потрібен PHP 8.4 на самому комп'ютері). Виконайте в корені проєкту php -S localhost:8080 -t src/public. Обмеження: немає nginx, тож default.conf із try_files і забороною доступу до .env не діє; docker compose logs/exec не працюють, а помилки видно лише в терміналі з php -S; версія PHP, розширення й налаштування беруться з вашого комп'ютера, а не з Dockerfile. Щойно Docker запрацює, повертайтеся до docker compose up -d.

Для контейнера з nginx, який слухає порт 80, задано публікацію порту "8000:80". Яку адресу відкрити в браузері на своєму комп'ютері?

Docker Compose: наше середовище одним файлом

Можна запускати кожен контейнер окремою довгою командою docker run ..., але зручніше описати всі сервіси в одному файлі docker-compose.yml і керувати ними разом. Це і є Docker Compose.

Ось файл нашого курсу:

services:
  web:                                  # сервіс №1 — вебсервер nginx
    image: nginx:alpine                 # готовий образ з Docker Hub
    container_name: intita
    restart: unless-stopped
    ports:
      - "8080:80"                       # порт 8080 комп'ютера → порт 80 контейнера
    volumes:
      - ./src:/var/www/html:ro          # код проєкту (лише читання)
      - ./docker/nginx/default.conf:/etc/nginx/conf.d/default.conf:ro   # конфіг nginx
    depends_on:
      - php                             # спочатку стартує php
    networks:
      - intita

  php:                                  # сервіс №2 — PHP-FPM
    build:
      context: ./docker/php             # тут лежить Dockerfile
      args:
        UID: "${UID:-1000}"             # UID з оточення або 1000
        GID: "${GID:-1000}"
    image: intita/php:8.4-fpm           # ім'я, під яким збережеться зібраний образ
    container_name: intita_php
    restart: unless-stopped
    working_dir: /var/www/html
    volumes:
      - ./src:/var/www/html             # той самий код, але з правом запису
    networks:
      - intita

networks:
  intita:
    driver: bridge                      # спільна внутрішня мережа для двох контейнерів

Порада

Цей файл разом із конфігом nginx, Dockerfile, .gitignore і стартовою сторінкою src/public/index.php зібрано в архів intita-php.zip. На практиці ви його скачаєте й розпакуєте, тож набирати конфігурацію вручну не доведеться.

Що тут важливо:

  • ports: "8080:80" — публікація порту: ліворуч порт вашого комп'ютера, праворуч — контейнера. Тому сайт відкривається за адресою http://localhost:8080.
  • volumes — обидва записи тут є bind mount: ліворуч шлях на комп'ютері (відносно папки з docker-compose.yml), праворуч — шлях у контейнері. Ви редагуєте файл у ./src, і контейнер одразу бачить зміну — перезапускати нічого не треба. Іменованого тому в нашому файлі поки немає — він з'явиться, коли додамо базу даних MySQL.
  • :ro (read-only) — nginx може лише читати код. Писати файли (наприклад, завантаження) буде тільки PHP.
  • networks: intita — обидва контейнери в одній мережі і знаходять один одного за ім'ям сервісу: для nginx адреса PHP — це просто php.
  • build проти image — для web береться готовий образ, а для php Compose спершу збирає власний образ за Dockerfile з папки ./docker/php і зберігає його під ім'ям, указаним в image.
  • depends_on — порядок запуску: спочатку php, потім web. Зауважте: це гарантує лише порядок старту, а не те, що PHP вже повністю готовий приймати запити.
  • restart: unless-stopped — якщо контейнер впаде або комп'ютер перезавантажиться, Docker підніме його знову, поки ви самі не зупините його командою docker compose down чи stop.
  • container_name — фіксоване ім'я контейнера (intita, intita_php), яке видно в docker ps і в Docker Desktop. Без нього Docker згенерував би ім'я з назви папки проєкту.

Змінні UID і GID

У розділі build.args стоїть запис "${UID:-1000}". Це означає: «взяти значення змінної оточення UID, а якщо її немає — підставити 1000». Значення передається в Dockerfile і стає номером користувача app усередині контейнера.

На Windows і macOS це ні на що не впливає. На Linux варто, щоб номер збігався з вашим (перевірте командою id -u). Якщо у вас не 1000, створіть поруч із docker-compose.yml файл .env — Compose прочитає його автоматично:

echo "UID=$(id -u)" > .env
echo "GID=$(id -g)" >> .env
docker compose up -d --build

Інакше файли, які створить PHP (наприклад, збережені дані в модулі 13 «Файли та JSON»), належатимуть «чужому» користувачу, і IDE не зможе їх змінити.

Основні команди Compose

Усі команди виконуються в папці, де лежить docker-compose.yml:

docker compose up -d --build   # зібрати образи (якщо треба) і запустити у фоні
docker compose ps              # стан контейнерів
docker compose logs web        # логи nginx (помилки 404, 502 тощо)
docker compose logs -f php     # логи PHP у реальному часі (Ctrl+C — вийти)
docker compose exec php php -v # виконати команду всередині контейнера php
docker compose restart web     # перезапустити nginx (після зміни default.conf)
docker compose down            # зупинити і видалити контейнери (файли в src лишаються)

Приблизний вивід docker compose ps, коли все гаразд:

NAME         IMAGE                COMMAND                  SERVICE   CREATED         STATUS         PORTS
intita       nginx:alpine         "/docker-entrypoint.…"   web       2 minutes ago   Up 2 minutes   0.0.0.0:8080->80/tcp
intita_php   intita/php:8.4-fpm   "docker-php-entrypoi…"   php       2 minutes ago   Up 2 minutes   9000/tcp

Важливо

Перший запуск docker compose up -d --build триває кілька хвилин і потребує інтернету: Docker завантажує базові образи і встановлює розширення PHP. Наступні запуски — секунди.

Детальніше: docs.docker.com/compose.

Після docker compose up -d обидва контейнери мають статус Up, але http://localhost:8080 не відкривається. У docker-compose.yml для web записано ports: - "80:8080". Де помилка?

Підсумок

  • Docker запускає програми в контейнерах, створених з образів; Dockerfile — рецепт образу.
  • Docker Compose описує все середовище одним файлом: у нас сервіси web (nginx, опублікований порт 8080) і php (PHP-FPM 8.4, порт 9000 усередині мережі).
  • Головні команди: docker compose up -d --build, docker compose ps, docker compose logs, docker compose down.

Що далі

Наступна лекція — «Шлях запиту, шляхи до файлів і IDE»: як запит проходить крізь контейнери і де лежать файли.