diff --git a/docs/assets/versatiles-logo.png b/docs/assets/versatiles-logo.png new file mode 100644 index 0000000..1d60cce Binary files /dev/null and b/docs/assets/versatiles-logo.png differ diff --git a/docs/assets/versatiles-map-example.jpeg b/docs/assets/versatiles-map-example.jpeg new file mode 100644 index 0000000..626d56d Binary files /dev/null and b/docs/assets/versatiles-map-example.jpeg differ diff --git a/docs/services/versatiles.md b/docs/services/versatiles.md new file mode 100644 index 0000000..74075db --- /dev/null +++ b/docs/services/versatiles.md @@ -0,0 +1,66 @@ +# Versatiles + +![Versatiles Logo](../assets/versatiles-logo.png) + +[Versatiles](https://versatiles.org) is a a free stack for generating and serving vector tiles based on [OpenStreetMap](https://openstreetmap.com) data. + + +## Dependencies + +This service requires the following other services: + +- a [Traefik](traefik.md) reverse-proxy server + + +## Configuration + +To enable this service, add the following configuration to your `vars.yml` file and re-run the [installation](../installing.md) process: + +```yaml +######################################################################## +# # +# versatiles # +# # +######################################################################## + +versatiles_enabled: true + +versatiles_hostname: tiles.example.com + +######################################################################## +# # +# /versatiles # +# # +######################################################################## +``` + +In the example configuration above, we configure the service to be hosted at `https://tiles.example.com/`. + + +## Usage + +After installation, you should be able to access your new Versatiles instance at: `https://tiles.example.com`. + +![Map of Dresden](../assets/versatiles-map-example.jpeg) + + +To embed the map in a website Copy & Paste the following snippet and replace `tiles.example.com` with your `versatiles_hostname`. + +```html + + + + + +
+ + + +``` + +For adjustments, check out the amazing [examples from maplibre](https://maplibre.org/maplibre-gl-js/docs/examples/). diff --git a/docs/supported-services.md b/docs/supported-services.md index 1d152f4..3ecd465 100644 --- a/docs/supported-services.md +++ b/docs/supported-services.md @@ -84,8 +84,9 @@ | [Tandoor](https://docs.tandoor.dev/) | The recipe manager that allows you to manage your ever growing collection of digital recipes.| [Link](services/tandoor.md) | [Telegraf](https://www.influxdata.com/time-series-platform/telegraf/) | An open source server agent to help you collect metrics from your stacks, sensors, and systems. | [Link](services/telegraf.md) | | [Traefik](https://doc.traefik.io/traefik/) | A container-aware reverse-proxy server | [Link](services/traefik.md) | -| [Vaultwarden](https://github.com/dani-garcia/vaultwarden) | A lightweight unofficial and compatible implementation of the [Bitwarden](https://bitwarden.com/) password manager | [Link](services/vaultwarden.md) | | [Uptime-kuma](https://uptime.kuma.pet/) | A fancy self-hosted monitoring tool | [Link](services/uptime-kuma.md) | +| [Vaultwarden](https://github.com/dani-garcia/vaultwarden) | A lightweight unofficial and compatible implementation of the [Bitwarden](https://bitwarden.com/)password manager | [Link](services/vaultwarden.md) | +| [Versatiles](https://versatiles.org) | A free stack for generating and serving vector tiles from OpenStreetMap. | [Link](services/versatiles.md) | | [Wetty](https://github.com/butlerx/wetty) | An SSH terminal over HTTP/HTTPS | [Link](services/wetty.md) | | [WireGuard Easy](https://github.com/wg-easy/wg-easy) | The easiest way to run [WireGuard](https://www.wireguard.com/) VPN + Web-based Admin UI. | [Link](services/wg-easy.md) | | [Forgejo](https://forgejo.org/) | An alternative fork of Gitea. Easy and painless self-hosted git server. | [Link](services/forgejo.md) | diff --git a/templates/group_vars_mash_servers b/templates/group_vars_mash_servers index 4b3bf55..aad0149 100644 --- a/templates/group_vars_mash_servers +++ b/templates/group_vars_mash_servers @@ -5478,6 +5478,41 @@ uptime_kuma_container_labels_traefik_tls_certResolver: "{{ traefik_certResolver_ +# role-specific:versatiles +######################################################################## +# # +# versatiles # +# # +######################################################################## + +versatiles_enabled: false + +versatiles_identifier: "{{ mash_playbook_service_identifier_prefix }}versatiles" + +versatiles_uid: "{{ mash_playbook_uid }}" +versatiles_gid: "{{ mash_playbook_gid }}" + +versatiles_base_path: "{{ mash_playbook_base_path }}/{{ mash_playbook_service_base_directory_name_prefix }}versatiles" + +versatiles_container_additional_networks_auto: | + {{ + ([mash_playbook_reverse_proxyable_services_additional_network] if mash_playbook_reverse_proxyable_services_additional_network else []) + }} + +versatiles_container_labels_traefik_enabled: "{{ mash_playbook_traefik_labels_enabled }}" +versatiles_container_labels_traefik_docker_network: "{{ mash_playbook_reverse_proxyable_services_additional_network }}" +versatiles_container_labels_traefik_entrypoints: "{{ traefik_entrypoint_primary }}" +versatiles_container_labels_traefik_tls_certResolver: "{{ traefik_certResolver_primary }}" + +######################################################################## +# # +# /versatiles # +# # +######################################################################## +# /role-specific:versatiles + + + # role-specific:wg_easy ######################################################################## # # diff --git a/templates/requirements.yml b/templates/requirements.yml index c1505f1..f7f45c2 100644 --- a/templates/requirements.yml +++ b/templates/requirements.yml @@ -395,6 +395,10 @@ version: v1.32.0-0 name: vaultwarden activation_prefix: vaultwarden_ +- src: git+https://github.com/moan0s/ansible-role-versatiles.git + version: v0.12.6-1 + name: versatiles + activation_prefix: versatiles_ - src: git+https://github.com/spatterIight/ansible-role-wetty.git version: v2.5-0 name: wetty diff --git a/templates/setup.yml b/templates/setup.yml index fff822f..277481d 100644 --- a/templates/setup.yml +++ b/templates/setup.yml @@ -423,6 +423,10 @@ - role: galaxy/woodpecker_ci_server # /role-specific:woodpecker_ci_server + # role-specific:versatiles + - role: galaxy/versatiles + # /role-specific:versatiles + # role-specific:woodpecker_ci_agent - role: galaxy/woodpecker_ci_agent # /role-specific:woodpecker_ci_agent