salt-states_old/podman/README.md

podman and container state

Will install the following packages:

• podman

It will set linger for the user running the podman containers (default user: root) and create user systemd units for that user, create systemd unit files as user and start them.

Each container must have its own state file, named <container-name>.sls and placed in the podman state folder.

podman pillars:

podman:
  user: <podman user, default root if not defined>

container pillars:

containers:
  <container name>:
    image: <path to container image>
    tag: <image tag>
    volumes:
      <volume name>: <mount path>
    env:
      <environment varable name>: <value>
    ports:
      - host: <port number>
      - container: <port number>

Example

podman:
  user: foo
containers:
  mariadb:
    image: docker.io/library/mariadb
    tag: latest
    volumes:
      data: /var/lib/mysql
    env:
      MYSQL_ROOT_PASSWORD: verysecretpassword
    ports:
       - host: 3306
         container: 3306
       - host: 1234
         container 4321
         protocol: udp

Steps done in above example:

• install podman
• set linger for user foo
• Create a firewald service for mariadb and add port 3306/tcp and 1234/ucp
• add mariadb firewalld service to pillar.container.zone (default is public)
• Create container controle script /home/foo/bin/mariadb.sh
• create podman volume named mariadb-data
• Create a podman container named mariadb
• Create systemd unit file for container mariadb named mariadb.service
• start mariadb service

Each container will have a script wrapper for the service and container.

Usage mariadb.sh [options..]
-h,-?, --help           Show help and exit
-p, --pull              pull container image (mariadb:latest)
-v, --volumes           create container volumes
-c, --create            create mariadb containers
-s, --start             start and enables mariadb container
-S, --stop              stop mariadb container
-i, --is-running        check to see if container service is running
-u, --check-update      check if there are image updates avaiable
    --update            perform image update if it exists
-g, --generate-systemd  generate user systemd service unit file