mirror of
https://github.com/buanet/ioBroker.docker.git
synced 2025-12-18 10:59:00 +02:00
added major version latest docker tag, preparing ne stable
This commit is contained in:
buanet
@@ -15,6 +15,7 @@ env:
|
||||
- secure: "iqK7JBsQiYceKOvRkmSa6okzXn3BygEPZjffby4agaVCwIt2SYLAcBOisOoKDpyAX+DUWlHz3gITImVa+uIna6Ue7k4C2AGJVDr87G6iq57Tn6yjrfhPs/TW9/CWvKg/G4uvKEnycMiLDXdcctSMwRr3ZwzJEdeEdmNZVsd2LP/5U0I/2K2Io22tNciSKhqlSaIfhK4f6Jk7xffnQFjwy+P9qPN18oI1fDyeHx6ZWyN3YhQQ4eGyxHjxZjlhCxSvu5R4DMf1jFIoLRAr6G5jrQacn0pG8PtBVLoYT4RsPy+fwUtXmnWWjeXK0IrU1njZf/DUteI9xnaDcHzZYj+d7MeSUc6BuWOyx9lO3ZwBWDNycYsKaF5so4RpdzoY/gfJMlK3uWDbADb46dWzPD5gb3pEROKau3fBDHS5eaR5e1Bxzz6FGoYWYfsQHqpg9g7v4BRFq+Jh0+v47fdyMxgK/Nm4+r7+ht77Usu29+X6X8F4iwrBJ/ix5xIf7iMoH/ZGvq6BEKi/1t9zdXMugcWOqwlYx9k6J9bQhBfw8YucLmgl3ynzrPaLlPEpY9cnb7hcOUDZoHI7KK2zF/y3yfNr2BqlRbm39HFWfnwuJPO5VLYGs5QubeVj9u1M+5Qo4erPuQBBc4mHP4eF2PmRA+wiVWki0z+U2skFQppkCfrbH8c="
|
||||
- secure: "iqoZUcWgZueNQrNldF/ugwyU1LR5E+doTfjY0exQqAKjntG5n2QqYZ/+dX1gqvkfy1kuMINTBWfqSALbhfTTK7EfUjqmcnaks4CMVZQkhH/FyCOYHqSBSSN7j4XeHt1sXn1FRiSpyrZOUoOuyqoBRe3JoWhdQZAGxNzX3sJllwnKa6M0D6D2l9tUyTWO/jxhgTIoYBSrXvb68ZsCU9jlNBJbylfvEFwuSlwvfa+Mz9vAeCTuza9XDnvcxgwVq3r+YGxfmAhK9fOAvN+lPN+KA0LcIzBaW0sh24voqjfh/pLpsl03zeGNdWzS9r2qYPCP0N3asb5P6CVEbbAGYO1T5PvU78ILXGi4+/x/32O6/I9oXpMVQCFHNn0Gn/8BPRHY4ZOYI9ItnhV9Ncp7hhAWAAqf3KC5GM89l9R5KxFY3bhN/p8nuGresUDU5d57YkaV8rOhPpr0dbAyKFtuzG0+bT1N2ekXyTyMHeAGKiGwfD9bAS4qx6asFO5uw6UriBHNzJ59Cy3GT+W1CctaEuvqJlc6Iqz2KaBozEqnNFcpE2Grny4bzr5fp+b1qCO9TE2LhHU/LR5FTLjQ2wf9/raTM6yboq+guKeXxpySa2w8ABDq0OUAw4mrKqJQJohzBkl3oYTpWUG2JGEyMAJxjkmH0/3GwZESPNLaaYVjQByTDDY="
|
||||
- VERSION="$(cat .VERSION)"
|
||||
- MAJORVERSION="$(cat .version | cut -c 1-2 | sed -r 's#^(.{0})#\1latest-#')"
|
||||
|
||||
before_install:
|
||||
- wget https://github.com/estesp/manifest-tool/releases/download/v0.7.0/manifest-tool-linux-amd64 -O manifest-tool
|
||||
@@ -78,12 +79,18 @@ after_success:
|
||||
#manifest for image: buanet/iobroker:latest
|
||||
cat manifest.yaml | sed "s/\$DOCKERTAG/latest/g" > manifestlatest.yaml
|
||||
|
||||
#manifest for image: buanet/iobroker:latest-majorversion
|
||||
cat manifest.yaml | sed "s/\$DOCKERTAG/${MAJORVERSION}/g" > manifestmajorversion.yaml
|
||||
|
||||
#push to hub
|
||||
mv manifestversion.yaml iobroker.yaml
|
||||
./manifest-tool --username $HUB_USER --password $HUB_PASS push from-spec iobroker.yaml
|
||||
|
||||
mv manifestlatest.yaml iobroker.yaml
|
||||
./manifest-tool --username $HUB_USER --password $HUB_PASS push from-spec iobroker.yaml
|
||||
|
||||
mv manifestmajorversion.yaml iobroker.yaml
|
||||
./manifest-tool --username $HUB_USER --password $HUB_PASS push from-spec iobroker.yaml
|
||||
fi
|
||||
|
||||
if [ "$TRAVIS_BRANCH" == "beta" ] && [ "$TRAVIS_PULL_REQUEST" == "false" ] && [ "$JOB_NAME" == "Manifest" ]; then
|
||||
|
||||
28
README.md
28
README.md
@@ -29,7 +29,7 @@ In any case make a backup first!
|
||||
|
||||
## Getting started
|
||||
|
||||
A detailed tutorial (German, based on v3.0.0) can be found here: [https://buanet.de](https://buanet.de/2019/05/iobroker-unter-docker-auf-der-synology-diskstation-v3/). Please notice that the old tutorial is outdated and does no longer work!
|
||||
A detailed tutorial (German, based on v3.0.0) can be found here: [https://smarthome.buanet.de](https://smarthome.buanet.de/2019/05/iobroker-unter-docker-auf-der-synology-diskstation-v3/). Please notice that the old tutorial is outdated and does no longer work!
|
||||
|
||||
For discussion and support please visit [ioBroker forum thread](http://forum.iobroker.net/viewtopic.php?f=17&t=5089) or use the comments section at the linked tutorial.
|
||||
|
||||
@@ -102,7 +102,7 @@ You do not have to declare every single variable when setting up your container.
|
||||
|
||||
It is possible to mount an empty folder to /opt/iobroker during first startup of the container. The startup script will check this folder and restore content if it is empty.
|
||||
|
||||
Since v4.1.0 it is also possible mount a folder filled up with an iobroker backup file created using `iobroker backup` command or backitup adapter. The name of your backup file ending like this: `*_backupiobroker.tar.gz"`.
|
||||
Since v4.1.0 it is also possible mount a folder filled up with an iobroker backup file created using `iobroker backup` command or backitup adapter. Please make sure the name of your backup file ends like this: `*_backupiobroker.tar.gz"`.
|
||||
|
||||
The startup script will then detect this backup and restore it during the start of the container. Please see container logs when starting the container for more details!
|
||||
|
||||
@@ -125,19 +125,21 @@ When you mount an empty folder the startup script will restore two example scrip
|
||||
|
||||
Feel free to test it with my example code. Take a look at the log. In "Step 4 of 5: Applying special settings" you will see the messages generated by the example userscripts.
|
||||
|
||||
### Multihost (beta)
|
||||
### Multihost
|
||||
|
||||
With the help of the ENV "IOB_MULTIHOST" and the ENVs for objects and states db connections (see ENVs table above) it is now possible to run a container as standalone, multihost master or multihost slave. This is more or less a feature for advanced users. Please make sure you know how ioBroker multihost is working and set the ENVs as with `ìobroker setup custom`.
|
||||
|
||||
There is no need for executing `iobroker multihost enable` or `iobroker multihost connect` inside the container. Just configure the mentioned ENVs. The startup script will do all the magic.
|
||||
|
||||
For general information about iobroker multihost feature please see [official ioBroker documentation](https://www.iobroker.net/docu/index-24.htm?page_id=3068&lang=de).
|
||||
|
||||
### Healthcheck (beta)
|
||||
### Healthcheck
|
||||
|
||||
Since v5.0.2beta the image contains a simple Docker healthcheck. At the moment it only checks if js-controller is running inside the container and reports "healthy" or "unhealthy" to the Docker daemon. Further development is planned.
|
||||
Since v5.1.0 the image contains a simple Docker healthcheck. At the moment it only checks if js-controller is running inside the container and reports "healthy" or "unhealthy" to the Docker daemon. Further development is planned.
|
||||
|
||||
The healthcheck is configured to 5 retries in an 15s interval with a timeout of 5s. So a container needs a minimum of one minute to get unhealthy.
|
||||
|
||||
Hint: As the Docker daemon itself gives no opportunity to automatically restart an unhealthy container you might want to setup some kind of "watchdog container" like this simple one: https://hub.docker.com/r/willfarrell/autoheal/ (works great so far!).
|
||||
Hint: As the Docker daemon itself gives no opportunity to automatically restart an unhealthy container you might want to setup some kind of "watchdog container" like this simple one: https://github.com/buanet/docker-watchdog.
|
||||
|
||||
### Maintenance script (beta)
|
||||
|
||||
@@ -149,9 +151,11 @@ After your maintenance is done just type `maintenance off`. Depending on the sel
|
||||
|
||||
## Best practices
|
||||
|
||||
### Avoid using "latest" tag
|
||||
### Avoid using "latest" docker tag
|
||||
|
||||
To avoid conflicts when upgrading your container or getting in trouble when accidentally upgrading your container to a new major version I prefer using the version tag like "V4.2.0" instead of "latest" for creating your container.
|
||||
To avoid conflicts when upgrading your container or getting in trouble when accidentally upgrading your container to a new major version I prefer using a version docker tag like "v4.2.0" instead of "latest" for creating your container.
|
||||
|
||||
With v5.1.0 an additional docker tag "latest-[major version]" is available. This gives you the possibility update your container automatically while always staying in the same major version.
|
||||
|
||||
### Upgrading your container
|
||||
|
||||
@@ -162,7 +166,7 @@ If you want to upgrade your ioBroker container to a new major version (e.g. from
|
||||
* create a new container as your old or as you need it and use the new data folder/ volume for the /opt/iobroker mount point
|
||||
* follow the log output of the container and be patient
|
||||
|
||||
After this the startup script inside the container will automatically detect and restore your backup to a new ioBroker instance. When iobroker is started after the restore it will install your adapters to the new ioBroker instance by itself. This might take some time but will get you the best and cleanest results...
|
||||
After this steps the startup script inside the container will automatically detect and restore your backup to a new ioBroker instance. When iobroker is started after the restore it will install your adapters to the new ioBroker instance by itself. This might take some time but will give you the best and cleanest results...
|
||||
|
||||
## Miscellaneous
|
||||
|
||||
@@ -172,7 +176,7 @@ If you want to get the newest features and changes feel free to use/ test the be
|
||||
|
||||
### Subscribe to updates
|
||||
|
||||
If you want the newest updates about the image and my tutorials at https://buanet.de/tutorials you can simply subscribe to my new "news and updates" channel (only in German) on Telegram.
|
||||
If you want the newest updates about the image and my tutorials at https://smarthome.buanet.de you can simply subscribe to my new "news and updates" channel (only in German) on Telegram.
|
||||
You will find the channel here: https://t.me/buanet_tutorials
|
||||
|
||||
### Support the project
|
||||
@@ -184,7 +188,9 @@ Thank you!
|
||||
|
||||
## Changelog
|
||||
|
||||
### v5.0.2beta (2020-07-28)
|
||||
### v5.1.0 (2020-11-05)
|
||||
* v5.0.2beta (2020-07-28)
|
||||
* added docker tag for majorversion latest
|
||||
* extend readme.md doku
|
||||
* added maintenance script
|
||||
* added container healthcheck
|
||||
|
||||
Reference in New Issue
Block a user