Re: [libvirt] [jenkins-ci PATCH 8/8] guests: Update documentation
On Wed, Aug 29, 2018 at 05:09:05PM +0200, Andrea Bolognani wrote: > Provide instructions on how to build from non-default > git repositories and branches. > > Signed-off-by: Andrea Bolognani > --- With the necessary updates on '-g' being optional: Reviewed-by: Erik Skultety > guests/README.markdown | 8 +++- > 1 file changed, 7 insertions(+), 1 deletion(-) > > diff --git a/guests/README.markdown b/guests/README.markdown > index 68a6af7..f5d1219 100644 > --- a/guests/README.markdown > +++ b/guests/README.markdown > @@ -49,11 +49,17 @@ library and, where supported, as a Windows library using > MinGW. > Once hosts have been prepared following the steps above, you can use > `lcitool` to perform builds as well: for example, running > > -lcitool -a build -h '*debian*' -p libvirt-python > +lcitool -a build -h '*debian*' -p libvirt-python -r upstream/master > > will fetch libvirt-python's `master` branch from the upstream repository > and build it on all Debian hosts. > > +You can add more git repositories by tweaking the `git_urls` dictionary > +defined in `playbooks/build/jobs/defaults.yml` and then build arbitrary > +branches out of those with > + > +lcitool -a build -h all -p libvirt -r github/cool-feature > + > > Host setup > -- > -- > 2.17.1 > > -- > libvir-list mailing list > libvir-list@redhat.com > https://www.redhat.com/mailman/listinfo/libvir-list -- libvir-list mailing list libvir-list@redhat.com https://www.redhat.com/mailman/listinfo/libvir-list
[libvirt] [jenkins-ci PATCH 8/8] guests: Update documentation
Provide instructions on how to build from non-default git repositories and branches. Signed-off-by: Andrea Bolognani --- guests/README.markdown | 8 +++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/guests/README.markdown b/guests/README.markdown index 68a6af7..f5d1219 100644 --- a/guests/README.markdown +++ b/guests/README.markdown @@ -49,11 +49,17 @@ library and, where supported, as a Windows library using MinGW. Once hosts have been prepared following the steps above, you can use `lcitool` to perform builds as well: for example, running -lcitool -a build -h '*debian*' -p libvirt-python +lcitool -a build -h '*debian*' -p libvirt-python -r upstream/master will fetch libvirt-python's `master` branch from the upstream repository and build it on all Debian hosts. +You can add more git repositories by tweaking the `git_urls` dictionary +defined in `playbooks/build/jobs/defaults.yml` and then build arbitrary +branches out of those with + +lcitool -a build -h all -p libvirt -r github/cool-feature + Host setup -- -- 2.17.1 -- libvir-list mailing list libvir-list@redhat.com https://www.redhat.com/mailman/listinfo/libvir-list
Re: [libvirt] [jenkins-ci PATCH 8/8] guests: Update documentation
On Thu, Jul 19, 2018 at 06:32:08PM +0200, Andrea Bolognani wrote: > The usage has once again changed slightly; additionally, > a few concrete examples are now provided. > > Signed-off-by: Andrea Bolognani > --- Reviewed-by: Erik Skultety -- libvir-list mailing list libvir-list@redhat.com https://www.redhat.com/mailman/listinfo/libvir-list
[libvirt] [jenkins-ci PATCH 8/8] guests: Update documentation
The usage has once again changed slightly; additionally, a few concrete examples are now provided. Signed-off-by: Andrea Bolognani --- guests/README.markdown | 38 -- 1 file changed, 32 insertions(+), 6 deletions(-) diff --git a/guests/README.markdown b/guests/README.markdown index 4a40619..ddf0149 100644 --- a/guests/README.markdown +++ b/guests/README.markdown @@ -4,22 +4,48 @@ libvirt CI - guest management tools The tools contained in this directory simplify and automate the management of the guests used by the Jenkins-based libvirt CI environment. + +Usage and examples +-- + There are two steps to bringing up a guest: -* `./lcitool -a install -h $guest` will perform an unattended installation +* `lcitool -a install -h $guest` will perform an unattended installation of `$guest`. Not all guests can be installed this way: see the "FreeBSD" section below; -* `./lcitool -a update -h $guest` will go through all the post-installation - configuration steps required to make the newly-created guest usable; +* `lcitool -a update -h $guest -p $project` will go through all the + post-installation configuration steps required to make the newly-created + guest usable and ready to be used for building `$project`; Once those steps have been performed, maintainance will involve running: -* `./lcitool -a update -h $guest` +lcitool -a update -h $guest -p $project periodically to ensure the guest configuration is sane and all installed packages are updated. +To get a list of known guests and projects, run + +lcitool -a hosts + +and + +lcitool -a projects + +respectively. You can run operations involving multiple guests and projects +at once by providing a list on the command line: for example, running + +lcitool -a update -h '*fedora*' -p '*osinfo*' + +will update all Fedora guests and get them ready to build libosinfo and +related projects, while running + +lcitool -a update -h all -p libvirt,libvirt+mingw + +will update all hosts and prepare them to build libvirt both as a native +library and, where supported, as a Windows library using MinGW. + Host setup -- @@ -40,13 +66,13 @@ you'll want to use the `libvirt_guest` variant of the plugin. To keep guests up to date over time, it's recommended to have an entry along the lines of -0 0 * * * cd ~/libvirt-jenkins-ci/guests && ./lcitool -a update -h all +0 0 * * * ~/libvirt-jenkins-ci/guests/lcitool -a update -h all -p all in your crontab. Test use + If you are a developer trying to reproduce a bug on some OS you don't have easy access to, you can use these tools to create a suitable test -- 2.17.1 -- libvir-list mailing list libvir-list@redhat.com https://www.redhat.com/mailman/listinfo/libvir-list
[libvirt] [jenkins-ci PATCH 8/8] guests: Update documentation
Signed-off-by: Andrea Bolognani --- guests/README.markdown | 8 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/guests/README.markdown b/guests/README.markdown index bc780f3..4a40619 100644 --- a/guests/README.markdown +++ b/guests/README.markdown @@ -6,16 +6,16 @@ of the guests used by the Jenkins-based libvirt CI environment. There are two steps to bringing up a guest: -* `./lcitool install $guest` will perform an unattended installation +* `./lcitool -a install -h $guest` will perform an unattended installation of `$guest`. Not all guests can be installed this way: see the "FreeBSD" section below; -* `./lcitool prepare $guest` will go through all the post-installation +* `./lcitool -a update -h $guest` will go through all the post-installation configuration steps required to make the newly-created guest usable; Once those steps have been performed, maintainance will involve running: -* `./lcitool update $guest` +* `./lcitool -a update -h $guest` periodically to ensure the guest configuration is sane and all installed packages are updated. @@ -40,7 +40,7 @@ you'll want to use the `libvirt_guest` variant of the plugin. To keep guests up to date over time, it's recommended to have an entry along the lines of -0 0 * * * cd ~/libvirt-jenkins-ci/guests && ./lcitool update all +0 0 * * * cd ~/libvirt-jenkins-ci/guests && ./lcitool -a update -h all in your crontab. -- 2.17.1 -- libvir-list mailing list libvir-list@redhat.com https://www.redhat.com/mailman/listinfo/libvir-list