Epic 4
Utworzenie centralnego miejsca do przechowywania dokumentacjiless than a minute
🎯 Cel epiki
Celem tego epika jest kompleksowe opracowanie i wdrożenie systemu dokumentacji technicznej dla projektów realizowanych w ramach organizacji rachuna-net. Dokumentacja ma być publikowana w nowym repozytorium pl.rachuna-net/docs, hostowana pod domeną rachuna-net.pl i dostępna w nowoczesnej, łatwej do aktualizacji formie, z wykorzystaniem gohugo.
Zakres prac obejmuje:
- Utworzenie dedykowanych repozytoriów dla dokumentacji i kontenerów wspierających proces publikacji.
- Stworzenie kontenera hugo oraz zautomatyzowanego procesu publikacyjnego.
- Integrację z domeną rachuna-net.pl w celu zapewnienia publicznego dostępu do dokumentacji.
- Integrację GitLab Pages z domeną rachuna-net.pl jako mechanizmu publikacji statycznej dokumentacji.
- Uzupełnienie brakujących sekcji dokumentacyjnych dotyczących projektów infrastrukturalnych, CI/CD oraz kontenerów.
- Realizacja tego epika zapewni ustandaryzowaną, centralną i łatwo dostępną platformę dokumentacyjną wspierającą rozwój oraz utrzymanie systemów i infrastruktury w organizacji.
Przygotowanie grup i repozytoriów za pomocą Terraform
- ✅ Definicja repozytorium pl.rachuna-net/docs
- ✅ Definicja repozytorium pl.rachuna-net/containers/hugo
Przygotowanie kontenera do procesu Gitlab CI
- ✅ Wydanie obrazu kontenerowego gohugo v1.0.0
Przygotowanie procesu CI/CD
- ✅ Stworzenie procesu do publikacji strony z użyciem gitlab pages
Publikacja gitlab-pages i integracja z domeną
- ✅ Integracja z gitlab-pages zbudowane na mkdocs z domeną rachuna-net.pl