Alphabetische lijst van veelgebruikte termen binnen PMA en de bredere context van DevOps en IT infrastructuur.
Definitie: Open-source Identity Provider (IdP) die SSO (Single Sign-On) biedt voor alle PMA services.
Context: Authentik is de centrale authenticatie service binnen PMA. Alle gebruikers loggen in via Authentik en krijgen daarmee toegang tot alle gekoppelde services zonder opnieuw in te loggen.
Gerelateerd: SSO, OAuth, OIDC
Definitie: Het automatisch uitvoeren van taken zonder menselijke interventie.
Context: In PMA wordt automation gerealiseerd via n8n workflows die verschillende services koppelen en processen automatiseren.
Definitie: Een lichtgewicht, standalone uitvoerbare softwarepakket dat alles bevat wat nodig is om code uit te voeren.
Context: Elke PMA service draait in een eigen Docker container, wat zorgt voor isolatie, consistentie en eenvoudige deployment.
Voorbeeld: asd-redmine, asd-authentik
Definitie: Een uitvoerbare instructie in het Just systeem.
Context: Commands in PMA volgen het patroon just <actie> <service>, bijvoorbeeld just start redmine.
Definitie: Platform voor het ontwikkelen, shippen en uitvoeren van applicaties in containers.
Context: Docker vormt de basis van de PMA infrastructuur. Alle 59+ services draaien als Docker containers, beheerd via docker-compose.
Key files:
docker/docker-compose.yml - Service definitiesDefinitie: Een groot werkitem in projectmanagement dat meerdere gerelateerde taken groepeert.
Context: In Redmine (PMA ticketsysteem) worden epics gebruikt om feature ontwikkeling en grote initiatieven te organiseren.
Definitie: Command runner vergelijkbaar met make, maar met een eenvoudigere syntax.
Context: Just is de centrale interface voor alle PMA operaties. Het Justfile definieert alle beschikbare commands.
Voorbeeld commands:
just start SERVICE # Start een service
just stop SERVICE # Stop een service
just status SERVICE # Bekijk status
just health # Check alle services
Definitie: YAML configuratiebestand dat een PMA service definieert.
Context: Elk package heeft een manifest.yaml die de Single Source of Truth (SSOT) is voor service configuratie.
Voorbeeld:
name: redmine
version: "5.1"
container: asd-redmine
port: 9114
sso:
type: rails
Definitie: Management Control Plane - de beschermde interface naar het .asd framework.
Context: De MCP Gateway beschermt kritieke operaties en credentials. Alle .asd operaties moeten via just mcp-asd <command> verlopen.
Waarom: Voorkomt accidentele overschrijving van permanente credentials.
Definitie: Een .just bestand dat commands groepeert voor een specifiek domein of service.
Context: PMA organiseert commands in modules onder scripts/modules/. Elke service heeft een eigen module.
Voorbeeld: scripts/modules/redmine.just, scripts/modules/n8n.just
Definitie: Open-source workflow automation tool met visuele node-gebaseerde editor.
Context: n8n is de automation engine van PMA. Het verbindt services via APIs en automatiseert repetitieve taken.
Mogelijkheden:
Definitie: Open Authorization - protocol voor toegang tot resources zonder credentials te delen.
Context: OAuth 2.0 wordt gebruikt door Authentik om services veilig toegang te geven tot gebruikersidentiteit.
Definitie: OpenID Connect - identiteitslaag bovenop OAuth 2.0.
Context: OIDC breidt OAuth uit met standaard claims voor gebruikersinformatie. Authentik fungeert als OIDC provider.
Verschil met OAuth: OAuth = autorisatie (toegang), OIDC = authenticatie (identiteit).
Definitie: Een gestandaardiseerde service-eenheid in PMA met manifest, configuratie en optionele assets.
Context: Packages bevinden zich in packages/<service>/ en bevatten alles wat nodig is om een service te installeren en configureren.
Structuur:
packages/redmine/
manifest.yaml # Configuratie (SSOT)
config/ # Service-specifieke config
backups/ # Backup storage
Definitie: Open-source projectmanagement en issue tracking applicatie.
Context: Redmine is het centrale ticketsysteem van PMA voor het beheren van taken, bugs en features.
Features:
Definitie: Single Source of Truth - principe waarbij data slechts op een plek wordt gedefinieerd.
Context: In PMA zijn manifest files de SSOT voor service configuratie. Wijzigingen worden alleen daar gemaakt.
Definitie: Single Sign-On - authenticatiemethode waarbij een login toegang geeft tot meerdere systemen.
Context: Alle PMA services zijn gekoppeld aan Authentik SSO. Gebruikers loggen eenmaal in en krijgen toegang tot alle services.
Voordelen:
Definitie: Een werkitem in het issue tracking systeem (Redmine).
Context: In PMA worden tickets gebruikt voor alle werkzaamheden. Het workflow principe is: Geen code zonder ticket.
Lifecycle:
Definitie: Beveiligde verbinding die interne services extern beschikbaar maakt.
Context: PMA gebruikt tunnels (via cloudflared) om services veilig te ontsluiten naar internet zonder directe port exposure.
Definitie: Docker mechanisme voor persistente data opslag buiten containers.
Context: Alle PMA service data wordt opgeslagen in Docker volumes. Dit zorgt ervoor dat data behouden blijft bij container updates.
Naming: docker_{service}-{tenant} (bijv. docker_redmine-default)
Definitie: Een gedefinieerde reeks stappen die een proces automatiseren.
Context: In PMA context verwijst workflow meestal naar n8n workflows - visueel gedefinieerde automatiseringen.
Voorbeeld workflows:
| Term | Categorie | Korte Definitie |
|---|---|---|
| Authentik | Security | Identity Provider / SSO server |
| Container | Infrastructure | Geisoleerde applicatie runtime |
| Docker | Infrastructure | Container platform |
| Epic | Project | Groep gerelateerde tickets |
| Just | Tooling | Command runner |
| Manifest | Configuration | Service definitie (YAML) |
| MCP Gateway | Security | Beschermde management interface |
| Module | Tooling | Groep commands (.just file) |
| n8n | Automation | Workflow automation tool |
| OAuth | Security | Autorisatie protocol |
| OIDC | Security | Authenticatie protocol |
| Package | Configuration | Service installatie-eenheid |
| Redmine | Application | Projectmanagement tool |
| SSOT | Principle | Single Source of Truth |
| SSO | Security | Single Sign-On |
| Ticket | Project | Werkitem in issue tracker |
| Tunnel | Network | Externe service toegang |
| Volume | Infrastructure | Persistente data storage |
| Workflow | Automation | Geautomatiseerd proces |
Navigatie:
Gerelateerd: