Przejdź do treści

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?

  1. Tworzy środowisko do testów integracji współdzielonej bazy dla klienta neuca
  2. 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?

  1. Środowisko testowe wykorzystuje kontenery dockera
  2. Tworzy dwa kontenery gdzie w pierwszym z nich mamy bazę apollo a w drugim bazę dla neuca z widokami dla klienta
  3. Inicjalizuje uproszczony schemat apollo (init-apollo.sql)
  4. Inicjalizuje schemat bazy dla neuca (init-neuca.sql)
  5. 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 postgres a inne z usera observer a jeszcze inne z usera postgres ale na bazie neuca. W przyszłości myślę, że można przenieść inicjalizowanie całej struktury wyłącznie do skryptu w go

Jak stworzyć nowe środowisko testowe?

  1. Wykonaj:
    make dev
    

Jak dostać się do bazy apollo w kontenerze?

  1. Wykonaj:
    make apollo-shell user=postgres
    

UWAGA: user może być dowolnie wybrany np. observer

Jak dostać się do bazy neuca w kontenerze?

  1. Wykonaj:
    make neuca-shell user=postgres
    

UWAGA: user może być dowolnie wybrany np. observer

Jak wyczyścić środowisko testowe?

  1. Wykonaj:
    make clean 
    

Jak uruchomić testy?

  1. W konsoli:
    go run . tests -v
    

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

  1. 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