Docker on Ponfertato

Hugo: Архитектура статических сайтов и CI/CD

Mon, 01 Jan 0001 00:00:00 +0000

Использование Hugo для генерации статических сайтов позволяет достичь максимальной производительности при минимальных накладных расходах. Все проекты на стеке *.potatoenergy.ru используют единую методологию сборки, конфигурации и деплоя.

Ключевые принципы:

🔹 Декларативная конфигурация через hugo.toml и config/_default/
🔹 Мультиязычность через translationKey без дублирования логики
🔹 Наследование параметров через cascade во фронтматтере
🔹 Оптимизация ассетов через Hugo Pipes (минификация, фолбэки, хеширование)
🔹 Изоляция окружения сборки через Docker

🗂 Структура проекта
#

project/
├── config/_default/
│ ├── hugo.toml # Базовые настройки: baseURL, theme, outputs
│ ├── params.toml # Глобальные параметры темы и кастомные переменные
│ ├── menus.toml # Конфигурация навигации
│ └── languages.*.toml # Локализация: displayName, copyright, author
├── content/
│ ├── {section}/
│ │ ├── _index.{ru,en}.md # Страница-листинг с описанием раздела
│ │ └── {slug}/
│ │ ├── index.{ru,en}.md # Контент с переводом через translationKey
│ │ └── assets/ # Ресурсы, привязанные к странице
│ └── _index.{ru,en}.md # Главная страница
├── layouts/
│ ├── _default/ # Шаблоны по умолчанию: single.html, list.html
│ ├── partials/ # Переиспользуемые компоненты: head, footer, svg
│ ├── shortcodes/ # Кастомные шорткоды: audio, toggle, icon
│ └── shortcodes/ # Переопределение шаблонов темы (при необходимости)
├── static/ # Файлы, копируемые «как есть»: robots.txt, favicons
├── assets/ # Исходники для Hugo Pipes: CSS/JS для сборки
└── docker-compose.yml # Окружение для локальной разработки

🌐 Мультиязычность без дублирования
#

Связь переводов реализуется через translationKey во фронтматтере:

Source-серверы на ARM64: Docker-образы для игр

Mon, 01 Jan 0001 00:00:00 +0000

Серия Docker-образов для запуска серверов на базе Source Engine на архитектурах ARM64 (Orange Pi, Raspberry Pi 4/5, AWS Graviton).

Репозиторий	Игра	Теги	Размер образа
garrysmod-docker	Garry’s Mod	`latest`	~2.1 GB
tf2-docker	Team Fortress 2	`latest`	~1.8 GB
css-docker	Counter-Strike: Source	`latest`	~1.6 GB
l4d2-docker	Left 4 Dead 2	`latest`	~2.3 GB
hl2dm-docker	Half-Life 2: Deathmatch	`latest`	~1.5 GB
dods-docker	Day of Defeat: Source	`latest`	~1.6 GB
l4d-docker	Left 4 Dead	`latest`	~2.0 GB

Все образы используют единую архитектуру сборки и конфигурации.

Много проектов. Одна структура. Никакого хаоса.

Mon, 01 Jan 0001 00:00:00 +0000

Когда проектов становится больше десяти, начинаются вопросы:

Где лежит конфиг для этого сервиса?
Какую переменную окружения нужно задать при деплое?
Почему один контейнер «ест» всю память, а другой молчит при падении?
Как быстро развернуть всё это на новой машине?

Ответ: единая структура, единые правила, единый подход.

🗂 Единая структура репозиториев
#

Каждый активный проект следует одному шаблону:

project-name/
├── compose.yaml # Единый формат: сервисы, сети, volumes, лимиты
├── stack.env # Переменные окружения (в .gitignore)
├── README.md # Кратко: что делает, как запустить, какие порты
├── .github/
│ └── workflows/ # CI: сборка, тесты, деплой (если нужно)
└── (опционально)
 ├── Dockerfile # Если нужен кастомный образ
 ├── config/ # Конфиги приложений (не секреты)
 └── scripts/ # Утилиты: бэкап, миграция, проверка

Почему это работает:

Эволюция Docker-конфигураций: от разрозненных контейнеров к управляемым стекам

Mon, 01 Jan 0001 00:00:00 +0000

Раньше каждый сервис жил в отдельном репозитории с минимальным docker-compose.yml:

# Старый подход: garrysmod-server/
services:
 garrysmod-server:
 image: ceifa/garrysmod:latest
 ports:
 - "27015:27015"
 volumes:
 - ./garrysmod:/data
 restart: unless-stopped

Проблемы:

❌ Нет контроля ресурсов - один сервис мог «съесть» всю память
❌ Нет health checks - упавший сервис не детектировался
❌ Нет лог-ротации - логи росли до заполнения диска
❌ Нет изоляции сетей - все сервисы в default сети
❌ Обновление каждого сервиса вручную - высокий риск человеческой ошибки

Новый подход: стеки с явными контрактами
#

Теперь связанные сервисы группируются в единый репозиторий с общей конфигурацией:

Docker on Ponfertato

Hugo: Архитектура статических сайтов и CI/CD

🗂 Структура проекта #

🌐 Мультиязычность без дублирования #

Source-серверы на ARM64: Docker-образы для игр

Много проектов. Одна структура. Никакого хаоса.

🗂 Единая структура репозиториев #

Эволюция Docker-конфигураций: от разрозненных контейнеров к управляемым стекам

Новый подход: стеки с явными контрактами #

🗂 Структура проекта
#

🌐 Мультиязычность без дублирования
#

🗂 Единая структура репозиториев
#

Новый подход: стеки с явными контрактами
#