Go to file
mag37 5a722e6d40
Merge pull request #12 from nnmalex/main
Merge fixes compatibility with value from `com.docker.compose.project.config_files` not giving full path in some cases, probably due to old `docker-compose` binary.

Thank you **nnmalex** for finding and contributing!
2023-02-09 19:30:32 +01:00
dockcheck_docker-run_ver.sh quickfix 2023-02-02 10:13:46 +01:00
dockcheck.sh Update dockcheck.sh 2023-02-09 12:03:27 +00:00
dupc_function.sh Update dupc_function.sh 2023-01-23 12:05:22 +01:00
example.gif new example 2023-02-09 10:48:20 +01:00
README.md Update README.md 2023-02-04 13:10:03 +01:00

dockcheck

A script checking updates for docker images without the need of pulling - then optionally auto-update chosen containers.

With the help of regctl. This is just a concept for inspiration, use with care.


Dependencies:

Running docker (duh) and compose, either standalone or plugin.
regctl by regclient (will ask to download regctl if not in PATH or PWD)


dockcheck.sh

$ ./dockcheck.sh -h
Syntax:     dockcheck.sh [OPTION] [part of name to filter]
Example:    dockcheck.sh -a ng

Options:
-h     Print this Help.
-a|y   Automatic updates, without interaction.
-n     No updates, only checking availability.

Basic example:

$ ./dockcheck.sh
. . .
Containers on latest version:
glances
homer

Containers with updates available:
0) ALL
1) adguardhome
2) syncthing
3) whoogle-search


Do you want to update? y/[n] y
What containers do you like to update? 
Enter number(s) separated by comma: 1,3

Then it proceedes to run pull and up -d on every container with updates.

And with -n No updates and gl for *gl* filtering:

$ ./dockcheck.sh -n gl
. . .
Containers with updates available:
whoogle-search

Containers on latest version:
glances

No updates installed, exiting

🪲 Squashed Bugs:

  • No options for running without updates or auto update.
  • No filter to check only specific containers.
  • Faulty registry checkups stopped the updates completely.
  • No clear checks to skip containers producing errors.
  • Multi-digest images didn't correctly check with registry, giving false positives on updates.
  • Not working with filenames other than docker-compose.yml
  • Lists are not alphabetically sorted (due to stacks and other parameters)
  • Old docker-compose binary-check sometimes returned false error
  • Stacks gets updated as whole, even if only one service is chosen.

🔨 Known issues

  • No granular choice of what to update (except initial name filter).
  • No detailed error feedback (just skip + list what's skipped) .

dockcheck_docker-run_ver.sh

Alternative version for people who use docker run and no composes.
docker run dont support using new images just by restarting a container.
Containers need to be stopped, removed and created again to run on the new image.

dupc_function.sh

Function to quickly check for updates on a single contianer or list of containers by name. Without the need of pulling.
Preferably placed in .bashrc or similar. Example:

$ dupc ng
Updates available for local_nginx.
nginx_reverse is already latest.
Updates available for paperless-ng.

Also check out a spinoff brother-project Palleri/dockcheck-web for a WebUI-front!


Special Thanks:

🦬 t0rnis
🐆 Palleri