Andreas/watchtower
1
0
Fork 0
mirror of https://github.com/containrrr/watchtower.git synced 2025-12-13 21:56:38 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions

change repo paths

Browse source
This commit is contained in:
Simon Aronsson 2019-04-03 21:02:05 +02:00
parent aaaddc8902
commit ab299b59f8
7 changed files with 26 additions and 26 deletions
Download patch file Download diff file Expand all files Collapse all files

30
README.md
View file

@ -20,14 +20,14 @@ For example, let's say you were running watchtower along with an instance of *ce
$ docker ps $ docker ps
CONTAINER ID IMAGE STATUS PORTS NAMES CONTAINER ID IMAGE STATUS PORTS NAMES
967848166a45 centurylink/wetty-cli Up 10 minutes 0.0.0.0:8080->3000/tcp wetty 967848166a45 centurylink/wetty-cli Up 10 minutes 0.0.0.0:8080->3000/tcp wetty
6cc4d2a9d1a5 v2tec/watchtower Up 15 minutes watchtower 6cc4d2a9d1a5 containrrr/watchtower Up 15 minutes watchtower
``` ```
Every few minutes watchtower will pull the latest *centurylink/wetty-cli* image and compare it to the one that was used to run the "wetty" container. If it sees that the image has changed it will stop/remove the "wetty" container and then restart it using the new image and the same `docker run` options that were used to start the container initially (in this case, that would include the `-p 8080:3000` port mapping). Every few minutes watchtower will pull the latest *centurylink/wetty-cli* image and compare it to the one that was used to run the "wetty" container. If it sees that the image has changed it will stop/remove the "wetty" container and then restart it using the new image and the same `docker run` options that were used to start the container initially (in this case, that would include the `-p 8080:3000` port mapping).
## Usage ## Usage
Watchtower is itself packaged as a Docker container so installation is as simple as pulling the `v2tec/watchtower` image. If you are using ARM based architecture, pull the appropriate `v2tec/watchtower:armhf-<tag>` image from the [v2tec Docker Hub](https://hub.docker.com/r/v2tec/watchtower/tags/). Watchtower is itself packaged as a Docker container so installation is as simple as pulling the `containrrr/watchtower` image. If you are using ARM based architecture, pull the appropriate `containrrr/watchtower:armhf-<tag>` image from the [v2tec Docker Hub](https://hub.docker.com/r/containrrr/watchtower/tags/).
Since the watchtower code needs to interact with the Docker API in order to monitor the running containers, you need to mount */var/run/docker.sock* into the container with the -v flag when you run it. Since the watchtower code needs to interact with the Docker API in order to monitor the running containers, you need to mount */var/run/docker.sock* into the container with the -v flag when you run it.
@ -37,7 +37,7 @@ Run the `watchtower` container with the following command:
docker run -d \ docker run -d \
--name watchtower \ --name watchtower \
-v /var/run/docker.sock:/var/run/docker.sock \ -v /var/run/docker.sock:/var/run/docker.sock \
v2tec/watchtower containrrr/watchtower
``` ```
If pulling images from private Docker registries, supply registry authentication credentials with the environment variables `REPO_USER` and `REPO_PASS` If pulling images from private Docker registries, supply registry authentication credentials with the environment variables `REPO_USER` and `REPO_PASS`
@ -50,7 +50,7 @@ docker run -d \
-e REPO_USER=username \ -e REPO_USER=username \
-e REPO_PASS=password \ -e REPO_PASS=password \
-v /var/run/docker.sock:/var/run/docker.sock \ -v /var/run/docker.sock:/var/run/docker.sock \
v2tec/watchtower container_to_watch --debug containrrr/watchtower container_to_watch --debug
``` ```
Also check out [this Stack Overflow answer](https://stackoverflow.com/a/30494145/7872793) for more options on how to pass environment variables. Also check out [this Stack Overflow answer](https://stackoverflow.com/a/30494145/7872793) for more options on how to pass environment variables.
@ -60,7 +60,7 @@ docker run -d \
--name watchtower \ --name watchtower \
-v /home/<user>/.docker/config.json:/config.json \ -v /home/<user>/.docker/config.json:/config.json \
-v /var/run/docker.sock:/var/run/docker.sock \ -v /var/run/docker.sock:/var/run/docker.sock \
v2tec/watchtower container_to_watch --debug containrrr/watchtower container_to_watch --debug
``` ```
If you mount the config file as described above, be sure to also prepend the url for the registry when starting up your watched image (you can omit the https://). Here is a complete docker-compose.yml file that starts up a docker container from a private repo at dockerhub and monitors it with watchtower. Note the command argument changing the interval to 30s rather than the default 5 minutes. If you mount the config file as described above, be sure to also prepend the url for the registry when starting up your watched image (you can omit the https://). Here is a complete docker-compose.yml file that starts up a docker container from a private repo at dockerhub and monitors it with watchtower. Note the command argument changing the interval to 30s rather than the default 5 minutes.
@ -74,7 +74,7 @@ services:
- "443:3443" - "443:3443"
- "80:3080" - "80:3080"
watchtower: watchtower:
image: v2tec/watchtower image: containrrr/watchtower
volumes: volumes:
- /var/run/docker.sock:/var/run/docker.sock - /var/run/docker.sock:/var/run/docker.sock
- /root/.docker/config.json:/config.json - /root/.docker/config.json:/config.json
@ -89,7 +89,7 @@ By default, watchtower will monitor all containers running within the Docker dae
docker run -d \ docker run -d \
--name watchtower \ --name watchtower \
-v /var/run/docker.sock:/var/run/docker.sock \ -v /var/run/docker.sock:/var/run/docker.sock \
v2tec/watchtower nginx redis containrrr/watchtower nginx redis
``` ```
In the example above, watchtower will only monitor the containers named "nginx" and "redis" for updates -- all of the other running containers will be ignored. In the example above, watchtower will only monitor the containers named "nginx" and "redis" for updates -- all of the other running containers will be ignored.
@ -101,7 +101,7 @@ When no arguments are specified, watchtower will monitor all running containers.
Any of the options described below can be passed to the watchtower process by setting them after the image name in the `docker run` string: Any of the options described below can be passed to the watchtower process by setting them after the image name in the `docker run` string:
```bash ```bash
docker run --rm v2tec/watchtower --help docker run --rm containrrr/watchtower --help
``` ```
* `--host, -h` Docker daemon socket to connect to. Defaults to "unix:///var/run/docker.sock" but can be pointed at a remote Docker host by specifying a TCP endpoint as "tcp://hostname:port". The host value can also be provided by setting the `DOCKER_HOST` environment variable. * `--host, -h` Docker daemon socket to connect to. Defaults to "unix:///var/run/docker.sock" but can be pointed at a remote Docker host by specifying a TCP endpoint as "tcp://hostname:port". The host value can also be provided by setting the `DOCKER_HOST` environment variable.
@ -175,7 +175,7 @@ By default, watchtower is set-up to monitor the local Docker daemon (the same da
```bash ```bash
docker run -d \ docker run -d \
--name watchtower \ --name watchtower \
v2tec/watchtower --host "tcp://10.0.1.2:2375" containrrr/watchtower --host "tcp://10.0.1.2:2375"
``` ```
or or
@ -184,7 +184,7 @@ or
docker run -d \ docker run -d \
--name watchtower \ --name watchtower \
-e DOCKER_HOST="tcp://10.0.1.2:2375" \ -e DOCKER_HOST="tcp://10.0.1.2:2375" \
v2tec/watchtower containrrr/watchtower
``` ```
Note in both of the examples above that it is unnecessary to mount the */var/run/docker.sock* into the watchtower container. Note in both of the examples above that it is unnecessary to mount the */var/run/docker.sock* into the watchtower container.
@ -202,12 +202,12 @@ docker run -d \
--name watchtower \ --name watchtower \
-e DOCKER_HOST=$DOCKER_HOST \ -e DOCKER_HOST=$DOCKER_HOST \
-v $DOCKER_CERT_PATH:/etc/ssl/docker \ -v $DOCKER_CERT_PATH:/etc/ssl/docker \
v2tec/watchtower --tlsverify containrrr/watchtower --tlsverify
``` ```
## Updating Watchtower ## Updating Watchtower
If watchtower is monitoring the same Docker daemon under which the watchtower container itself is running (i.e. if you volume-mounted */var/run/docker.sock* into the watchtower container) then it has the ability to update itself. If a new version of the *v2tec/watchtower* image is pushed to the Docker Hub, your watchtower will pull down the new image and restart itself automatically. If watchtower is monitoring the same Docker daemon under which the watchtower container itself is running (i.e. if you volume-mounted */var/run/docker.sock* into the watchtower container) then it has the ability to update itself. If a new version of the *containrrr/watchtower* image is pushed to the Docker Hub, your watchtower will pull down the new image and restart itself automatically.
## Notifications ## Notifications
@ -246,7 +246,7 @@ docker run -d \
-e WATCHTOWER_NOTIFICATION_EMAIL_SERVER=smtp.gmail.com \ -e WATCHTOWER_NOTIFICATION_EMAIL_SERVER=smtp.gmail.com \
-e WATCHTOWER_NOTIFICATION_EMAIL_SERVER_USER=fromaddress@gmail.com \ -e WATCHTOWER_NOTIFICATION_EMAIL_SERVER_USER=fromaddress@gmail.com \
-e WATCHTOWER_NOTIFICATION_EMAIL_SERVER_PASSWORD=app_password \ -e WATCHTOWER_NOTIFICATION_EMAIL_SERVER_PASSWORD=app_password \
v2tec/watchtower containrrr/watchtower
``` ```
### Notifications through Slack webhook ### Notifications through Slack webhook
@ -266,7 +266,7 @@ docker run -d \
-e WATCHTOWER_NOTIFICATIONS=slack \ -e WATCHTOWER_NOTIFICATIONS=slack \
-e WATCHTOWER_NOTIFICATION_SLACK_HOOK_URL="https://hooks.slack.com/services/xxx/yyyyyyyyyyyyyyy" \ -e WATCHTOWER_NOTIFICATION_SLACK_HOOK_URL="https://hooks.slack.com/services/xxx/yyyyyyyyyyyyyyy" \
-e WATCHTOWER_NOTIFICATION_SLACK_IDENTIFIER=watchtower-server-1 \ -e WATCHTOWER_NOTIFICATION_SLACK_IDENTIFIER=watchtower-server-1 \
v2tec/watchtower containrrr/watchtower
``` ```
### Notifications via MSTeams incoming webhook ### Notifications via MSTeams incoming webhook
@ -286,5 +286,5 @@ docker run -d \
-e WATCHTOWER_NOTIFICATIONS=msteams \ -e WATCHTOWER_NOTIFICATIONS=msteams \
-e WATCHTOWER_NOTIFICATION_MSTEAMS_HOOK_URL="https://outlook.office.com/webhook/xxxxxxxx@xxxxxxx/IncomingWebhook/yyyyyyyy/zzzzzzzzzz" \ -e WATCHTOWER_NOTIFICATION_MSTEAMS_HOOK_URL="https://outlook.office.com/webhook/xxxxxxxx@xxxxxxx/IncomingWebhook/yyyyyyyy/zzzzzzzzzz" \
-e WATCHTOWER_NOTIFICATION_MSTEAMS_USE_LOG_DATA=true \ -e WATCHTOWER_NOTIFICATION_MSTEAMS_USE_LOG_DATA=true \
v2tec/watchtower containrrr/watchtower
``` ```

2
actions/check.go
View file

@ -3,7 +3,7 @@ package actions
import ( import (
"sort" "sort"
"github.com/v2tec/watchtower/container" "github.com/containrrr/watchtower/container"
) )
// CheckPrereqs will ensure that there are not multiple instances of the // CheckPrereqs will ensure that there are not multiple instances of the

2
actions/update.go
View file

@ -5,7 +5,7 @@ import (
"time" "time"
log "github.com/sirupsen/logrus" log "github.com/sirupsen/logrus"
"github.com/v2tec/watchtower/container" "github.com/containrrr/watchtower/container"
) )
var ( var (

2
container/filters_test.go
View file

@ -4,7 +4,7 @@ import (
"testing" "testing"
"github.com/stretchr/testify/assert" "github.com/stretchr/testify/assert"
"github.com/v2tec/watchtower/container/mocks" "github.com/containrrr/watchtower/container/mocks"
) )
func TestWatchtowerContainersFilter(t *testing.T) { func TestWatchtowerContainersFilter(t *testing.T) {

2
glide.yaml
View file

@ -1,4 +1,4 @@
package: github.com/v2tec/watchtower package: github.com/containrrr/watchtower
import: import:
- package: github.com/sirupsen/logrus - package: github.com/sirupsen/logrus
version: ~0.11.x version: ~0.11.x

6
goreleaser.yml
View file

@ -58,7 +58,7 @@ dockers:
goarch: amd64 goarch: amd64
goarm: '' goarm: ''
binary: watchtower binary: watchtower
image: v2tec/watchtower image: containrrr/watchtower
dockerfile: dockerfile/amd64/Dockerfile dockerfile: dockerfile/amd64/Dockerfile
tag_templates: tag_templates:
- '{{ .Version }}' - '{{ .Version }}'
@ -67,7 +67,7 @@ dockers:
goarch: arm goarch: arm
goarm: 6 goarm: 6
binary: watchtower binary: watchtower
image: v2tec/watchtower image: containrrr/watchtower
dockerfile: dockerfile/armhf/Dockerfile dockerfile: dockerfile/armhf/Dockerfile
tag_templates: tag_templates:
- 'armhf-{{ .Version }}' - 'armhf-{{ .Version }}'
@ -76,7 +76,7 @@ dockers:
goarch: arm64 goarch: arm64
goarm: '' goarm: ''
binary: watchtower binary: watchtower
image: v2tec/watchtower image: containrrr/watchtower
dockerfile: dockerfile/arm64v8/Dockerfile dockerfile: dockerfile/arm64v8/Dockerfile
tag_templates: tag_templates:
- 'arm64v8-{{ .Version }}' - 'arm64v8-{{ .Version }}'

8
main.go
View file

@ -1,4 +1,4 @@
package main // import "github.com/v2tec/watchtower" package main // import "github.com/containrrr/watchtower"
import ( import (
"os" "os"
@ -11,9 +11,9 @@ import (
"github.com/robfig/cron" "github.com/robfig/cron"
log "github.com/sirupsen/logrus" log "github.com/sirupsen/logrus"
"github.com/urfave/cli" "github.com/urfave/cli"
"github.com/v2tec/watchtower/actions" "github.com/containrrr/watchtower/actions"
"github.com/v2tec/watchtower/container" "github.com/containrrr/watchtower/container"
"github.com/v2tec/watchtower/notifications" "github.com/containrrr/watchtower/notifications"
) )
// DockerAPIMinVersion is the version of the docker API, which is minimally required by // DockerAPIMinVersion is the version of the docker API, which is minimally required by