Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bitrixdock/bitrixdock
BitrixDock - это готовое Docker окружение для Bitrix CMS :dart:
https://github.com/bitrixdock/bitrixdock
bitrix bitrix-cms bitrixdock docker docker-compose
Last synced: about 2 months ago
JSON representation
BitrixDock - это готовое Docker окружение для Bitrix CMS :dart:
- Host: GitHub
- URL: https://github.com/bitrixdock/bitrixdock
- Owner: bitrixdock
- License: mit
- Created: 2017-08-24T11:51:55.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2024-06-23T21:38:29.000Z (3 months ago)
- Last Synced: 2024-07-30T19:40:49.228Z (about 2 months ago)
- Topics: bitrix, bitrix-cms, bitrixdock, docker, docker-compose
- Language: Dockerfile
- Homepage: https://bitrixdock.github.io/bitrixdock/
- Size: 518 KB
- Stars: 522
- Watchers: 39
- Forks: 223
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-bitrix - BitrixDock - Docker-окружение для Bitrix (<a id="tools">Инструменты</a>)
README
# BitrixDock
BitrixDock позволяет легко и просто запускать **Bitrix CMS** на **Docker**.
:warning: **Этот проект, для того чтобы посмотреть демо Битрикса, а не запустить продакшн сайт. Примеры реальных продакшн сайтов ищите внизу страницы.**
## Введение
BitrixDock запускает демо Битрикса предоставляя готовые сервисы PHP, NGINX, MySQL и многие другие.
### Преимущества данной сборки
- Сервис PHP запакован в отдельный образ, чтобы избавить разработчиков от долгого компилирования.
- Остальные сервисы так же "причёсаны" и разворачиваются моментально.
- Ничего лишнего.
## Требования
- Git
- Docker
- Docker Compose v2
## Порядок разработки в Windows
Если вы работаете в Windows, то все заводится на штатном WSL2 + Docker Desktop
Как альтернативный вариант - можно поднять виртуальную машину (через Vagrant, VirtualBox, VMware и тп), тестировалось на Ubuntu 18.04.
Ваш рабочий проект должен хранится в двух местах, первое — локальная папка с проектами на хосте (открывается в IDE), второе — виртуальная машина
(например `/var/www/bitrix`). Проект на хосте мапится в IDE к гостевой OC.
## Автоматическая установка
Для разворачивания на Linux машине
```shell
curl -fsSL https://raw.githubusercontent.com/bitrixdock/bitrixdock/master/install.sh?$(date +%s) -o install.sh && chmod +x install.sh && sh install.sh
```
## Ручная установка
### Выполните настройку окружения
Скопируйте файл `.env_template` в `.env`
```shell
cp -f .env_template .env
```
⚠ Если у вас мак, удалите строчку `/etc/localtime:/etc/localtime/:ro` из docker-compose.yml
По умолчанию используется nginx, php 7.4, mysql. Настройки можно изменить в файле `.env`. Также можно задать путь к каталогу с сайтом и параметры базы данных MySQL.
```dotenv
COMPOSE_PROJECT_NAME=bitrixdock # Имя проекта. Используется для наименования контейнеров
PHP_VERSION=php74 # Версия 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=./www # Путь к директории Вашего сайта
```
Если у вас всё получилось, будем благодарны за звёздочку :)
Ошибки ждём в [issue](https://github.com/bitrixdock/bitrixdock/issues)
Приятной работы!
## Запуск и остановка bitrixdock
### Запуск
```shell
docker compose -p bitrixdock up -d
```
Чтобы проверить, что все сервисы запустились посмотрите список процессов `docker ps`.
Посмотрите все прослушиваемые порты, должны быть 80, 11211, 9000 `netstat -plnt`.
Откройте IP машины в браузере.
### Остановка
```shell
docker compose -p bitrixdock stop
```
### Полное удаление
```shell
docker compose -p bitrixdock down
```
## Как заполнять подключение к БД
## Примечание
- По умолчанию стоит папка `./www` (папка внутри репозиториия)
- В настройках подключения требуется указывать имя docker compose сервиса, например для подключения к базе нужно указывать "db", а не "localhost". Пример [конфига](configs/.settings.php) с подключением к mysql и memcached.
- Для загрузки резервной копии в контейнер используйте команду: `cat /var/www/bitrix/backup.sql | docker exec -i mysql /usr/bin/mysql -u root -p123 bitrix`
- При использовании php74 в production удалите строку с `php7.4-xdebug` из файла `php74/Dockerfile`, сам факт его установки снижает производительность Битрикса и он должен использоваться только для разработки
- Если контейнер php-fpm выдает ошибку "failed to create new listening socket: socket(): Address family not supported by protocol", то необходимо включить поддержку IPv6 в системе. Например в Ubuntu 22.04 — закомментировать строку в конфиге GRUB "GRUB_CMDLINE_LINUX="ipv6.disable=1"
## Отличие от виртуальной машины Битрикс
Виртуальная машина от разработчиков Битрикс решает ту же задачу, что и BitrixDock - предоставляет готовое окружение. Разница лишь в том, что Docker намного удобнее, проще и легче в поддержке.
Как только вы запускаете виртуалку, Docker сервисы автоматически стартуют, т.е. вы запускаете свой минихостинг для проекта и он сразу доступен.
Если у вас появится новый проект и поменяется окружение, достаточно скопировать чистую виртуалку (если вы на винде), скопировать папку BitrixDock, добавить или заменить сервисы и запустить.
P.S.
Виртуальная машина от разработчиков Битрикс на Apache, а у нас на Nginx, а он работает намного быстрее и кушает меньше памяти.
## Использование xdebug.
- Настройки xdebug задаются в `phpXX/php.ini`.
- Для php73, php74 дефолтовые настройки xdebug - коннект на порт `9003` хоста, с которого пришел запрос. В случае невозможности коннекта - фаллбек на `host.docker.internal`.
- При изменении `php.ini` в проекте не забудьте добавить флаг `--build` при запуске `docker-compose`, чтобы форсировать пересборку образа.
# Ищем контрибьюторов
Помогите развитию проекта! Требуется закрывать задачи в [issue](https://github.com/bitrixdock/bitrixdock/issues)
# Пример
Пример реального Docker проекта для Bitrix - Single Node
https://github.com/bitrixdock/production-single-node
Ещё один проект с php7 и отправкой почты, взят с боевого проекта, вырезаны пароли, сертификаты и тп
https://github.com/bitrixdock/bitrixdock-production
Ещё один production проект с memcached композитом, php8.2, почтой и кроном в контейнере и развёрнутым Readme (англ.):
https://github.com/paskal/bitrix.infra
Реальные проекты на основе этих проектов работают годами без проблем если их не трогать )
# Для контрибьюторов
1. Форкаем оригинальный проект https://github.com/bitrixdock/bitrixdock кнопкой Fork
2. Клонируем форк себе на компьютер
```shell
git clone https://github.com/my_account/bitrixdock
cd bitrixdock
```
3. Создаем новую ветку
```shell
git checkout -b myfix
```
4. Создаем upstream на оригинальный проект
```shell
git remote add upstream https://github.com/bitrixdock/bitrixdock
```
5. Меняем файлы
6. Делаем коммит и отправляем правки
```shell
git add .
git commit -am "My fixes"
git push -u origin new_branch
```
7. Переходим в свой проект `https://github.com/my_account/bitrixdock` и жмем кнопку Compare & pull request
8. Описываем какую проблему решает Пул Реквест с кратким описанием, зачем сделано изменение
9. Вы прекрасны! ;)