local-cluster-manager

Local Cluster Manager to umiejętność do zarządzania lokalnym klastrem multigres. Pozwala uruchamiać i zatrzymywać komponenty (multipooler, pgctld, multiorch, multigateway), przeglądać logi, łączyć się z bazą danych za pomocą psql oraz testować kopie zapasowe S3. Narzędzie wspiera również operacje na całym klastrze — inicjalizację, sprawdzanie statusu, konfigurację obserwacyjności (OTel, Grafana, Prometheus) i zarządzanie topologią poolerów. Idealne dla deweloperów pracujących z infrastrukturą multigres na lokalnej maszynie.

1. Zainstaluj umiejętność w swoim środowisku Claude/Copilot, wskazując repozytorium multigres oraz ścieżkę .claude/skills/mt-local-cluster. Upewnij się, że masz dostęp do binarki ./bin/multigres w katalogu projektu.

2. Aby uruchomić cały klaster, poproś asystenta: "Uruchom klaster multigres". Narzędzie wykonuje polecenie ./bin/multigres cluster start i zwraca status wszystkich komponentów.

3. Jeśli chcesz sprawdzić aktualny stan klastra lub poszczególnych komponentów, użyj polecenia status. Możesz również wyświetlić topologię multipoolerów (role PRIMARY/REPLICA) oraz sprawdzić, czy instancje PostgreSQL są w trybie recovery.

4. Aby połączyć się z multipooler lub multigateway za pomocą psql, poproś asystenta o połączenie, podając nazwę komponentu. Narzędzie pobiera konfigurację z ./multigres_local/multigres.yaml i automatycznie cachuje ją dla szybszego dostępu.

5. Do testowania kopii zapasowych S3 użyj poleceń: inicjalizuj klaster z S3, twórz kopie zapasowe, wyświetlaj listę kopii lub przywracaj dane. Asystent obsługuje również konfigurację i rozwiązywanie problemów z ustawieniami S3.

6. Aby zatrzymać klaster, użyj polecenia stop. Jeśli chcesz usunąć wszystkie dane i zacząć od nowa, dodaj flagę --clean. Do pełnego resetowania stosu (klaster + obserwacyjność) poproś o teardown i restart.