nicolas
/
podman-quadlet-cookbook
mirror of https://github.com/nmasse-itix/podman-quadlet-cookbook.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
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.
51 Commits
1 Branch
0 Tags
273 KiB
 
 
 
 
 
Branch: main
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'main'
${ noResults }
podman-quadlet-cookbook/cookbooks/traefik/README.md

2.2 KiB
Raw Permalink Blame History

Podman Quadlet: Traefik

Overview

Traefik is a modern HTTP reverse proxy and load balancer started as a Podman Quadlet. It provides automatic service discovery, SSL termination, and routing.

This cookbook:

  • Runs Traefik as a rootless container with minimal privileges.
  • Supports automatic HTTPS with Let's Encrypt integration.
  • Includes health checks to monitor the service status.
  • Stores configuration in /etc/quadlets/traefik/ and state in /var/lib/quadlets/traefik/.
  • Supports automatic container image updates via Podman auto-update.

Configuration

The v3 version of Traefik expects the load its configuration from one (and only one) of the following sources:

  • A static configuration file (e.g. traefik.yaml) mounted into the /etc/traefik of the container.
  • TRAEFIK_* Environment variables.
  • Command-line arguments.

If you want to use a static configuration file, you can place it in /etc/quadlets/traefik/traefik.yaml and it will be mounted into the container. Since it is the default location for Traefik's configuration, no additional configuration is needed.

To use the environment variables, you can set them in the override.conf file for the container. That is to say, you can create the file /etc/containers/systemd/traefik.container.d/override.conf with the following content:

Environment=TRAEFIK_FOO=bar TRAEFIK_BAZ=qux ...

Regarding command-line arguments, you can create the file /etc/containers/systemd/traefik.container.d/override.conf with the following content:

EntryPoint=/usr/local/bin/traefik
Exec=--foo=bar --baz=qux ...

Usage

In a separate terminal, follow the logs.

sudo make tail-logs

Install the Podman Quadlets and start Traefik.

sudo make clean install

You should see the traefik.service starting up.

Verify Traefik is running:

curl -sSf -H 'Host: ping' http://127.0.0.1/

Access the Traefik dashboard (if enabled in configuration):

curl http://127.0.0.1:8080/dashboard/

Restart the traefik.target unit.

sudo systemctl restart traefik.target

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

sudo make uninstall clean

Integration tests

sudo make test