mirror of
https://github.com/mag37/dockcheck.git
synced 2026-04-18 10:27:54 +00:00
Compare commits
15 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
96a8eda1cb | ||
|
|
aa4c19fead | ||
|
|
0bebe041df | ||
|
|
f1f50c8301 | ||
|
|
3faada230a | ||
|
|
5ef1236e16 | ||
|
|
8b77b917da | ||
|
|
5a722e6d40 | ||
|
|
8b8ac84a44 | ||
|
|
d5c90fb98d | ||
|
|
4302d45033 | ||
|
|
a107c18d5f | ||
|
|
dd64079efd | ||
|
|
27e9663167 | ||
|
|
03a3e49650 |
46
README.md
46
README.md
@@ -1,5 +1,5 @@
|
|||||||
# dockcheck
|
# dockcheck
|
||||||
### A script checking updates for docker images **without the need of pulling** - then optionally auto-update chosen containers.
|
### A script checking updates for docker images **without pulling** - then selectively auto-update some/all containers.
|
||||||
|
|
||||||
With the help of [`regctl`](https://github.com/regclient/regclient). This is just a concept for inspiration, use with care.
|
With the help of [`regctl`](https://github.com/regclient/regclient). This is just a concept for inspiration, use with care.
|
||||||
___
|
___
|
||||||
@@ -8,8 +8,12 @@ ___
|
|||||||
Running docker (duh) and compose, either standalone or plugin.
|
Running docker (duh) and compose, either standalone or plugin.
|
||||||
`regctl` by [regclient](https://github.com/regclient/regclient) (will ask to download `regctl` if not in `PATH` or `PWD`)
|
`regctl` by [regclient](https://github.com/regclient/regclient) (will ask to download `regctl` if not in `PATH` or `PWD`)
|
||||||
___
|
___
|
||||||
|
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
## `dockcheck.sh`
|
## `dockcheck.sh`
|
||||||
```bash
|
```
|
||||||
$ ./dockcheck.sh -h
|
$ ./dockcheck.sh -h
|
||||||
Syntax: dockcheck.sh [OPTION] [part of name to filter]
|
Syntax: dockcheck.sh [OPTION] [part of name to filter]
|
||||||
Example: dockcheck.sh -a ng
|
Example: dockcheck.sh -a ng
|
||||||
@@ -18,14 +22,11 @@ Options:
|
|||||||
-h Print this Help.
|
-h Print this Help.
|
||||||
-a|y Automatic updates, without interaction.
|
-a|y Automatic updates, without interaction.
|
||||||
-n No updates, only checking availability.
|
-n No updates, only checking availability.
|
||||||
|
-r Allow updating images for docker run, wont update the container.
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||

|
|
||||||
|
|
||||||
Basic example:
|
Basic example:
|
||||||
```bash
|
```
|
||||||
$ ./dockcheck.sh
|
$ ./dockcheck.sh
|
||||||
. . .
|
. . .
|
||||||
Containers on latest version:
|
Containers on latest version:
|
||||||
@@ -39,28 +40,18 @@ Containers with updates available:
|
|||||||
3) whoogle-search
|
3) whoogle-search
|
||||||
|
|
||||||
|
|
||||||
Do you want to update? y/[n] y
|
Choose what containers to update:
|
||||||
What containers do you like to update?
|
Enter number(s) separated by comma, [q] to quit: 1,3
|
||||||
Enter number(s) separated by comma: 1,3
|
|
||||||
|
|
||||||
```
|
```
|
||||||
Then it proceedes to run `pull` and `up -d` on every container with updates.
|
Then it proceedes to run `pull` and `up -d` on every container with updates.
|
||||||
|
|
||||||
|
### `-r flag` :warning: disclaimer and warning:
|
||||||
|
**Wont auto-update the containers, only their images. (compose is recommended)**
|
||||||
|
`docker run` dont support using new images just by restarting a container.
|
||||||
|
Containers need to be manually stopped, removed and created again to run on the new image.
|
||||||
|
|
||||||
|
|
||||||
And with `-n` *No updates* and `gl` for `*gl*` filtering:
|
|
||||||
```bash
|
|
||||||
$ ./dockcheck.sh -n gl
|
|
||||||
. . .
|
|
||||||
Containers with updates available:
|
|
||||||
whoogle-search
|
|
||||||
|
|
||||||
Containers on latest version:
|
|
||||||
glances
|
|
||||||
|
|
||||||
No updates installed, exiting
|
|
||||||
```
|
|
||||||
|
|
||||||
### :beetle: Squashed Bugs:
|
### :beetle: Squashed Bugs:
|
||||||
- ~~No options for running without updates or auto update.~~
|
- ~~No options for running without updates or auto update.~~
|
||||||
- ~~No filter to check only specific containers.~~
|
- ~~No filter to check only specific containers.~~
|
||||||
@@ -71,18 +62,13 @@ No updates installed, exiting
|
|||||||
- ~~Lists are not alphabetically sorted (due to stacks and other parameters)~~
|
- ~~Lists are not alphabetically sorted (due to stacks and other parameters)~~
|
||||||
- ~~Old `docker-compose` binary-check sometimes returned false error~~
|
- ~~Old `docker-compose` binary-check sometimes returned false error~~
|
||||||
- ~~Stacks gets updated as whole, even if only one service is chosen.~~
|
- ~~Stacks gets updated as whole, even if only one service is chosen.~~
|
||||||
|
- ~~Path broken occationally (from inspect) - probably due to old docker-compose binary.~~
|
||||||
|
- ~~Script breaks if one of the chosen containers are a `docker run` container.
|
||||||
|
|
||||||
### :hammer: Known issues
|
### :hammer: Known issues
|
||||||
- ~~No granular choice of what to update (except initial name filter).~~
|
- ~~No granular choice of what to update (except initial name filter).~~
|
||||||
- No detailed error feedback (just skip + list what's skipped) .
|
- No detailed error feedback (just skip + list what's skipped) .
|
||||||
|
|
||||||
## `dockcheck_docker-run_ver.sh`
|
|
||||||
### Wont auto-update the containers, only their images. (compose is recommended)
|
|
||||||
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`
|
## `dupc_function.sh`
|
||||||
Function to quickly check for updates on a single contianer or list of containers by name. **Without the need of pulling**.
|
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.
|
Preferably placed in `.bashrc` or similar.
|
||||||
|
|||||||
54
dockcheck.sh
54
dockcheck.sh
@@ -1,5 +1,5 @@
|
|||||||
#!/bin/bash
|
#!/bin/bash
|
||||||
VERSION="v0.1.3"
|
VERSION="v0.1.6"
|
||||||
Github="https://github.com/mag37/dockcheck"
|
Github="https://github.com/mag37/dockcheck"
|
||||||
|
|
||||||
### Check if there's a new release of the script:
|
### Check if there's a new release of the script:
|
||||||
@@ -15,12 +15,14 @@ Help() {
|
|||||||
echo "-h Print this Help."
|
echo "-h Print this Help."
|
||||||
echo "-a|y Automatic updates, without interaction."
|
echo "-a|y Automatic updates, without interaction."
|
||||||
echo "-n No updates, only checking availability."
|
echo "-n No updates, only checking availability."
|
||||||
|
echo "-r Allow updating images for docker run, wont update the container"
|
||||||
}
|
}
|
||||||
|
|
||||||
while getopts "aynh" options; do
|
while getopts "aynrh" options; do
|
||||||
case "${options}" in
|
case "${options}" in
|
||||||
a|y) UpdYes="yes" ;;
|
a|y) UpdYes="yes" ;;
|
||||||
n) UpdYes="no" ;;
|
n) UpdYes="no" ;;
|
||||||
|
r) DrUp="yes" ;;
|
||||||
h|*) Help ; exit 0 ;;
|
h|*) Help ; exit 0 ;;
|
||||||
esac
|
esac
|
||||||
done
|
done
|
||||||
@@ -53,12 +55,15 @@ else
|
|||||||
fi
|
fi
|
||||||
fi
|
fi
|
||||||
### Check docker compose binary:
|
### Check docker compose binary:
|
||||||
if docker compose &> /dev/null ; then
|
if docker compose version &> /dev/null ; then
|
||||||
DockerBin="docker compose"
|
DockerBin="docker compose"
|
||||||
elif docker-compose -v &> /dev/null; then
|
elif docker-compose -v &> /dev/null; then
|
||||||
DockerBin="docker-compose"
|
DockerBin="docker-compose"
|
||||||
|
elif docker -v &> /dev/null; then
|
||||||
|
printf "%s\n" "No docker compose binary available, using plain docker (Not recommended!)"
|
||||||
|
printf "%s\n" "'docker run' will ONLY update images, not the container itself."
|
||||||
else
|
else
|
||||||
printf "%s\n" "No docker compose binary available, quitting."
|
printf "%s\n" "No docker binaries available, exiting."
|
||||||
exit
|
exit
|
||||||
fi
|
fi
|
||||||
|
|
||||||
@@ -74,9 +79,10 @@ done
|
|||||||
### Choose from list -function:
|
### Choose from list -function:
|
||||||
choosecontainers() {
|
choosecontainers() {
|
||||||
while [[ "$ChoiceClean" =~ [A-Za-z] || -z "$ChoiceClean" ]]; do
|
while [[ "$ChoiceClean" =~ [A-Za-z] || -z "$ChoiceClean" ]]; do
|
||||||
printf "What containers do you like to update? \n"
|
read -p "Enter number(s) separated by comma, [q] to quit: " Choice
|
||||||
read -p 'Enter number(s) separated by comma (eg. 1,3,4): ' Choice
|
if [[ "$Choice" =~ [qQnN] ]] ; then
|
||||||
if [ "$Choice" == "0" ] ; then
|
exit 0
|
||||||
|
elif [ "$Choice" == "0" ] ; then
|
||||||
SelectedUpdates=( "${NumberedUpdates[@]:1}" )
|
SelectedUpdates=( "${NumberedUpdates[@]:1}" )
|
||||||
ChoiceClean=$(echo "$Choice" |sed 's/[,.:;]/ /g')
|
ChoiceClean=$(echo "$Choice" |sed 's/[,.:;]/ /g')
|
||||||
else
|
else
|
||||||
@@ -86,8 +92,9 @@ choosecontainers() {
|
|||||||
done
|
done
|
||||||
fi
|
fi
|
||||||
done
|
done
|
||||||
printf "\nYou've SelectedUpdates:\n"
|
printf "\nUpdating containers:\n"
|
||||||
printf "%s\n" "${SelectedUpdates[@]}"
|
printf "%s\n" "${SelectedUpdates[@]}"
|
||||||
|
printf "\n"
|
||||||
}
|
}
|
||||||
|
|
||||||
### Check the image-hash of every running container VS the registry
|
### Check the image-hash of every running container VS the registry
|
||||||
@@ -130,19 +137,36 @@ fi
|
|||||||
### Optionally get updates if there's any
|
### Optionally get updates if there's any
|
||||||
if [ -n "$GotUpdates" ] ; then
|
if [ -n "$GotUpdates" ] ; then
|
||||||
if [ -z "$UpdYes" ] ; then
|
if [ -z "$UpdYes" ] ; then
|
||||||
printf "\n\033[36;1mDo you want to update? y/[n]\033[0m "
|
printf "\n\033[36;1mChoose what containers to update.\033[0m\n"
|
||||||
read UpdYes
|
choosecontainers
|
||||||
[ "$UpdYes" != "${UpdYes#[Yy]}" ] && choosecontainers
|
|
||||||
else
|
else
|
||||||
SelectedUpdates=( "${GotUpdates[@]}" )
|
SelectedUpdates=( "${GotUpdates[@]}" )
|
||||||
fi
|
fi
|
||||||
if [ "$UpdYes" != "${UpdYes#[Yy]}" ] ; then
|
if [ "$UpdYes" == "${UpdYes#[Nn]}" ] ; then
|
||||||
for i in "${SelectedUpdates[@]}"
|
for i in "${SelectedUpdates[@]}"
|
||||||
do
|
do
|
||||||
ContPath=$(docker inspect "$i" --format '{{ index .Config.Labels "com.docker.compose.project.config_files" }}')
|
ContPath=$(docker inspect "$i" --format '{{ index .Config.Labels "com.docker.compose.project.working_dir" }}')
|
||||||
|
ContConfigFile=$(docker inspect "$i" --format '{{ index .Config.Labels "com.docker.compose.project.config_files" }}')
|
||||||
ContName=$(docker inspect "$i" --format '{{ index .Config.Labels "com.docker.compose.service" }}')
|
ContName=$(docker inspect "$i" --format '{{ index .Config.Labels "com.docker.compose.service" }}')
|
||||||
$DockerBin -f "$ContPath" pull "$ContName"
|
### Checking if compose-values are empty - hence started with docker run:
|
||||||
$DockerBin -f "$ContPath" up -d "$ContName"
|
if [ -z "$ContPath" ] ; then
|
||||||
|
if [ "$DrUp" == "yes" ] ; then
|
||||||
|
ContImage=$(docker inspect "$i" --format='{{.Config.Image}}')
|
||||||
|
docker pull $ContImage
|
||||||
|
printf "%s\n" "$i got a new image downloaded, rebuild manually with preferred 'docker run'-parameters"
|
||||||
|
else
|
||||||
|
printf "\n\033[33;1m$i\033[0m has no compose labels, probably started with docker run - \033[33;1mskipping\033[0m\n\n"
|
||||||
|
fi
|
||||||
|
continue
|
||||||
|
fi
|
||||||
|
### Checking if "com.docker.compose.project.config_files" returns the full path to the config file or just the file name
|
||||||
|
if [[ $ContConfigFile = '/'* ]] ; then
|
||||||
|
ComposeFile="$ContConfigFile"
|
||||||
|
else
|
||||||
|
ComposeFile="$ContPath/$ContConfigFile"
|
||||||
|
fi
|
||||||
|
$DockerBin -f "$ComposeFile" pull "$ContName"
|
||||||
|
$DockerBin -f "$ComposeFile" up -d "$ContName"
|
||||||
done
|
done
|
||||||
else
|
else
|
||||||
printf "\nNo updates installed, exiting.\n"
|
printf "\nNo updates installed, exiting.\n"
|
||||||
|
|||||||
@@ -1,144 +0,0 @@
|
|||||||
#!/bin/bash
|
|
||||||
### VERSION v.0.1.1
|
|
||||||
|
|
||||||
### DOCKER RUN - VERSION
|
|
||||||
|
|
||||||
### WARNING WONT REBUILD CONTAINERS - ONLY GRAB NEW IMAGES
|
|
||||||
### If running docker compose, use the main version. (recommended!)
|
|
||||||
|
|
||||||
### Help Function:
|
|
||||||
Help() {
|
|
||||||
echo "Syntax: dockcheck.sh [OPTION] [part of name to filter]"
|
|
||||||
echo "Example: dockcheck.sh -a ng"
|
|
||||||
echo
|
|
||||||
echo "Options:"
|
|
||||||
echo "-h Print this Help."
|
|
||||||
echo "-a|y Automatic updates, without interaction."
|
|
||||||
echo "-n No updates, only checking availability."
|
|
||||||
}
|
|
||||||
|
|
||||||
while getopts "aynh" options; do
|
|
||||||
case "${options}" in
|
|
||||||
a|y) UpdYes="yes" ;;
|
|
||||||
n) UpdYes="no" ;;
|
|
||||||
h|*) Help ; exit 0 ;;
|
|
||||||
esac
|
|
||||||
done
|
|
||||||
shift "$((OPTIND-1))"
|
|
||||||
|
|
||||||
### Set $1 to a variable for later
|
|
||||||
SearchName="$1"
|
|
||||||
|
|
||||||
### Check if required binary exists in PATH or directory:
|
|
||||||
if [[ $(builtin type -P "regctl") ]]; then
|
|
||||||
regbin="regctl"
|
|
||||||
elif [[ -f "./regctl" ]]; then
|
|
||||||
regbin="./regctl"
|
|
||||||
else
|
|
||||||
printf "Required dependency 'regctl' missing, do you want it downloaded? y/[n] "
|
|
||||||
read GetDep
|
|
||||||
if [ "$GetDep" != "${GetDep#[Yy]}" ]; then
|
|
||||||
### Check arch:
|
|
||||||
case "$(uname --machine)" in
|
|
||||||
x86_64|amd64) architecture="amd64" ;;
|
|
||||||
arm64|aarch64) architecture="arm64";;
|
|
||||||
*) echo "Architecture not supported, exiting." ; exit ;;
|
|
||||||
esac
|
|
||||||
curl -L https://github.com/regclient/regclient/releases/latest/download/regctl-linux-$architecture >./regctl
|
|
||||||
chmod 755 ./regctl
|
|
||||||
regbin="./regctl"
|
|
||||||
else
|
|
||||||
printf "%s\n" "Dependency missing, quitting."
|
|
||||||
exit
|
|
||||||
fi
|
|
||||||
fi
|
|
||||||
|
|
||||||
### Numbered List -function:
|
|
||||||
options() {
|
|
||||||
num=0
|
|
||||||
for i in "${NumberedUpdates[@]}"; do
|
|
||||||
echo "$num) $i"
|
|
||||||
((num++))
|
|
||||||
done
|
|
||||||
}
|
|
||||||
|
|
||||||
### Choose from list -function:
|
|
||||||
choosecontainers() {
|
|
||||||
while [[ "$ChoiceClean" =~ [A-Za-z] || -z "$ChoiceClean" ]]; do
|
|
||||||
printf "What containers do you like to update? \n"
|
|
||||||
# options
|
|
||||||
read -p 'Enter number(s) separated by comma (eg. 1,3,4): ' Choice
|
|
||||||
if [ "$Choice" == "0" ] ; then
|
|
||||||
SelectedUpdates=( ${NumberedUpdates[@]:1} )
|
|
||||||
ChoiceClean=$(echo $Choice|sed 's/[,.:;]/ /g')
|
|
||||||
else
|
|
||||||
ChoiceClean=$(echo $Choice|sed 's/[,.:;]/ /g')
|
|
||||||
for s in $ChoiceClean; do
|
|
||||||
SelectedUpdates+=( ${NumberedUpdates[$s]} )
|
|
||||||
done
|
|
||||||
fi
|
|
||||||
done
|
|
||||||
printf "\nYou've SelectedUpdates:\n"
|
|
||||||
printf "%s\n" "${SelectedUpdates[@]}"
|
|
||||||
}
|
|
||||||
|
|
||||||
### Check the image-hash of every running container VS the registry
|
|
||||||
for i in $(docker ps --filter "name=$SearchName" --format '{{.Names}}') ; do
|
|
||||||
printf ". "
|
|
||||||
RepoUrl=$(docker inspect "$i" --format='{{.Config.Image}}')
|
|
||||||
LocalHash=$(docker image inspect "$RepoUrl" --format '{{.RepoDigests}}')
|
|
||||||
RegHash=$($regbin image digest --list "$RepoUrl" 2>/dev/null)
|
|
||||||
# Check if regtcl produces errors - add to GotErrors if so.
|
|
||||||
if [ $? -eq 0 ] ; then
|
|
||||||
if [[ "$LocalHash" = *"$RegHash"* ]] ; then NoUpdates+=("$i"); else GotUpdates+=("$i"); fi
|
|
||||||
else
|
|
||||||
GotErrors+=("$i")
|
|
||||||
fi
|
|
||||||
done
|
|
||||||
|
|
||||||
### Sort arrays alphabetically
|
|
||||||
IFS=$'\n'
|
|
||||||
NoUpdates=($(sort <<<"${NoUpdates[*]}"))
|
|
||||||
GotUpdates=($(sort <<<"${GotUpdates[*]}"))
|
|
||||||
GotErrors=($(sort <<<"${GotErrors[*]}"))
|
|
||||||
unset IFS
|
|
||||||
### Create new Array to use for the numbered list:
|
|
||||||
NumberedUpdates=(ALL "${GotUpdates[@]}")
|
|
||||||
|
|
||||||
### List what containers got updates or not
|
|
||||||
if [ -n "$NoUpdates" ] ; then
|
|
||||||
printf "\n\033[32;1mContainers on latest version:\033[0m\n"
|
|
||||||
printf "%s\n" "${NoUpdates[@]}"
|
|
||||||
fi
|
|
||||||
if [ -n "$GotErrors" ] ; then
|
|
||||||
printf "\n\033[33;1mContainers with errors, wont get updated:\033[0m\n"
|
|
||||||
printf "%s\n" "${GotErrors[@]}"
|
|
||||||
fi
|
|
||||||
if [ -n "$GotUpdates" ] ; then
|
|
||||||
printf "\n\033[31;1mContainers with updates available:\033[0m\n"
|
|
||||||
[ -z "$UpdYes" ] && options || printf "%s\n" "${GotUpdates[@]}"
|
|
||||||
fi
|
|
||||||
|
|
||||||
### Optionally get updates if there's any
|
|
||||||
if [ -n "$GotUpdates" ] ; then
|
|
||||||
if [ -z "$UpdYes" ] ; then
|
|
||||||
printf "\n\033[36;1mDo you want to update? y/[n]\033[0m "
|
|
||||||
read UpdYes
|
|
||||||
[ "$UpdYes" != "${UpdYes#[Yy]}" ] && choosecontainers
|
|
||||||
else
|
|
||||||
SelectedUpdates=( "${GotUpdates[@]}" )
|
|
||||||
fi
|
|
||||||
if [ "$UpdYes" != "${UpdYes#[Yy]}" ] ; then
|
|
||||||
for i in "${SelectedUpdates[@]}"; do
|
|
||||||
ContImage=$(docker inspect "$i" --format='{{.Config.Image}}')
|
|
||||||
docker pull $ContImage
|
|
||||||
printf "%s\n" "$i got a new image downloaded, rebuild manually with preferred 'docker run'-parameters"
|
|
||||||
done
|
|
||||||
else
|
|
||||||
printf "\nNo updates installed, exiting.\n"
|
|
||||||
fi
|
|
||||||
else
|
|
||||||
printf "\nNo updates available, exiting.\n"
|
|
||||||
fi
|
|
||||||
|
|
||||||
exit 0
|
|
||||||
BIN
example.gif
BIN
example.gif
Binary file not shown.
|
Before Width: | Height: | Size: 510 KiB After Width: | Height: | Size: 345 KiB |
Reference in New Issue
Block a user