nils/gluon
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs: add some information about the new autoupdater

Browse Source
This commit is contained in:
Matthias Schiffer 2014-07-20 22:36:46 +02:00
parent c4109b349c
commit cd0d771568
2 changed files with 17 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
docs/features/autoupdater.rst
View File

@ -11,7 +11,15 @@ during development), but it can be enabled by setting the variable GLUON_BRANCH
to override the default branch set in the set in the site configuration. to override the default branch set in the set in the site configuration.
A manifest file for the updater can be generated with `make manifest`. A signing script (using A manifest file for the updater can be generated with `make manifest`. A signing script (using
ecdsautils) can by found in the `contrib` directory. ecdsautils) can by found in the `contrib` directory. When creating the manifest, ``GLUON_PRIORITY`` can
be set on the command line, or it can be taken from the ``site.mk``.
The priority defines the maximum number of days that may pass between releasing an update and installation
of the images. The update probability with start at 0 after the release time mentioned in the manifest
and then slowly rise to 1 after the number of days given by the priority has passed. (Note: The priority
doesn't have an effect as the moment, this is yet to be implemented)
The priority may be an integer or a decimal fraction.
A fully automated nightly build could use the following commands: A fully automated nightly build could use the following commands:
@ -25,7 +33,7 @@ A fully automated nightly build could use the following commands:
make manifest GLUON_BRANCH=experimental make manifest GLUON_BRANCH=experimental
contrib/sign.sh $SECRETKEY images/sysupgrade/experimental.manifest contrib/sign.sh $SECRETKEY images/sysupgrade/experimental.manifest
cp -r images /where/to/put/this/experimental cp -r images /where/to/put/this/experimental
mv /where/to/put/this/experimental/experimental.manifest /where/to/put/this/experimental/manifest ln -s experimental.manifest /where/to/put/this/experimental/manifest
Infrastructure Infrastructure
@ -47,8 +55,8 @@ We suggest to have following directory tree accessible via http:
factory/ factory/
The last level is generated by the Gluon build process. Do not forget The last level is generated by the Gluon build process. Do not forget
to rename the ``<branch>.manifest`` into ``manifest`` inside of the to create symlinks from ``manifest`` to ``<branch>.manifest`` in the
sysupgrade directories. sysupgrade directories to allow upgrades from Gluon versions before 2014.3.
The server should be available via IPv6. The server should be available via IPv6.
@ -64,7 +72,7 @@ These commands can be used on a node.
:: ::
# Force Update Check # Force update check, even when the updater is disabled
autoupdater -f autoupdater -f

4
docs/user/site.rst
View File

@ -168,6 +168,10 @@ GLUON_SITE_PACKAGES
GLUON_RELEASE GLUON_RELEASE
The current release version Gluon should use. The current release version Gluon should use.
GLUON_PRIORITY
The default priority for the generated manifests (see the autoupdater documentation
for more information).
Examples Examples
-------- --------