DoskaДокументация
Документация / Начало работы

Бесплатные инструменты

Бесплатные онлайн-редакторы схем на Mermaid, D2, nwdiag и из Terraform. Без аккаунта, без загрузки файлов, с выгрузкой SVG и PNG.

У Doska есть четыре бесплатных редактора, которые работают без аккаунта. Напишите код схемы или перетащите файл инфраструктуры, смотрите на картинку прямо во время набора и скачайте её в SVG или PNG. Когда захотите работать над схемой вместе с командой, сохраните её на доску.

РедакторАдресЧто умеет
Mermaid/mermaidБлок-схемы, sequence-диаграммы и облачные схемы architecture-beta с иконками AWS
D2/d2Архитектура с контейнерами, фигурами, иконками AWS и связями
nwdiag/nwdiagСети с диапазонами CIDR, хосты с адресами, иконки маршрутизаторов, коммутаторов, межсетевых экранов и серверов
Terraform/terraformСхема из terraform show -json, манифестов Kubernetes или docker-compose с проверкой сети

Приватность

Всё работает в браузере. Код и файлы читаются на вашем компьютере и никуда не загружаются. Хранится только то, что вы сами сохраните на доску.

Редакторы Mermaid, D2 и nwdiag

Каждый редактор открывается с примером, который можно менять. Схема перерисовывается, как только вы перестаёте печатать, тем же движком раскладки, что и на досках Doska: аккуратные стрелки, группы и облачные иконки. Ошибки показываются под редактором с номером строки.

flowchart LR
  user([Клиент]) --> api[API]
  api --> db[(Заказы)]
  api -.-> mail[Почтовый сервис]
direction: right
user: Клиент { shape: person }
cloud: AWS {
  api: API { icon: aws:lambda }
  db: Заказы { shape: cylinder }
  api -> db: SQL
}
user -> cloud.api
nwdiag {
  network office {
    address = "192.168.1.0/24";
    label = "Офис";
    router [address = "192.168.1.1"];
    nas [address = "192.168.1.20", icon = net:storage];
    laptop [address = "192.168.1.50", icon = net:laptop];
  }
}

Редактор nwdiag ещё и подсвечивает адреса вне диапазона своей сети и один адрес у двух хостов. Синтаксис всех трёх языков — в разделе Диаграммы из кода.

Редактор Terraform

Редактор Terraform превращает файлы инфраструктуры в схему архитектуры.

Бесплатный редактор Terraform: схема справа, проверка сети слева

  1. Откройте /terraform.
  2. Перетащите файл, выберите его или вставьте текст. Подходят вывод terraform show -json или terraform.tfstate, YAML Kubernetes (в том числе вывод helm template) и docker-compose.yml. Размер файла — до 25 МБ. Чтобы сначала посмотреть, как это выглядит, нажмите «Попробовать пример».
  3. Переключайтесь между «Обзором» и «Подробно». В обзоре только основные ресурсы, в подробном виде добавляются security group'ы, таблицы маршрутов, роли и другие вспомогательные ресурсы.
  4. Раскройте «Код схемы (D2)», чтобы увидеть сгенерированный код.

Как получить входной файл:

bash
terraform show -json > state.json
helm template ./chart > manifests.yaml

Проверка сети

Для файлов Terraform блок «Проверка сети» показывает найденные проблемы:

  • SSH, RDP или порты баз данных, открытые всему интернету (0.0.0.0/0);
  • security group'ы, которые пускают интернет на все порты;
  • VPC с пересекающимися диапазонами адресов;
  • подсети вне диапазона своей VPC и пересекающиеся подсети.

На доске есть та же проверка и вдобавок инструмент «Может ли достучаться?». Подробнее — в разделе Схемы из инфраструктуры.

Скачать SVG или PNG

Когда в схеме нет ошибок, нажмите SVG или PNG над картинкой. У скачанных файлов белый фон и небольшая подпись «Made with Doska» внизу. PNG сохраняется в двойном разрешении.

Кнопки масштаба помогают рассмотреть детали, «Вписать» снова показывает схему целиком.

Сохранить на доску

Нажмите «Сохранить на доску», чтобы сохранить схему и работать над ней вместе с другими.

  • Если вы не вошли, Doska предложит создать аккаунт или войти. Схема подождёт в этой вкладке браузера, и доска создастся сразу после входа.
  • Если вы уже вошли, новая доска создаётся сразу.

На доске схема станет настоящими фигурами, которые можно двигать, перекрашивать и комментировать, а код останется синхронным с ними. Из редактора Terraform на доску попадает разобранная схема: имена, типы и связи ресурсов, но не сам файл и не значения из него. Приглашённые коллеги увидят доску и смогут править её вместе с вами в реальном времени.

Заметка

Doska бесплатна. Аккаунт нужен только для того, чтобы хранить схемы на досках и делиться ими.