History

Marty Oehme 6036a91902 Move upstream logic to handler function		2021-08-18 09:43:43 +02:00
..
defaults	Streamline example app variable use	2021-08-01 09:52:07 +02:00
handlers	Move upstream logic to handler function	2021-08-18 09:43:43 +02:00
meta	Implement very naive solution	2021-07-30 00:30:33 +02:00
tasks	Move upstream logic to handler function	2021-08-18 09:43:43 +02:00
templates	Streamline example app variable use	2021-08-01 09:52:07 +02:00
vars	Streamline example app variable use	2021-08-01 09:52:07 +02:00
README.md	Add example app ReadMe	2021-08-01 10:15:18 +02:00

README.md

whoami

A very simple service application stack role which can be used to base other roles off of. Contains only a single deployed image and a couple of simple variables to set.

Variables

whoami_upstream_file_dir: "{{ docker_stack_files_dir }}/{{ stack.name }}"

The on-target directory where the proxy configuration file should be stashed.

whoami_use_https: true

Whether the service should be reachable through http (port 80) or through https (port 443) and provision an https certificate. Usually you will want this to stay true.

whoami_version: latest

The docker image version to be used in stack creation.

Internal variables

stack:
  name: whoami
  compose: "{{ lookup('template', 'docker-stack.yml.j2') | from_yaml }}"

The name of the stack to be provisioned and the compose file to be used. See caddy ReadMe for configuration.

stack_image: "containous/whoami"

The docker hub image to be use in provisioning.

Simple single-container stack repurposing

If basing another single-container 'stack' on it, only the variables in defaults and vars have to be replaced for another fully functioning stack. The fastest way to accomplish this is with rg and sed:

rg 'containous/whoami' --files-with-matches | xargs sed -i 's|containous/whoami|<your-new-docker-image>|g'
rg whoami --files-with-matches | xargs sed -i 's/whoami/wallabag/g'