Сборка и деплой фронтендов

Данная инструкция описывает ручной процесс сборки и деплоя Nuxt 3 фронтендов, пока не внедрён CI/CD. Все фронтенды собираются через Docker и размещаются на Staging сервере в папке /var/www/services/frontend/

Общие требования

• Установлен Docker и Docker Compose
• В наличии актуальные .env и .npmrc файлы в каждой директории фронтенда, если нет, нужно создать их вручную по шаблонам из документации: .env и .npmrc

Шаги деплоя

1. Подключение к серверу

Подключись к серверу по SSH через удобный клиент, например: Termius

2. Перейди в нужную директорию проекта

Примеры директорий:

cd /var/www/services/frontend/admin

3. Удали старые файлы (если есть)

⚠️ Важно: не удаляй .env и .npmrc, они содержат переменные окружения, которые нужны для работы фронтенда

Примечание про .env см. в разделе .env

find . -mindepth 1 -not -name '.env' -not -name '.npmrc' -exec rm -rf {} +

4. Клонируй свежую версию проекта

Пример:

git clone git@gitlab.a-ceramica.ru:aceramica/frontend/nuxt-admin-dashboard.git

5. Перемести файлы из вложенной директории

После клонирования проект окажется в поддиректории, например, nuxt-admin-dashboard. Перенеси содержимое в текущую директорию:

mv nuxt-admin-dashboard/* .

Созданную подпапку можно удалить:

rm -rf nuxt-admin-dashboard

6. Проверь конфиги

Убедись, что:

• .env и .npmrc присутствуют
• .env содержит актуальные переменные окружения
• .npmrc указывает на верный private registry GitLab и указан NPM_TOKEN

7. Сборка проекта и запуск контейнера

Выполни команду запуска Docker-образа с пересборкой:

docker compose up -d --build

8. Проверка деплоя

Убедись, что контейнер поднялся и работает:

docker compose ps

9. Проверь доступность фронта по его URL