From ce1d812ee1f3c49e9f9812f29b75d385c9b62e5b Mon Sep 17 00:00:00 2001 From: Lukas Garberg Date: Tue, 30 Apr 2024 14:59:16 +0200 Subject: [PATCH] docs: Added Docker info to release-handling Added some info about the Docker repo at Docker Hub and guide for release handling wrt Docker. --- docs/release-handling.rst | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) diff --git a/docs/release-handling.rst b/docs/release-handling.rst index b417483b9..dab5df0a9 100644 --- a/docs/release-handling.rst +++ b/docs/release-handling.rst @@ -58,6 +58,17 @@ packages from the testing branch into stable. Again, commit to gh-pages and so forth. Please see "Rolling the deb repo" section for more details. +Docker repositories +------------------- +The Docker repositories is hosted at Docker Hub and currently updated manually +when a new release is built. The NIPAP organization can be found at +https://hub.docker.com/u/nipap. + +There are two repositories, one for nipapd and one for the web UI, nipap-www. +Each build is tagged with the NIPAP version and there are tags pointing towards +the latest stable ("stable") and testing ("testing") releases. + + NEWS / Changelog ---------------- There is a NEWS file outlining the differences with every version. It can @@ -142,6 +153,30 @@ tag and write a post on Google+ in the NIPAP community and share it from the NIPAP account. +Rolling the Docker images +------------------------- +Make sure you have a clean repo:: + make clean + +Then build the images:: + docker build -t nipap/nipapd:vX.Y.Z -f Dockerfile.nipapd . + docker build -t nipap/nipap-www:vX.Y.Z -f Dockerfile.www . +Add the testing-tag and push:: + docker tag nipap/nipapd:vX.Y.Z nipap/nipapd:testing + docker tag nipap/nipap-www:vX.Y.Z nipap/nipap-www:testing + docker login -u *username* + docker push nipap/nipapd:vX.Y.Z + docker push nipap/nipapd:testing + docker push nipap/nipap-www:vX.Y.Z + docker push nipap/nipap-www:testing + +Once the new version has been tested for a bit, also tag the version with the stable-tag and push: + docker tag nipap/nipapd:vX.Y.Z nipap/nipapd:stable + docker tag nipap/nipap-www:vX.Y.Z nipap/nipap-www:stable + docker push nipap/nipapd:stable + docker push nipap/nipap-www:stable + + Uploading to PyPi ----------------- pynipap should be available on PyPi::