Docker Compose

​

Обзор

​

Системные требования

• ОЗУ: Убедитесь, что в вашей среде не менее 2 ГБ ОЗУ. Недостаток памяти может вызвать сбой процессов.
• Docker и Docker Compose: убедитесь, что оба установлены и обновлены.

​

Вариант 1: Скрипт с одной строкой

bash <(curl -sL https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/scripts/install.sh)

VERSION=vx.y.z BRANCH=branch-name bash <(curl -sL https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/scripts/install.sh)

• Замените x.y.z на желаемый номер версии.
• Замените branch-name на имя ветки, которую вы хотите установить.

​

Вариант 2: Ручные шаги

​

Шаг 1: Настройте файл среды

1. Создайте файл .env Скопируйте пример файла окружения в новый .env файл в вашем рабочем каталоге:
   curl -o .env https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-docker/.env.example
   
2. Сгенерируйте ключ шифрования Выполните следующую команду для генерации уникальной случайной строки:
   openssl rand -base64 32
   
   Внимание: держите это значение в секрете / не делитесь им. Потеря ENCRYPTION_KEY означает потерю доступа ко всем секретам, хранящимся в базе данных (OAuth-токены, переменные приложения, TOTP-секреты и т. д.).
3. Обновите файл .env Замените значение плейсхолдера в вашем файле .env на сгенерированный токен:
   ENCRYPTION_KEY=random_string
   
   См. руководство по ротации ключей для получения инструкций по их ротации без простоя.
4. Установите пароль для Postgres Обновите значение PG_DATABASE_PASSWORD в файле .env, используя надежный пароль без специальных символов.
   PG_DATABASE_PASSWORD=my_strong_password
   

​

Шаг 2: Получите файл Docker Compose

curl -o docker-compose.yml https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-docker/docker-compose.yml

​

Шаг 3: Запустите приложение

docker compose up -d

​

Шаг 4: Доступ к приложению

curl http://localhost:3000

​

Конфигурация

​

Открыть доступ к Twenty из внешней сети

​

Понимание SERVER_URL

• Протокол: используйте http или https в зависимости от вашей настройки.
  • Используйте http, если SSL не настроен.
  • Используйте https, если SSL настроен.
• Домен/IP: это имя домена или IP-адрес, где ваше приложение доступно.
• Порт: указывайте номер порта, если вы не используете порты по умолчанию (80 для http, 443 для https).

​

Требования к SSL

​

Настройка SERVER_URL

1. Определите ваш URL-адрес доступа
   • Без обратного прокси (Прямой доступ): Если вы получаете доступ к приложению напрямую без использования обратного прокси:
     SERVER_URL=http://your-domain-or-ip:3000
     
   • С обратным прокси (Стандартные порты): Если вы используете обратный прокси, такой как Nginx или Traefik, и у вас настроен SSL:
     SERVER_URL=https://your-domain-or-ip
     
   • С обратным прокси (Не стандартные порты): Если вы используете нестандартные порты:
     SERVER_URL=https://your-domain-or-ip:custom-port
     
2. Обновите файл .env Откройте ваш файл .env и обновите SERVER_URL:
   SERVER_URL=http(s)://your-domain-or-ip:your-port
   
   Примеры:
   • Прямой доступ без SSL:
     SERVER_URL=http://123.45.67.89:3000
     
   • Доступ через домен с SSL:
     SERVER_URL=https://mytwentyapp.com
     
3. Перезапустите приложение Для применения изменений перезапустите контейнеры Docker:
   docker compose down
   docker compose up -d
   

​

Рассмотрения

• Конфигурация обратного прокси: Убедитесь, что ваш обратный прокси передаёт запросы на правильный внутренний порт (3000 по умолчанию). Настройте завершение SSL и все необходимые заголовки.
• Настройки брандмауэра: Откройте необходимые порты в вашем брандмауэре для обеспечения внешнего доступа.
• Последовательность: Значение SERVER_URL должно соответствовать тому, как пользователи обращаются к вашему приложению в своих браузерах.

​

Сохранение данных

• Тома данных: Конфигурация Docker Compose использует тома для сохранения данных базы данных и хранилища сервера.
• Среды без состояния: Если развёртывание осуществляется в бесстатном окружении (например, некоторых облачных сервисах), настройте внешнее хранилище для сохранения данных.

​

Резервное копирование и восстановление

​

Создание резервной копии базы данных

docker exec twenty-postgres pg_dump -U postgres twenty > backup_$(date +%Y%m%d).sql

​

Автоматизируйте ежедневное резервное копирование

0 2 * * * docker exec twenty-postgres pg_dump -U postgres twenty > /backups/twenty_$(date +\%Y\%m\%d).sql

​

Восстановление из резервной копии

1. Остановите приложение:

docker compose stop server worker

2. Восстановите базу данных:

docker exec -i twenty-postgres psql -U postgres twenty < backup_20240115.sql

3. Перезапустите службы:

docker compose up -d

​

Лучшие практики резервного копирования

• Регулярно проверяйте восстановление — убедитесь, что резервные копии действительно работают
• Храните резервные копии вне площадки — используйте облачное хранилище (S3, GCS и т. д.)
• Шифруйте конфиденциальные данные — защищайте резервные копии с помощью шифрования
• Храните несколько копий — сохраняйте ежедневные, еженедельные и ежемесячные резервные копии

​

Устранение неполадок

​

Управляемый хостинг