CloudRouterAdvanced/docs/DEPLOYMENT_SUMMARY.md

Deployment Summary — VK Cloud PROD (4 роутера)

Дата: 2026-09-07 · Статус: развёрнуто и проверено пользователем · Коммиты: 8886c1b, e7bdc46, +horizontal scale-out до 4 роутеров

Что развёрнуто

flowchart TB
    INET(("Internet"))

    subgraph R1["router1 · 95.163.209.37"]
        R1p1["priv1: 10.90.0.12"]
        R1p2["priv2: 10.90.0.21"]
    end
    subgraph R2["router2 · 95.163.209.99"]
        R2p1["priv1: 10.90.0.5"]
        R2p2["priv2: 10.90.0.28"]
    end
    subgraph R3["router3 · 95.163.209.23"]
        R3p1["priv1: 10.90.0.13"]
        R3p2["priv2: 10.90.0.29"]
    end
    subgraph R4["router4 · 95.163.208.228"]
        R4p1["priv1: 10.90.0.6"]
        R4p2["priv2: 10.90.0.22"]
    end

    INET --- R1
    INET --- R2
    INET --- R3
    INET --- R4

    NET1[("priv1 network\n10.90.0.0/28")]
    NET2[("priv2 network\n10.90.0.16/28")]

    R1p1 --- NET1
    R2p1 --- NET1
    R3p1 --- NET1
    R4p1 --- NET1
    R1p2 --- NET2
    R2p2 --- NET2
    R3p2 --- NET2
    R4p2 --- NET2

ВМ	Публичный IP (WAN)	priv1 (10.90.0.0/28)	priv2 (10.90.0.16/28)
router1	95.163.209.37	10.90.0.12	10.90.0.21
router2	95.163.209.99	10.90.0.5	10.90.0.28
router3	95.163.209.23	10.90.0.13	10.90.0.29
router4	95.163.208.228	10.90.0.6	10.90.0.22

Каждая ВМ — 3 сетевых интерфейса (1 внешний + 2 приватных), flavor STD3-4-4, keypair mcs_ru, образ Ubuntu 24.04. Приватные адреса назначены Neutron IPAM автоматически (без ручного вычисления — см. ниже, почему).

terraform apply (изначальный, 3 роутера): 19 added, 0 changed, 0 destroyed. terraform apply (горизонтальное масштабирование до 4 роутеров, только router_count = 3 → 4 в terraform.tfvars): 3 added, 0 changed, 0 destroyed — только router4 и его 2 приватных порта, остальные 3 роутера не затронуты.

Задача и её реализация

Требование	Как реализовано
Количество роутеров (изначально 3, масштабировано до 4)	router_count в terraform/terraform.tfvars
3 порта на роутер (1 внешний + 2 приватных)	1 динамический внешний порт + dynamic "network" по числу private_network_cidrs
Каждый приватный порт — в своей подсети	vkcs_networking_network/subnet по for_each на каждый CIDR
Размер приватной подсети /28	private_network_cidrs = ["10.90.0.0/28", "10.90.0.16/28"]
Только роутеры (без демо-сегмента)	priv_srv_01/02/03, lan_net, private_sg удалены из main.tf
Только Terraform, без Ansible	Ansible-плейбук не запускался (осознанное решение, зафиксировано в памяти)

Что пришлось исправить по пути (реальные баги, найдены при живом деплое)

1. provider "vkcs" отсутствовал вовсе — username/password/project_id/region были объявлены, но ни к чему не подключены. Добавлен provider-блок + переменные auth_url, user_domain_name.
2. SSH-keypair не существовал под сервисным аккаунтом (Nova keypair'ы — per-user, не per-project). Добавлен vkcs_compute_keypair, регистрирующий ключ из var.ssh_public_key.
3. Коллизия IP на приватных портах — ручной расчёт fixed_ip конфликтовал со служебным портом VKCS (network:dns), автоматически создаваемым в каждой сети. Убрано ручное вычисление IP — адрес назначает Neutron IPAM (гарантированно без коллизий).
4. image_id на верхнем уровне ресурса ВМ при boot-from-volume — по документации провайдера так делать нельзя: Nova возвращает служебную строку вместо UUID образа, из-за чего Terraform считал это дрейфом и пересоздавал уже созданные ВМ при каждом plan. image_id оставлен только внутри block_device.
5. /29 оказался слишком тесным — с учётом служебных портов платформы. Заменено на /28.

Подробности каждого фикса — в docs/changes/2026-09-06-provider-auth-wiring-*.md и docs/changes/2026-09-07-router-only-deployment-*.md.

Верификация

• venv/bin/pytest terraform/tests -v → 56 passed (офлайн, без обращения к облаку).
• Реальные terraform init/plan/apply против VK Cloud — успех, подтверждено пользователем вручную после развёртывания.