🛠️ Technology Stack Overview¶
Tämä osio kuvaa Repostage & DevCluster -projektissa käytettävät teknologiat, niiden roolit ja perusteet valinnoille. Opiskeluprojektina painopiste on modernien, pilvinatiivien työkalujen hallinnassa.
🏗️ Alustan arkkitehtuurikerrokset¶
Projektin teknologia-stack voidaan jakaa kolmeen pääkerrokseen:
1. Automaatio ja Logiikka (The Engine)¶
Tämä kerros vastaa datan keräämisestä ja prosessoinnista. * Python 3.x: Projektin "moottori". Valittu sen erinomaisten kirjastojen (kuten requests) ja helpon tiedostokäsittelyn vuoksi. * REST APIs (GitLab/GitHub): Lähteet, joista projektien metadata noudetaan. * Bash Scripting: Käytetään ympäristön alustamiseen ja rutiinitehtävien (kuten kansiorakenteen luonnin) automatisointiin.
2. Infrastruktuuri ja Ajoalusta (The Runtime)¶
Tämä kerros tarjoaa sovelluksille suoritusympäristön. * Docker: Sovellusten kontitus, mikä takaa saman toimivuuden kehityksessä ja tuotannossa. * Kubernetes (DevCluster): Konttien orkestrointi, skaalautuvuus ja vikasietoisuus. * Helm: Kubernetes-sovellusten paketinhallinta ja konfigurointi.
3. Dokumentaatio ja Käyttöliittymä (The Frontend)¶
Tämä kerros visualisoi projektin tilan ja hallinnan. * MkDocs: Staattinen sivustogeneraattori, joka muuntaa Markdown-tiedostot ammattimaiseksi dokumentaatioportaaliksi. * Material for MkDocs: Teema, joka tarjoaa modernin UI/UX-kokemuksen ja hakutoiminnot. * Markdown: Dokumentaation kieli, joka mahdollistaa dokumentaation elämisen koodin rinnalla.
🔄 Työnkulku (DevOps Pipeline)¶
Teknologiat on kytketty toisiinsa jatkuvaksi virraksi:
- Koodi: Kehittäjä pushaa muutokset Git-repositoryyn.
- CI/CD (GitLab CI): Putki käynnistyy automaattisesti.
- Ajo: Python-skripti päivittää
AutoEcosystem.md-tiedoston. - Julkaisu: MkDocs rakentaa portaalin ja julkaisee sen GitLab Pagesiin.
📈 Oppimistavoitteet tälle Stackille¶
| Teknologia | Tavoitetaso | Keskeinen opittava asia |
|---|---|---|
| Python | Syventävä | API-integraatiot ja datan muokkaus Markdowniksi. |
| Kubernetes | Perusteet | Podien hallinta ja Ingress-reititys. |
| CI/CD | Soveltava | Automaattinen dokumentaation generointi osana putkea. |
💡 Miksi nämä valinnat?¶
Valitut teknologiat edustavat Industry Standard -ratkaisuja vuonna 2026. Niiden hallinta antaa vahvan pohjan Platform Engineering -tehtäviin ja varmistaa, että dokumentaatio ei ole taakka, vaan osa automatisoitua prosessia.