Skip to main content

Quickstart

Как получить токен​

Внимание! Токен генерируется на 2 часа и его следует регулярно обновлять для продолжения работы.​

  1. Проходим регистрацию на на сайте и подтверждаем свою почту
  2. Идем в консоль, генерируем токен и копируем в буфер нажатием Copy
  3. Экспортируем токен в консоль:
export NWS_API_TOKEN=<token>

Как проверить токен​

  1. Используя curl
curl -H "Authorization: Bearer ${NWS_API_TOKEN}" https://api.nws.neurodyne.pro/version
  1. Используя CLI
nws check-token

Установка CLI​

  1. Загружаем CLI отсюда
  2. Распаковываем и сохраняем в bin:
unzip nws-cli_<version>_linux_amd64.zip
sudo mv nws-cli_<version> /usr/local/bin/nws
  1. Экспортируем и проверяем токен в консоли:
export NWS_API_TOKEN=<token>
  1. Проверяем токен
nws check-token

CLI vs Terraform​

Мы предоставляем возможность управления NWS Cloud разными способами:

  • CLI
  • Terraform
  • UI
  • API

Ниже приведена сравнительная таблица с рекомендациями о применении:

КритерийCLITerraformUIAPI
Простота✅❌✅❌
Язык настройкиyaml, json, tomlHCLUIOAPI3, Protobuf
Для начинающих✅❌✅❌
Быстро попробовать / потестить✅❌✅❌
Для когоВсеDevOpsВсеDevelopers
Малые деплои (< 10 сервисов | < 3 envs)✅❌✅❌
Большие деплои (>= 10 сервисов | >= 3 envs)❌✅✅❌
Малые команды (< 5 чел)✅❌✅❌
Средние и большие команды ( > 5 чел)❌✅✅❌
Сохраниние состояния❌✅❌✅
Уникальные фичиList, NukeTeam work, S3 backend, auto wiringПростой и наглядныйИнтеграция с бизнес логикой

Установка Terraform​

  1. Скачиваем последнюю версию Terraform для своей OS с сайта HashiCorp или отсюда
  2. Распаковываем и копируем в /usr/local/bin.
  3. Проверяем доступность: terraform -v

Hello World CLI​

После установки CLI и получения токена, пробуем деплоить ресурсы EKS следуя примерам на понде.

Hello World Terraform​

После установки Terraform и получения токена, пробуем деплоить ресурс Friends следуя примерам на понде.

Пример полного деплоя приложения на EKS​

Cookbook​

Примеры кода, демо и рекомендации для CLI и Terraform можно найти на понде