gogs-quadlet

Deploy Gogs as a Podman Quadlet Container

Requirements

• podman - version 4.7.2+

Role Variables

• gogs_quadlet: (dict) - Define the Container image and tag
• gogs_quadlet_volumes: (list) A list of volumes and paths to be monted on the container.
• gogs_quadlet_ports: (list) A list of ports to be published by the gogs container
• gogs_quadlet_psql_volumes: (list) A list of volumes to be mounted on the PostgreSQL container.
• gogs_quadlet_psql: (dict) Define the PostgreSQL container image and ta to used.
• gogs_quadlet_psql_ports: (list) List of ports to be published by PostgreSQL container
• gogs_quadlet_psql_env: (dict) Environment variables binded to the PostgreSQL container.

Dependencies

• container.podman - version 1.11.0+

Example Playbook

• Basic Gogs Deployment:

deploy gogs and postgresql, postgresql user is the same of GOGS_USER by default gogs will be deployed and bind volumes from /srv/gogs created on the host

---
- name: Deploying Gogs
  hosts: server
  gather_facts: false
  vars:
    gogs_quadlet_psql_env:
      TZ: "ETC/UTC'
      POSTGRESQL_PASSWORD: "admin"
      GOGS_PASSWORD: "gogs-admin"
      GOGS_USER: "gogs"
      POSTGRES_DB: "gogs"

  roles:
   - gogs-quadlet

check-out the default variables from main to see the full list of supported values

Developing and Testing

This role was developed using ansible molecule. The use of molecule is optional but recommended.

• Testing:
  Unit tests for checking code regression are available in the tests directory. use the verify or test commands, e.g:

molecule test

while developing use verify instead:

molecule create
molecule verify

License

GPL-2.0-or-later

Author Information

@mrbrandao - Igor Brandão