Strona może być nieaktualna
Nikt jej nie zmieniał od 17 miesięcy (ostatni commit: 2025-06-11, Dariusz Bąkowski). Jeśli opisuje stan, którego już nie ma, zgłoś ją jako nieaktualną.
Index
Wymagania¶
- go > 1.23.8
- docker, docker compose
Co to robi?¶
- Tworzy środowisko do testów integracji współdzielonej bazy dla klienta neuca
- Wprowadza testy integracyjne dla rozwiązania współdzielonej bazy dla klienta neuca (/tests/main_test.go)
Na czym ogólnie polega integracja z klientem neuca?¶
Sprawdź dokumentacje w DOC.MD
Jak wygląda środowisko testowe?¶
- Środowisko testowe wykorzystuje kontenery dockera
- Tworzy dwa kontenery gdzie w pierwszym z nich mamy bazę apollo a w drugim bazę dla neuca z widokami dla klienta
- Inicjalizuje uproszczony schemat apollo (init-apollo.sql)
- Inicjalizuje schemat bazy dla neuca (init-neuca.sql)
- Inicjalizuje reszte tabel i widoków w skrypcie napisanym w
go(lib/sql/)
UWAGA: Część tabel jest inicjalizowana przy starcie dockera (3. i 4.). Wynika to z początkowych decyzji działania tego toola i tego, że niektóre tabele musimy tworzyć z usera
postgresa inne z useraobservera jeszcze inne z userapostgresale na bazie neuca. W przyszłości myślę, że można przenieść inicjalizowanie całej struktury wyłącznie do skryptu wgo
Jak stworzyć nowe środowisko testowe?¶
- Wykonaj:
Jak dostać się do bazy apollo w kontenerze?¶
- Wykonaj:
UWAGA: user może być dowolnie wybrany np. observer
Jak dostać się do bazy neuca w kontenerze?¶
- Wykonaj:
UWAGA: user może być dowolnie wybrany np. observer
Jak wyczyścić środowisko testowe?¶
- Wykonaj:
Jak uruchomić testy?¶
- W konsoli:
UWAGA: Aktualnie testowe dane do bazy są hardkodowane i zadziałają z domyślnymi ustawieniami kontenerów (TODO)
UWAGA2: Testy zakładają, że baza danych jest w pełni zinicjalizowana (istnieją tabelki, widoki itp.). Patrz
Jak stworzyć nowe środowisko testowe?
Czy mogę uruchomić testy na produkcji?¶
Testy sprawdzające schemat można uruchomić bo nie modyfikują danych ani struktur. Innych testów nie polecam w tym momencie wykonywać. Natomiast w przyszłości moglibyśmy stworzyć test-set dla produkcji.
Referencje¶
W go korzystamy z dwóch zewnętrznych bibliotek:
1. Biblioteka Cobra jako framework dla aplikacji konsolowych (cli)
2. Biblioteka pgx jako driver dla bazy postgresql
Linki: - https://github.com/spf13/cobra - https://github.com/jackc/pgx - https://go.dev/
Można korzystać z Makefile: - https://en.wikipedia.org/wiki/Make_(software)
Znane problemy¶
- Czasami gdy czyścimy i tworzymy środowisko na nowo pojawia się taki błąd:
[+] Running 3/3 ✔ Network neuca-shared-db-integration_neuca-integration-network Created 0.7s ✔ Container neuca-integration-apollo-db Started 24.4s ✔ Container neuca-integration-neuca-db Started 25.8s Waiting for databases to be ready... Services started. Apollo DB on :5433, Neuca DB on :5434 go run . init-apollo 2025/06/10 12:10:31 failed to connect to host=localhost port=5433 dbname=apollo user=observer password=observer_pass sslmode=disable database: failed to connect to `user=observer database=apollo`: [::1]:5433 (localhost): failed to receive message: read tcp [::1]:53060->[::1]:5433: read: connection reset by peer 127.0.0.1:5433 (localhost): failed to receive message: read tcp 127.0.0.1:36554->127.0.0.1:5433: read: connection reset by peer exit status 1 make: *** [Makefile:27: init-apollo] Error 1
Wystarczy powtórzyć komendę make dev. Błąd prawdopodobnie wynika z niedostatecznego czekania po czyśczeniu istniejącego
środowiska i przed inicjalizacją nowego środowiska.
Ostatnia zmiana: 2025-06-11 · Dariusz Bąkowski
Zbudowano: 2026-11-20 10:32 UTC · wersja 1.0.0 · rewizja: 19fcdc12e