Во всем проекте, включая этот файл, заменить (с учетом регистра):

1. Строку Boilerplate-Nest-12345 на название проекта в человеко-читаемом виде
2. Строку boilerplatenest12345 на название проекта в gitlab - для путей в файловой системе, для ссылок и пр.

yarn

Пример создания пользователя и базы данных для проекта

1. Создание пользователя и БД

su postgres -c "createuser -h postgres boilerplatenest12345_admin && createdb -h postgres boilerplatenest12345"

2. Установка пароля и выдача прав

psql -U postgres -h postgres -c "alter user \"boilerplatenest12345_admin\" with encrypted password '123'; grant all privileges on database \"boilerplatenest12345\" to \"boilerplatenest12345_admin\";"

1. Скопировать файл .env.sample в .env
2. Исправить параметры по-умолчанию в файле .env
3. Сгенерировать уникальные строки и установить их для AUTH_JWT_ACCESS_SECRET_KEY и AUTH_JWT_REFRESH_SECRET_KEY

В src/main.ts для конфигурации IRestAppModuleConfig в массив cors.allowDomains добавить домены, которые будут иметь возможность совершать cross-origin запросы. Обычно это нужно для разработки, и указываются там домены frontend, frontend-admin и других сервисов.

1. Создать миграции

yarn cli migrate:generate

2. Применить миграции

yarn cli migrate

yarn start:dev

или

yarn start:debug

1. Сборка

yarn build

2. Запуск

yarn start:prod

Эндпоинт для проверки работоспособности: GET /api/v1/health (указан в Swagger'е)

Приложение может отдавать стандартные метрики NodeJS в формате Prometheus. Метрики отдаются по адресу GET /api/v1/metrics.

В Grafana просматривать метрики можно на NodeJS Application Dashboard

Доступ к эндпоинту защищен токеном. Для того чтобы включить отдачу метрик, необходимо добавить переменную окружения APP_METRICS_TOKEN с уникальной сгенерированной строкой. В дальнейшем эту же строку нужно использовать при конфигурации Prometheus для получения метрик с приложения.

Пример конфигурации Prometheus для получения метрик, с учетом того, что Prometheus в Docker, NodeJS приложение работает на порту 9360 в хост системе, а ключ APP_METRICS_TOKEN равен vXsNqGs3VvGQ5eA8fDfu:

  - job_name: 'nodejs-app'
    metrics_path: '/api/v1/metrics'
    authorization:
        credentials: 'vXsNqGs3VvGQ5eA8fDfu'
    static_configs:
      - targets: ['host.docker.internal:9360']

1. Настроить на сервере базу данных
2. Создать папку проекта, в ней папку config
3. В этой папке заполнить файл .env нужными значениями переменных
4. Переименовать файл .gitlab-ci.sample.yml в .gitlab-ci.yml
5. Файл .gitlab-ci.yml проверить на корректность, закомментировать перезапуск процесса PM2
6. Запустить выгрузку
7. Установить процесс в PM2 (см. пункт нижу)
8. В файле .gitlab-ci.yml раскомментировать перезапуск процесса PM2

1. Раскомментировать относящиеся к prod блоки в .gitlab-ci.yml
2. Откорректировать их при необходимости

1. Скопировать ./ecosystem.config.sample.js в файл ecosystem.config.js папку config на сервере
2. Отредактировать при необходимости
3. Запустить pm2 start ecosystem.config.js для добавления конфига проекта в PM2
4. Запустить pm2 save для сохранения изменений в PM2

1. Запустить команду для добавления конфига проекта в PM2

pm2 --name=boilerplatenest12345-nest-backend --cwd=/var/www/boilerplatenest12345 --log=/var/www/boilerplatenest12345/files/nest-backend-out.log start dist/main.js

2. Запустить pm2 save для сохранения изменений в PM2