From ab30fe0cef3caa584413fd014d182e8a27bd92c6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lubom=C3=ADr=20Sedl=C3=A1=C5=99?= Date: Thu, 25 Feb 2016 09:07:07 +0100 Subject: [PATCH] [doc] Write documentation for kickstart Git URLs MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Lubomír Sedlář --- doc/configuration.rst | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/doc/configuration.rst b/doc/configuration.rst index 03ab2275..e2150283 100644 --- a/doc/configuration.rst +++ b/doc/configuration.rst @@ -289,6 +289,32 @@ Example signing_key_password_file = '~/password_for_fedora-24_key' +Git URLs +======== + +In multiple places the config requires URL of a Git repository to download +kickstart file from. This URL is passed on to *Koji*. It is possible to which +commit to use using this syntax: :: + + git://git.example.com/git/repo-name.git?# + +The ```` pattern can be replaced with actual commit SHA, a tag name, +``HEAD`` to indicate that tip of default branch should be used or +``origin/`` to use tip of arbitrary branch. + +If the URL specifies a branch or ``HEAD``, *Pungi* will replace it with the +actual commit SHA. This will later show up in *Koji* tasks and help with +tracing what particular inputs were used. + +.. note:: + + The ``origin`` must be specified because of the way *Koji* works with the + repository. It will clone the repository then switch to requested state + with ``git reset --hard REF``. Since no local branches are created, we need + to use full specification including the name of the remote. + + + Createrepo Settings ===================