Files

T

Sergey Antropoff baa1f58ad0 Fix CI/pulumi blockers and document test suites with latest PASS results.

Stabilize node status, cluster-wide Ceph OSD ids, and QEMU cpu utilization so
status/list no longer 500 on model strings; align pulumi defaults to pve1;
add bilingual testing docs with the 2026-07-18 ci-all + pulumi-tests pass.

2026-07-18 09:38:28 +03:00

2.7 KiB

Raw Blame History

Language / Язык: English | Русский

Участие в разработке

Спасибо за помощь с лабораторным симулятором Proxmox VE API.

Требования

Docker + Docker Compose
make
Локальный Python для повседневной работы не нужен (инструменты в Compose)

Локальный цикл

cp -n .env.example .env
make install
make up
make seed PROFILE=small
curl -sS http://localhost:8006/health/ready

Основной HTTPS-эндпоинт (как у реального PVE): http://localhost:8006/ (self-signed — curl -sk или принять предупреждение в браузере).

Quality gates (обязательны перед PR)

make ci            # ruff format/check + mypy + offline pytest + surface probe
make ci-all        # ещё integration + proxmoxer compatibility
make helm-lint     # lint chart (+ ingress example values)
make pulumi-tests  # Pulumi surface (majors 6–9) + pulumi-proxmoxve lifecycle

GitHub Actions на каждый push/PR в main запускает make ci и проверку Compose/Helm. Перед крупными API/клиентскими изменениями локально прогоняйте make ci-all, make helm-lint и make pulumi-tests.

Карта наборов, Make-цели и последние записанные локальные результаты: docs/ru/testing.md.

Важные правила проекта

Мутации должны persist в PostgreSQL (таблицы и/или jsonb metadata).
Не добавляйте user-facing сообщения вроде «not supported in the simulator» — см. .cursor/rules/durable-simulator.mdc.
Сохраняйте формы запросов/ответов Proxmox из снимка контракта.
При изменении операторского поведения синхронизируйте EN и RU docs.

Документация

Индекс: docs/README.md · docs/ru/README.md
Безопасность / модель угроз лаборатории: SECURITY.md

Релизы

Maintainers публикуют runtime-образ так:

docker login
make release          # пушит inecs/proxmox-api-simulator:<version> (+ :latest)

После публичного релиза при необходимости вставьте overview из docs/docker-hub-overview.md в описание репозитория Docker Hub.

2.7 KiB Raw Blame History Unescape Escape