Быстрый старт на Windows
Для запуска без Docker используйте Windows Portable.
Установите и запустите Docker Desktop для Windows на компьютере x64. Используйте режим Linux containers. В PowerShell команда
docker infoдолжна показывать сведения о сервере Docker.Скачайте и распакуйте
PilotProAdmin-vX.Y.Z-lite.zipсо страницы релизов. Внутри два файла:README.mdиinstall.ps1. Сверьте SHA-256 архива сSHA256SUMS.txtчерезGet-FileHash.Откройте PowerShell в распакованной папке и выполните:
.\install.ps1Если Windows заблокировала загруженный скрипт, после проверки архива выполните
Unblock-File -LiteralPath .\install.ps1.Ответьте на вопросы установщика. Если порт занят, нажмите Enter, чтобы принять предложенный свободный порт, или укажите свой. Установщик запускает PilotProAdmin и PilotMigration одной версии и выводит адреса сервисов.
Откройте адрес админки из вывода скрипта. В мастере первого входа проверьте адрес GitLab и введите установочный ключ
ADMIN_SETUP_KEYизPilotProAdmin-install\.env. Войдите с Personal Access Token GitLab с правомapi. Затем проверьте адреса контуров Pilot, задайте служебные учётные записи для выкладки из GitLab CI, проверьте адрес Grafana и укажите группы и проекты GitLab.
Откуда взять образы
Lite скачивает PilotProAdmin и PilotMigration из GHCR. Если на целевой машине GHCR недоступен, скачайте также PilotProAdmin-vX.Y.Z-linux-amd64-images.tar.gz и проверьте его по SHA256SUMS-CONTAINERS.txt. Положите архив рядом с install.ps1 или передайте полный путь:
.\install.ps1 -ImageArchive 'D:\Downloads\PilotProAdmin-vX.Y.Z-linux-amd64-images.tar.gz'
Архив содержит оба приложения. Для локального GitLab, статистики и серверов Pilot нужны доступ к их реестрам и зависимости сборщиков либо заранее подготовленные образы. Для полностью офлайн установки полного стенда используйте отдельный комплект стека.
Чистая установка
- Для GitLab выберите существующий экземпляр или установку на этой машине. Для нового GitLab начальный пароль
rootнаходится вGITLAB_ROOT_PASSWORDв.env. Создайте токен с правомapiи группы для нужных типов проектов. Если вход выполняет пользователь без прав администратора GitLab, у него должен быть доступ хотя бы к одной из групп, указанных в мастере. - Для статистики можно подключить Grafana, развернуть локальную Grafana со сборщиками или настроить позже. Локальные сборщики в этой схеме используют PostgreSQL рабочего контура Pilot.
- Для каждого контура Pilot (тест, стейдж, прод) можно подключить существующий сервер, развернуть локальный Pilot-Server с PostgreSQL и RustFS или отложить настройку. Для скачивания образа Pilot может потребоваться доступ к реестру поставщика. Свой образ можно указать через
-PilotImage. Для нового сервера установите лицензию и подключите базу в Pilot-myAdmin. После этого добавьте имя базы к адресу контура в админке. Установка Pilot-Server. - Учётные записи для выкладки модулей из CI можно изменить или отключить в разделе «Настройки». Для работы CI также нужны ключи выкладки в переменных групп GitLab. При подключении внешнего Pilot доступ к PostgreSQL и архивам для PilotMigration настраивается отдельно. Настройка стека и интеграций.
Установка из резервной копии
На исходной машине откройте «Миграция → Подготовить перенос данных» в админке. Скачайте комплект, распакуйте его рядом с доступным Docker Desktop и запустите prepare-transfer.ps1 по инструкции из комплекта. Скрипт напечатает путь к папке с manifest.json.
Выберите восстановление и укажите каталог полной резервной копии с manifest.json, либо передайте его при запуске:
.\install.ps1 -Backup 'D:\Backup\2026-11-18_0300' -InstallDirectory 'D:\PilotProAdmin'
Для восстановления выберите новый каталог установки. Скрипт поднимает локальные GitLab, Grafana со сборщиками и три контура Pilot вместе с PostgreSQL и RustFS. Он берёт версию и редакцию GitLab из имени штатного архива резервной копии. Требования GitLab к восстановлению.
После установки сохраните каталог PilotProAdmin-install или выбранный через -InstallDirectory. В нём остаются Compose, .env с реквизитами и папки данных. Часть данных хранится в томах Docker. При обновлении распакуйте новый lite и запустите установщик с тем же -InstallDirectory. Для переноса кластера используйте инструкцию по кластерной установке.