VKMA CLI
$ npm install -g @redcup/vk-mini-cliМожет пригодиться для вашей CI
$ npm install @redcup/vk-mini-cliДеплой на хостинг статики
Опции
| Переменная | Опция | Описание |
|---|---|---|
| VKMA_APP_ID | --appId | Обязательно. АЙДИ мини-приложения |
| VKMA_ACCESS_TOKEN | --accessToken | Сервисный ключ мини-приложения. Необходим для деплоя через CI и для работы с тестовыми группами локально (временно) |
| VKMA_DEPLOY_GROUP_NAME | --groupName | Название группы для деплоя в тестовую группу. %branch - для подстановки текущей git ветки |
| VKMA_DEPLOY_ENDPOINTS | --endpoints | По-умолчанию: web:index.html,mobile:index.html,mvk:index.html. Точки входа для урлов. |
| VKMA_DEPLOY_ENVIRONMENT | --environment | По-умолчанию: all. Куда подставить урлы. Возможные значения: prod -- только в прод. dev -- только в дев. all -- в оба |
$ vkma deploy --appId <value> [--groupName <value> --accessToken <value>] [--staticPath <value>]
[--environment production|dev|all] [--endpoints <value>]
Туннель
Опции
| Переменная | Опция | Описание |
|---|---|---|
| VKMA_APP_ID | --appId | Обязательно. АЙДИ мини-приложения |
| VKMA_ACCESS_TOKEN | --accessToken | Сервисный ключ мини-приложения. Необходим для туннеля в тестовую группу (временно). |
| VKMA_TUNNEL_GROUP_NAME | --groupName | Название группы для туннеля в тестовую группу. %me - для подстановки имени пользователя |
| PROXY_HOST | --host | По-умолчанию: localhost. Хост вашего dev-сервера |
| PROXY_PORT | --port | По-умолчанию: 3000. Порт вашего dev-сервера |
| PROXY_HTTP_PROTO | --httpProtocol | По-умолчанию: http. Возможные значения: http,https. HTTP протокол вашего dev-сервера |
| PROXY_WS_PROTO | --wsProtocol | По-умолчанию: ws. Возможные значения: ws,wss. WS протокол вашего dev-сервера |
| PROXY_TIMEOUT | --timeout | По-умолчанию: 5000. Таймаут подключения к дев-серверу, в миллисекундах |
$ vkma tunnel [--appId <value>] [--httpProtocol http|https] [--wsProtocol ws|wss] [--host <value>]
[--port <value>] [--timeout <value>] [--groupName <value> --accessToken <value>]
На данный момент API для тестовых групп не поддерживает работу с пользовательским ключом, из-за чего необходимо использовать сервисный ключ приложения. Чтобы это было не так больно: можно создать файл .env.vkma, добавить его в .gitignore, прописать туда VKMA_ACCESS_TOKEN
И с помощью пакета dotenv (или другого аналога) прокидывать переменные
В package.json добавить в scripts следующие команды:
{
"deploy:prod": "vkma deploy --appId=000",
"deploy:stage": "dotenv -e .env.vkma vkma deploy -- --appId=111 --groupName=%branch",
"tunnel": "dotenv -e .env.vkma vkma tunnel -- --appId=111 --groupName=%me"
}Произведет загрузку бандла и установку урлов с подтверждением в приложение 000
Произведет загрузку бандла и создание/обновление группы тестирования с названием текущей git ветки для приложения 111
Произведет поднятие туннеля с вашим локальным хостом и подставит урл в тестовую группу с названием вашей учетной записи ОС