summaryrefslogtreecommitdiff
path: root/man/ostree-admin-upgrade.xml
diff options
context:
space:
mode:
authorColin Walters <walters@verbum.org>2017-01-05 11:29:41 -0500
committerAtomic Bot <atomic-devel@projectatomic.io>2017-02-27 20:57:23 +0000
commit36b28cb4d2126320d07029432abd2327b442a126 (patch)
tree59cd0895afc77a06fc7f4463a41a87b1c60d93eb /man/ostree-admin-upgrade.xml
parent2c326d705eec5f379a01ba2b584986548473d6c2 (diff)
downloadostree-36b28cb4d2126320d07029432abd2327b442a126.tar.gz
upgrade: Add support for --pull-only and --deploy-only
This makes it easier to script downloading updates in the background, and only do deployments just before rebooting. Partially addresses https://github.com/ostreedev/ostree/issues/640 Closes: #642 Approved by: jlebon
Diffstat (limited to 'man/ostree-admin-upgrade.xml')
-rw-r--r--man/ostree-admin-upgrade.xml23
1 files changed, 22 insertions, 1 deletions
diff --git a/man/ostree-admin-upgrade.xml b/man/ostree-admin-upgrade.xml
index ddd33dc6..7766c66e 100644
--- a/man/ostree-admin-upgrade.xml
+++ b/man/ostree-admin-upgrade.xml
@@ -57,7 +57,10 @@ Boston, MA 02111-1307, USA.
<title>Description</title>
<para>
- Downloads the latest version of the current ref from the build server and deploys it, if it changed. Reboot the machine for the changes to take effect.
+ Downloads the latest version of the current ref from the build
+ server and deploys it, if it changed. Reboot the machine for the
+ changes to take effect. These phases can be split via
+ <option>--pull-only</option> and <option>--deploy-only</option>.
</para>
</refsect1>
@@ -74,6 +77,24 @@ Boston, MA 02111-1307, USA.
</varlistentry>
<varlistentry>
+ <term><option>--pull-only</option></term>
+
+ <listitem><para> Only perform a pull into the repository; do not
+ create a deployment. This option can hence safely be used in a
+ background scheduled job with the assurance of not changing
+ system state.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--deploy-only</option></term>
+
+ <listitem><para>Create a new deployment from the latest commit
+ in the tracked origin refspec. This option is intended to be used
+ by a scheduled system that detected changes via <option>--pull-only</option>,
+ and is ready to deploy them.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><option>--reboot</option>,<option>-r</option></term>
<listitem><para>