Настройка standalone агента миграции из Miro

Важно

Доступно с версии Эсборд >= 2025.4.2

Требования

1. Выполнена настройка из инструкции

2. Виртуальные машины для установки образа Miro агента

3. Аккаунт в сервисе Miro, имеющий доступ к доскам внутри команд

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

Характеристика	Минимальные требования	Рекомендуемые требования
Количество CPU	8	10
Оперативная память (RAM)	8 ГБ	16 ГБ
Дисковое пространство (HDD/SDD)*	20 GB	20 GB

Установка Miro агента

1. Создайте в корне папку /miro-agent

mkdir "/miro-agent"

2. Создайте в новой папке файл docker-compose.yml

nano docker-compose.yml

3. Добавьте в docker-compose.yml следующее:

backup-miro-agent:
  image: '${DOCKER_REGISTRY}/miro-agent:${DOCKER_IMAGE_TAG}'
  restart: 'always'
  ports:
    - '37000:3000'
  volumes:
    - './certs:/certs'
  environment:
    AS_AGENT: 'true'
    ON_PREMISE: 'true'

4. Создайте файл .env в папке с docker-compose.yml и укажите в нём переменные окружения. Пример:

MIRO_CLIENT_ID=id # id клиента в созданном приложении Miro
MIRO_CLIENT_SECRET=secret # секрет клиента в созданном приложении Miro
REDIS_HOST=redis # хост для базы данных redis
REDIS_PORT=6379 # порт для базы данных redis
REDIS_PASS=pass # пароль для базы данных redis
BUCKET=example-bucket # название бакета в s3 storage
ACCESS_KEY_ID=access_key_id # айди ключа доступа к s3 storage
SECRET_ACCESS_KEY=secret_access_key # ключ доступа к s3 storage
ENDPOINT=https://storage.s3.com # url для s3 storage
S3_CDN_URL=https://<domain_name>/storage/ # cdn url для s3 storage
POSTGRES_URL=postgresql://user:password@host:5432/db # url подключения к базе данных postgresql, содержит в себе root user, пароль и хост базы
PLAYWRIGHT_BOT_EMAIL=email@test.com # email аккаунта из miro
PLAYWRIGHT_BOT_PASSWORD=123 # пароль аккаунта из miro
AS_AGENT=true
ON_PREMISE=true

5. Авторизуйтесь в Docker registry (запросите ключ авторизации key.json у вашего менеджера)

cat key.json | docker login \
--username json_key \
--password-stdin \
cr.yandex

6. Подтяните образы с Docker registry

docker-compose -f docker-compose.yml pull

Подсказка

Все процедуры, связанные с вызовом docker-compose, следует выполнять в папке с файлом docker-compose.yml

7. Создайте папку /miro-agent/certs

mkdir /miro-agent/certs

9. Положите актуальные SSL сертификат и ключ в папку /miro-agent/certs

Уточнение

Названия файлов должны быть вида:

Сертификат - public.crt
Ключ - private.key

10. Запустите docker-compose

docker-compose -f docker-compose.yml up -d --force-recreate