Skip to content

Garbage collector for Docker Swarm / Автоматическая сборка мусора для Docker и Docker Swarm

License

Notifications You must be signed in to change notification settings

pdacity/docker_gc

Repository files navigation

Garbage collector for Docker Swarm

Awesome Docker Docker Cloud Build Status Docker stuff PizzaWare Tea powered

About

Image for automatic removing unused Docker Swarm objects. Also works just as Docker Service.

By default these types of objects are deleted:

  • container
  • volume
  • network

Configuration

Set config parameters in the yml file:

  • AGE - the max time for resource to be unused (format: timestamp or Go duration strings (10m, 1h30m))
  • SLEEP - the time frame between checking for unused objects (format: timestamp or Go duration strings (10m, 1h30m))
  • STICKY_LABEL - do not remove image with this label

Building image with STICKY_LABEL

If you need to protect an image from automatic deletion use LABEL directive, for example: persistent_image=true. To do it just create Dockerfile for you image .

FROM <IMAGENAME>
LABEL persistent_image=true

Before run the stack build the image from Dockerfile mentioned above:

docker-compose.yaml

...
  <SERVICENAME>
    container_name: <CONTAINERNAME>
    build:
      context: .
...
  • <IMAGENAME> - the image which is protected from automatic deletion
  • <SERVICENAME> - service name in the stack
  • <CONTAINERNAME> - container name (optionally)

Also you should set STICKY_LABEL: persisten_image=true in the docker_gc run variables

Run

  • docker-stack.yml - to deploy the service in Docker Swarm
  • docker-compose.yml - to run just a Docker Service

Docker Hub

Prebuild docker image on hub.docker.com - https://hub.docker.com/r/pdacity/docker_gc


Сборщик мусора для Docker Swarm и Docker

Docker Cloud Build Status Docker stuff PizzaWare Tea powered

О проекте

Образ для автоматической очистки неиспользуемых обьектов в Docker Swarm (работает и просто как Docker Service )

По умолчанию удаляются следующие типы обьектов:

  • container
  • volume
  • network

Настройка

Для работы необходимо задать параметры yml файле:

  • AGE - срок в формате timestamp или Go duration strings (10m, 1h30m) после которого неиспользуемые ресурсы будут удалены
  • SLEEP - периодичность проверки в формате timestamp или Go duration strings (10m, 1h30m)
  • STICKY_LABEL - не удалять образа с этой меткой

Сборка образа с STICKY_LABEL

В случае если необходимо защитить какой либо из образов от автоматического удаления необходимо добавить к образу label, например persistent_image=true Для этого создайте Dockerfile для образа <IMAGENAME>

FROM <IMAGENAME>
LABEL persistent_image=true

При запуске стека необходимо собрать образ из приведенного выше Dockerfile

docker-compose.yaml

...
  <SERVICENAME>
    container_name: <CONTAINERNAME>
    build:
      context: .
...

где <IMAGENAME> - название образа который должен быть защищен от автоматического удаления, <SERVICENAME> - название сервиса в стеке, <CONTAINERNAME> имя контейнера (опционально)

И задайте STICKY_LABEL: persistent_image=true в переменных запуска docker_gc

Запуск

  • docker-stack.yml - для деплоя сервиса в Docker swarm
  • docker-compose.yml - для запуска Docker Service

Docker Hub

Готовый собранный образ на hub.docker.com - https://hub.docker.com/r/pdacity/docker_gc

Star History

Star History Chart


References: English version of the documentation - https://habr.com/en/users/AlexanderTyutin/

About

Garbage collector for Docker Swarm / Автоматическая сборка мусора для Docker и Docker Swarm

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages