Что такое AxonaCloud

AxonaCloud представляет собой self-hosted платформу для синхронизации базы знаний между устройствами и автоматического развертывания инфраструктуры на основе описаний в файлах базы знаний.

Ключевая инновация: Documentation = Infrastructure. Нет разрыва между документацией и реальностью. Что описано в файлах базы знаний — то и работает в production.

Основные компоненты

• Синхронизация - использует Syncthing для P2P синхронизации между устройствами без центрального сервера

• Оркестрация контейнеров - автоматическое развертывание Docker контейнеров из блоков кода в файлах базы знаний

• Сетевая инфраструктура - управление WireGuard VPN, Nginx и Pi-hole через конфигурации в документах (?)

• Автоматизация - интеграция с n8n для создания workflow'ов ( управляемых из базы знаний ?)

• Публикация - автоматическая публикация статических сайтов на Vercel и других платформах (собственных хостинг)

• Мобильный доступ - API для iOS/Android клиентов с режимом "только чтение" для безопасного доступа к базе

Развертывание из кода в документах

Одна из ключевых возможностей AxonaCloud — автоматическое развертывание инфраструктуры на основе блоков кода, описанных непосредственно в файлах базы знаний.

Пример:

Проверка версии Docker:

=begin code :id<reset> :dockerImage<'docker:27-cli'>
#!/bin/sh
echo "   - Docker: $(docker --version 2>/dev/null || echo 'Not available')"
=end code

AxonaCloud парсит такие блоки и автоматически разворачивает соответствующие контейнеры. Это обеспечивает единый источник правды — документация всегда отражает реальное состояние инфраструктуры.

Варианты развёртывания

AxonaCloud может работать на различных типах устройств:

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

Целевая аудитория

• DevOps-инженеры / SRE — инфраструктура описана в тех же файлах, что и design docs

• Indie Hackers / Solo разработчики — простое развертывание сайтов, backend и мониторинга

• Малые команды разработки (5-20 человек) — база знаний становится production infrastructure

• Self-hosters / энтузиасты приватности — управление домашней инфраструктурой через документы

Принципы

Принцип 1: Documentation = Infrastructure

Что описано в файлах базы знаний — то и работает. Нет разрыва между документацией и реальностью.

Принцип 2: Приватность как архитектура

Данные физически не покидают вашу инфраструктуру.

• Никакой телеметрии, никаких облачных зависимостей

• Поддержка air-gapped режима

• Всё работает локально

Принцип 3: Своё железо в приоритете

Все функции работают на вашем железе без внешних сервисов.

• Работает на Raspberry Pi, мини-ПК, ноутбуке, домашнем сервере

• Облачное развёртывание опционально

Принцип 4: Плавная деградация

Если какой-то компонент недоступен, остальные продолжают работать.

• Нет сети? Локальные операции продолжаются

• Нет Docker? Код можно выполнить вручную

• Каждый слой добавляет возможности, не ломая нижние

Принцип 5: Никакой магии

Ничто не выполняется неявно. Хотите автоматизацию — явно укажите :state<active>.

• Блоки кода требуют явной активации

• Синхронизация не запускает код автоматически

• Документ и работающий сервис — разные вещи

Принцип 6: Файлы как источник правды

Текстовые файлы читаемы без AxonaCloud. Никакой привязки к платформе.

• Podlite и Markdown — обычный текст

• Никаких проприетарных форматов

• Экспорт тривиален — просто скопируйте папку

Принцип 7: Разделение ответственности

Каждый компонент делает одно дело хорошо. Никаких монолитных сервисов.

• Syncthing занимается синхронизацией

• Docker занимается выполнением

• AxonaCloud оркестрирует

Спецификации

Глоссарий

База знаний

Коллекция файлов (документы, конфиги, медиа), управляемых AxonaCloud.

Блок кода (Codeblock)

Исполняемый блок кода в документе с атрибутами :id, :dockerImage, :state.

Узел (Node)

Экземпляр AxonaCloud, работающий на устройстве.

Оркестрация

Автоматическое выполнение блоков кода из документов.

Синхронизация

P2P синхронизация файлов между узлами через Syncthing.

Links