How mosip/keycloak works
Project type and purpose
• This is an open-source tool and CI/CD kit for building, customizing, and deploying MOSIP-branded Keycloak server images (both Artemis-based and JBoss-based distributions), together with initialization scripts and a Helm chart for Kubernetes.
• The README confirms its scope: “Contains MOSIP customised keycloak image for IAM.”
File structure
• Top-level directories:
• .github: workflows to build & publish on push/tag.
• deploy: shell scripts & YAML for installing/upgrading Keycloak on Kubernetes (e.g., install.sh, import-init.sh).
• helm/keycloak-init: a Helm chart defining a Kubernetes Job (keycloak-init) to seed realms/clients.
• keycloak-artemis: Dockerfile + Bitnami-based filesystem + MOSIP themes + custom SPIs.
• keycloak-jboss: Dockerfile + JBoss-based distribution + MOSIP themes + SPI jar.
• keycloak-init: Python scripts & container to drive realm/user import via Keycloak Admin REST API.
• Build artifacts: Docker images for keycloak-artemis, keycloak-jboss, keycloak-init.
README for additional insights
• Triggers GitHub Actions to build and publish Maven artifacts or Docker images.