WLSS frontend

Frontend-приложение для Wish List Sharing Service.

Настройка окружения для разработки

Для запуска приложения требуется установленная Node.js, версия которой указана в package.json в поле engines.

Для установки и использования нескольких Node.js с различными версиями на одном устройстве рекомендуется использовать Node Version Manager.

Установка Node.js с помощью nvm

• Установка Node.js версии 16.20.0 (версия взята для примера, требуемую версию см. в package.json):

nvm install 16.20.0

• Переключение Node.js на версию 16.20.0:

nvm use 16.20.0

Установка зависимостей приложения

• Установка с помощью npm-команды:

npm install

Запуск приложения

Обычный запуск

• Запуск с помощью npm-команды:

npm run start

После запуска приложение будет доступно на localhost:4201. Приложение будет автоматически обновляться после любого сохранения изменений в файлах из скоупа приложения.

Запуск с другим номером порта

• Передача номера порта через аргумент существующему скрипту с помощью npm-команды:

npm run start -- --port 4202

• Передача номера порта в качестве аргумента при запуске с помощью ng-команды - команда доступна, если глобально установлен @angular/cli:

ng serve port 4202

Сборка приложения

• Сборка с помощью npm-команды:

npm run build

• Сборка с помощью ng-команды:

ng build

По окончании выполнения команды сборка появится в папке /dist.

Запуск линтера

• Запуск линтера с помощью npm-команды:

npm run lint

• Запуск линтера с помощью ng-команды:

ng lint

Деплой на тестовое окружение

Запускать деплой могут только пользователи с правом на запись в репозиторий.

1. Перейти на ветку/коммит, который нужно задеплоить

2. Создать и запушить новую версию тэга deployed/qa:

• Запуск деплоя с помощью git-команд:

git tag --annotate --force deployed/qa --message ''

git push origin deployed/qa --force

• Запуск деплоя с помощью npm-команды:

npm run deploy:qa

После того, как будет запушена новая версия тэга, запустится деплой, о прогрессе которого можно узнать в разделе Actions.

Чтобы посмотреть, от какого коммита сделан последний деплой, нужно обновиться до последней версии тэга deployed/qa.

• Актуализация тэга с помощью git-команды:

git fetch origin +refs/tags/deployed/qa:refs/tags/deployed/qa

• Актуализация тэга с помощью npm-команды:

npm run deploy:qa:fetch