Развёртывание 1С-Битрикс в Docker

Развёртывание 1С-Битрикс в Docker

Официальная позиция Битрикс по Docker: «используйте BitrixVM». На практике это означает, что Docker-развёртывание требует ручной настройки — нет официального образа, нет docker-compose от вендора. Зато даёт воспроизводимую среду, изоляцию зависимостей, и возможность одинаково запускать проект на ноутбуке разработчика, в CI/CD и на production.

Главный нюанс: Битрикс требует конкретные версии PHP (8.1–8.2 для актуальных редакций), специфичные PHP-расширения (iconv, mbstring, gd, opcache, memcached), и запись в файловую систему — что идёт вразрез с принципом immutable containers. Решаемо, но с пониманием компромиссов.

Структура Docker Compose

# docker-compose.yml
version: '3.9'

services:
  nginx:
    image: nginx:1.24-alpine
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./nginx/conf.d:/etc/nginx/conf.d:ro
      - ./nginx/ssl:/etc/nginx/ssl:ro
      - bitrix_files:/var/www/html
    depends_on:
      - php-fpm

  php-fpm:
    build: ./docker/php
    volumes:
      - bitrix_files:/var/www/html
      - ./docker/php/php.ini:/usr/local/etc/php/conf.d/bitrix.ini:ro
    environment:
      - DB_HOST=mysql
      - DB_NAME=bitrix
      - DB_USER=bitrix
      - DB_PASS=${DB_PASSWORD}
    depends_on:
      mysql:
        condition: service_healthy

  mysql:
    image: mysql:8.0
    environment:
      MYSQL_DATABASE: bitrix
      MYSQL_USER: bitrix
      MYSQL_PASSWORD: ${DB_PASSWORD}
      MYSQL_ROOT_PASSWORD: ${DB_ROOT_PASSWORD}
    volumes:
      - mysql_data:/var/lib/mysql
      - ./docker/mysql/my.cnf:/etc/mysql/conf.d/bitrix.cnf:ro
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
      interval: 10s
      timeout: 5s
      retries: 5

  memcached:
    image: memcached:1.6-alpine
    command: memcached -m 512 -I 32m

  elasticsearch:
    image: docker.elastic.co/elasticsearch/elasticsearch:8.11.0
    environment:
      - discovery.type=single-node
      - ES_JAVA_OPTS=-Xms512m -Xmx512m
      - xpack.security.enabled=false
    volumes:
      - es_data:/usr/share/elasticsearch/data

volumes:
  bitrix_files:
  mysql_data:
  es_data:

Dockerfile для PHP-FPM

# docker/php/Dockerfile
FROM php:8.1-fpm-alpine

# Зависимости для расширений
RUN apk add --no-cache \
    freetype-dev libjpeg-turbo-dev libpng-dev libwebp-dev \
    libzip-dev libxml2-dev oniguruma-dev \
    icu-dev libmemcached-dev zlib-dev

# PHP расширения, требуемые Битрикс
RUN docker-php-ext-configure gd \
        --with-freetype --with-jpeg --with-webp \
    && docker-php-ext-install -j$(nproc) \
        gd mbstring opcache pdo_mysql mysqli \
        xml zip intl bcmath exif

# Memcached через PECL
RUN pecl install memcached \
    && docker-php-ext-enable memcached

# Redis через PECL
RUN pecl install redis \
    && docker-php-ext-enable redis

# OPcache
RUN docker-php-ext-install opcache

WORKDIR /var/www/html

# Создаём пользователя с таким же UID как на хосте
ARG UID=1000
RUN adduser -u $UID -D -S -G www-data bitrix
USER bitrix

Конфигурация PHP для Битрикс

; docker/php/php.ini
memory_limit = 256M
upload_max_filesize = 256M
post_max_size = 256M
max_execution_time = 90

; OPcache
opcache.enable = 1
opcache.memory_consumption = 128
opcache.max_accelerated_files = 10000
opcache.validate_timestamps = 1
opcache.revalidate_freq = 2

; Сессии через Memcached
session.save_handler = memcached
session.save_path = "memcached:11211"

Решение проблемы stateful файлов

Битрикс хранит в файловой системе: загруженные файлы (upload/), кэш (bitrix/cache/), конфигурацию (.settings.php). Стратегии:

Named volumes (выше в docker-compose) — данные живут в Docker volume, переживают пересоздание контейнеров. Проблема: перенос данных между хостами требует volume backup.

Bind mounts для данных, named volume для кода:

volumes:
  - ./src:/var/www/html:ro          # код (read-only)
  - uploads_data:/var/www/html/upload  # загрузки
  - cache_data:/var/www/html/bitrix/cache  # кэш

S3 для upload — наиболее cloud-native подход. Битрикс поддерживает S3-совместимые хранилища через модуль. Контейнеры становятся действительно stateless.

CI/CD с Docker

# .github/workflows/deploy.yml (фрагмент)
deploy:
  steps:
    - name: Build PHP image
      run: docker build -t registry.example.com/bitrix-php:${{ github.sha }} ./docker/php

    - name: Push to registry
      run: docker push registry.example.com/bitrix-php:${{ github.sha }}

    - name: Deploy to production
      run: |
        ssh deploy@prod "
          cd /opt/bitrix &&
          docker-compose pull &&
          docker-compose up -d --no-deps php-fpm nginx &&
          docker-compose exec php-fpm php /var/www/html/bitrix/modules/main/cli/healthcheck.php
        "

Специфика production

Логи. Bitrix пишет логи в файлы. В Docker логи должны идти в stdout/stderr для сбора через Docker logging driver:

// /bitrix/php_interface/init.php
define('LOG_FILENAME', 'php://stderr');

Задания по расписанию (агенты). Cron внутри контейнера или отдельный контейнер:

cron:
  build: ./docker/php
  volumes:
    - bitrix_files:/var/www/html
  command: crond -f -d 8

Отладка. Xdebug только в development-сборке:

# docker/php/Dockerfile.dev
FROM registry.example.com/bitrix-php:latest
RUN pecl install xdebug && docker-php-ext-enable xdebug
COPY xdebug.ini /usr/local/etc/php/conf.d/

Сроки

Базовое Docker-окружение для разработки — 2–3 дня. Production-ready конфигурация с CI/CD, мониторингом и S3 для файлов — 7–14 дней.