Collection of cookbooks for Podman Quadlets
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
Nicolas Massé 5828e563f8 documentation 10 months ago
..
config WiP 10 months ago
other WiP 10 months ago
Makefile WiP 10 months ago
README.md documentation 10 months ago
keycloak-build.timer WiP 10 months ago
keycloak.build WiP 10 months ago
keycloak.container WiP 10 months ago
keycloak.target WiP 10 months ago
overlay.bu WiP 10 months ago

README.md

Podman Quadlet: Keycloak

Overview

Keycloak is an open source identity and access management server started as a Podman Quadlet. It provides single sign-on (SSO), identity brokering, and user federation capabilities.

This cookbook:

  • Builds a custom Keycloak container image locally for optimized startup.
  • Runs Keycloak with PostgreSQL as the database backend (requires the postgresql cookbook).
  • Includes a timer to periodically rebuild the container image.
  • Includes health checks to monitor the service status.

Prerequisites

  • The postgresql cookbook must be installed and running.
  • Configuration file /etc/quadlets/keycloak/config.env must exist.

Usage

In a separate terminal, follow the logs.

sudo make tail-logs

Install the Podman Quadlets and start Keycloak.

sudo make clean install

You should see the keycloak-build.service building the optimized Keycloak container image. Then, the keycloak.service should start up after waiting for PostgreSQL to be available.

Verify Keycloak is running:

curl -sSf http://127.0.0.1:8080/health

Restart the keycloak.target unit.

sudo systemctl restart keycloak.target

Finally, remove the quadlets, their configuration and their data.

sudo make uninstall clean

Integration tests

sudo make test