Docker.Bitrix

Docker.Bitrix позволяет легко и просто поднять инфраструктуру на Docker для любых целей web (например Bitrix CMS).

Введение

Docker.Bitrix запускает демо Битрикса предоставляя готовые сервисы PHP, NGINX, MySQL и многие другие.

Преимущества данной сборки

• Сервис PHP запакован в отдельный образ, чтобы избавить разработчиков от долгого компилирования.
• Остальные сервисы так же "причёсаны" и разворачиваются моментально.
• Ничего лишнего.

Порядок разработки в Windows

Если вы работаете в Windows, то требуется установить виртуальную машину, тестировалось на Ubuntu 18.04. Ваш рабочий проект должен хранится в двух местах, первое - локальная папка с проектами на хосте (открывается в IDE), второе - виртуальная машина (например /var/www/bitrix). Проект на хосте мапится в IDE к гостевой OC.

Автоматическая установка

curl -fsSL https://raw.githubusercontent.com/bitrixdock/bitrixdock/master/install.sh -o install.sh | chmod +x install.sh | sh install.sh

Ручная установка

Ручная установка

Зависимости

• Git

apt-get install -y git

• Docker & Docker-Compose

cd /usr/local/src && wget -qO- https://get.docker.com/ | sh && \
curl -L "https://github.com/docker/compose/releases/download/1.18.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose && \
chmod +x /usr/local/bin/docker-compose && \
echo "alias dc='docker-compose'" >> ~/.bash_aliases && \
source ~/.bashrc

Папки и файл битрикс

mkdir -p /var/www/bitrix && \
cd /var/www/bitrix && \
wget http://www.1c-bitrix.ru/download/scripts/bitrixsetup.php && \
cd /var/www/ && \
git clone https://github.com/bitrixdock/bitrixdock.git && \
cd /var/ && chmod -R 775 www/ && chown -R root:www-data www/ && \
cd /var/www/bitrixdock

Выполните настройку окружения

Скопируйте файл .env_template в .env

cp -f .env_template .env

⚠ Если у вас мак, удалите строчку /etc/localtime:/etc/localtime/:ro из docker-compose

По умолчнию используется nginx, php7, mysql. Настройки можно изменить в файле .env. Также можно задать путь к каталогу с сайтом и параметры базы данных MySQL.

PHP_VERSION=php71          # Версия php
WEB_SERVER_TYPE=nginx      # Веб-сервер nginx/apache
DB_SERVER_TYPE=mysql       # Сервер базы данных mysql/percona
MYSQL_DATABASE=bitrix      # Имя базы данных
MYSQL_USER=bitrix          # Пользователь базы данных
MYSQL_PASSWORD=123         # Пароль для доступа к базе данных
MYSQL_ROOT_PASSWORD=123    # Пароль для пользователя root от базы данных
INTERFACE=0.0.0.0          # На данный интерфейс будут проксироваться порты
SITE_PATH=/var/www/bitrix  # Путь к директории Вашего сайта

Запустите bitrixdock

docker-compose up -d

Чтобы проверить, что все сервисы запустились посмотрите список процессов docker ps. Посмотрите все прослушиваемые порты, должны быть 80, 11211, 9000 netstat -plnt. Откройте IP машины в браузере.

Если у вас всё получилось будем благодарны за звёздочку :) Ошибки ждём в issue Приятной работы!

Как заполнять подключение к БД

Примечание

• По умолчанию стоит папка /var/www/bitrix/
• В настройках подключения требуется указывать имя сервиса, например для подключения к базе нужно указывать "db", а не "localhost". Пример конфига с подклчюением к mysql и memcached.
• Для создания резервной копии (дампа) SQL: mysqldump -udb_user -pdb_password db_name > dump.sql
  • если нужна только схема: mysqldump --no-data > dump.sql
  • если нужны только данные: mysqldump --no-create-info > dump.sql
  • если нужно отключить таблицу : mysqldump --ignore-table=db_name.table_name > dump.sql
  • ключи выше можно комбинировать!!!
• Для скачивания резервной копии (дампа) SQL с удалённого сервера используйте команду: scp -P 22 {server_user}@{server_id}:/home/bitrix/www/dump.sql dump.sql
• Для загрузки резервной копии (дампа) SQL в контейнер используйте команду: cat dump.sql | docker exec -i db mysql -udb_user -pdb_password db_name

// TODO перенести в доп. документацию

Чтобы убить все процессы PHP
kill $(ps aux | grep '[p]hp' | awk '{print $2}')

Чтобы убить все процессы Nginx
kill $(ps aux | grep '[n]ginx' | awk '{print $2}')

Чтобы убить все процессы MySQL
kill $(ps aux | grep '[m]ysql' | awk '{print $2}')

Отличие от виртуальной машины Битрикс

Виртуальная машина от разработчиков битрикс решает ту же задачу, что и BitrixDock - предоставляет готовое окружение. Разница лишь в том, что Docker намного удобнее, проще и легче в поддержке.

Как только вы запускаете виртуалку, Docker сервисы автоматически стартуют, т.е. вы запускаете свой минихостинг для проекта и он сразу доступен.

Если у вас появится новый проект и поменяется окружение, достаточно скопировать чистую виртуалку (если вы на винде), скопировать папку BitrixDock, добавить или заменить сервисы и запустить.

P.S. Виртуальная машина от разработчиков битрикс на Apache, а у нас на Nginx, а он работает намного быстрее и кушает меньше памяти.

Ищем контрибьюторов

Помогите развитию проекта! Требуется закрывать задачи в issue

Пример

Пример реального Docker проекта для Bitrix - Single Node https://github.com/bitrixdock/production-single-node

Ещё один проект с php7 и отправкой почты, взят с боевого проекта, вырезаны пароли, сертификаты и тп https://github.com/bitrixdock/bitrixdock-production

Реальные проекты на основе этих проектов работают годами без проблем если их не трогать )

Для контрибьюторов

// 1. Форкаем оригинальный проект https://github.com/bitrixdock/bitrixdock кнопкой Fork // 2. Клонируем форк себе на компьютер

git clone https://github.com/my_account/bitrixdock
cd bitrixdock

// 3. Создаем новую ветку

git checkout -b myfix

// 4. Создаем upstream на оригинальный проект

git remote add upstream https://github.com/bitrixdock/bitrixdock

// 5. Меняем файлы // 6. Делаем коммит и отправляем правки

git add .
git commit -am "My fixes"
git push -u origin new_branch

// 7. Переходим в свой проект https://github.com/my_account/bitrixdock и жмем кнопку Compare & pull // 8. Описываем какую проблему решает Пул Реквест (не пишите что поменялось, это видно и так по файлам) // 9. Вы прекрасны! ;)