From d266d3a0fd1add2c30a92557055f4d26aa4a436a Mon Sep 17 00:00:00 2001 From: ci-bot Date: Sun, 18 Feb 2024 20:21:26 +0000 Subject: [PATCH] [skip ci] automated docs update --- README.md | 147 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 147 insertions(+) diff --git a/README.md b/README.md index 2dacf1a..fb80bd4 100644 --- a/README.md +++ b/README.md @@ -1 +1,148 @@ # xoxys.docker_tidy + +[![Build Status](https://ci.rknet.org/api/badges/ansible/xoxys.docker_tidy/status.svg)](https://ci.rknet.org/repos/ansible/xoxys.docker_tidy) +[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?label=license)](https://gitea.rknet.org/ansible/xoxys.docker_tidy/src/branch/main/LICENSE) + +Setup docker-tidy garbage collector. Keep docker hosts small. + +## Table of content + +- [Requirements](#requirements) +- [Default Variables](#default-variables) + - [dockertidy_dangling_volumes](#dockertidy_dangling_volumes) + - [dockertidy_docker_socket_path](#dockertidy_docker_socket_path) + - [dockertidy_dry_run](#dockertidy_dry_run) + - [dockertidy_exclude_container_label](#dockertidy_exclude_container_label) + - [dockertidy_exclude_container_labels](#dockertidy_exclude_container_labels) + - [dockertidy_exclude_image](#dockertidy_exclude_image) + - [dockertidy_exclude_images](#dockertidy_exclude_images) + - [dockertidy_image](#dockertidy_image) + - [dockertidy_interval](#dockertidy_interval) + - [dockertidy_log_level](#dockertidy_log_level) + - [dockertidy_max_container_age](#dockertidy_max_container_age) + - [dockertidy_max_image_age](#dockertidy_max_image_age) +- [Dependencies](#dependencies) +- [License](#license) +- [Author](#author) + +--- + +## Requirements + +- Minimum Ansible version: `2.10` + +## Default Variables + +### dockertidy_dangling_volumes + +Remove dangling volumes. + +#### Default value + +```YAML +dockertidy_dangling_volumes: false +``` + +### dockertidy_docker_socket_path + +#### Default value + +```YAML +dockertidy_docker_socket_path: /var/run/docker.sock +``` + +### dockertidy_dry_run + +Only log actions, don't cleanup anything. + +#### Default value + +```YAML +dockertidy_dry_run: false +``` + +### dockertidy_exclude_container_label + +Never remove containers with this label `key` or label `key=value`. + +### dockertidy_exclude_container_labels + +#### Default value + +```YAML +dockertidy_exclude_container_labels: [] +``` + +### dockertidy_exclude_image + +Never remove images with this tag. + +### dockertidy_exclude_images + +#### Default value + +```YAML +dockertidy_exclude_images: [] +``` + +### dockertidy_image + +Docker image to use. + +#### Default value + +```YAML +dockertidy_image: thegeeklab/docker-tidy:latest +``` + +### dockertidy_interval + +Interval for the systemd timer. + +#### Default value + +```YAML +dockertidy_interval: daily +``` + +### dockertidy_log_level + +Current log level. + +#### Default value + +```YAML +dockertidy_log_level: warning +``` + +### dockertidy_max_container_age + +Maximum age for a container, containers older than this age will be removed. + +#### Default value + +```YAML +dockertidy_max_container_age: 5 days ago +``` + +### dockertidy_max_image_age + +Maxium age for an image, images older than this age will be removed. + +#### Default value + +```YAML +dockertidy_max_image_age: 3 days ago +``` + +## Dependencies + +None. + +## License + +MIT + +## Author + +[Robert Kaussow](https://gitea.rknet.org/xoxys)