Ga naar inhoud

Onboarding

Nieuw bij Conduction of bij dit platform? Lees in deze volgorde:

  1. Architectuur in vogelvlucht — het landschap en de rode draden (GitOps, namespaces, least privilege).
  2. De architectuurpagina van het platform waar je aan gaat werken (Nextcloud-base of React-base in de navigatie) — start daar altijd bij het architectuur-/index-document van die sectie.
  3. Documentatie-conventies — docs horen bij de Definition of Done; zo schrijf en review je ze.

Praktisch

  • Git hosting: Codeberg, org Conduction. Let op: sommige repos hebben een GitHub-mirror, maar deploys lezen alleen Codeberg.
  • CI: Codeberg Actions op eigen runners — labels con-ci en con-ci-oci, zie de talos-sectie (generieke labels als ubuntu-latest worden niet bediend).
  • Deploy-status inzien: de Argo CD-webinterface draait op https://admin.commonground.nu (inloggen via de organisatie-SSO). Daar zie je per Application de sync- en health-status van alles wat via GitOps is uitgerold — kijken kan iedereen met toegang, wijzigen loopt altijd via Git.
  • Toegang (cluster, Argo CD, Keycloak-admin): via de beheerder — zie de KeyCloak-sectie voor SSO-koppelingen.
  • Wijzigingen: altijd via PR; docs wijzigen mee in dezelfde PR als de code die ze beschrijven.