From nobody Thu May 15 12:19:59 2025 Delivered-To: importer@patchew.org Received-SPF: pass (zoho.com: domain of redhat.com designates 209.132.183.28 as permitted sender) client-ip=209.132.183.28; envelope-from=libvir-list-bounces@redhat.com; helo=mx1.redhat.com; Authentication-Results: mx.zohomail.com; spf=pass (zoho.com: domain of redhat.com designates 209.132.183.28 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com Return-Path: Received: from mx1.redhat.com (mx1.redhat.com [209.132.183.28]) by mx.zohomail.com with SMTPS id 1508427417489749.4618725336469; Thu, 19 Oct 2017 08:36:57 -0700 (PDT) Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.phx2.redhat.com [10.5.11.15]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id 7B6EEC059B6F; Thu, 19 Oct 2017 15:36:56 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.21]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 4D8CCBA215; Thu, 19 Oct 2017 15:36:56 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id 138513FA5F; Thu, 19 Oct 2017 15:36:56 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.phx2.redhat.com [10.5.11.15]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id v9JFapSa013841 for ; Thu, 19 Oct 2017 11:36:51 -0400 Received: by smtp.corp.redhat.com (Postfix) id 43A04BA226; Thu, 19 Oct 2017 15:36:51 +0000 (UTC) Received: from inaba.usersys.redhat.com (ovpn-204-95.brq.redhat.com [10.40.204.95]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 9C774BA213 for ; Thu, 19 Oct 2017 15:36:50 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mx1.redhat.com 7B6EEC059B6F Authentication-Results: ext-mx08.extmail.prod.ext.phx2.redhat.com; dmarc=none (p=none dis=none) header.from=redhat.com Authentication-Results: ext-mx08.extmail.prod.ext.phx2.redhat.com; spf=fail smtp.mailfrom=libvir-list-bounces@redhat.com From: Andrea Bolognani To: libvir-list@redhat.com Date: Thu, 19 Oct 2017 17:36:32 +0200 Message-Id: <20171019153632.15016-7-abologna@redhat.com> In-Reply-To: <20171019153632.15016-1-abologna@redhat.com> References: <20171019153632.15016-1-abologna@redhat.com> X-Scanned-By: MIMEDefang 2.79 on 10.5.11.15 X-loop: libvir-list@redhat.com Subject: [libvirt] [libvirt-jenkins-ci PATCH 6/6] guests: Update documentation X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.79 on 10.5.11.15 X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.5.16 (mx1.redhat.com [10.5.110.32]); Thu, 19 Oct 2017 15:36:57 +0000 (UTC) X-ZohoMail: RSF_0 Z_629925259 SPT_0 Content-Type: text/plain; charset="utf-8" Signed-off-by: Andrea Bolognani --- guests/README.markdown | 45 ++++++++++++++++++++++++--------------------- 1 file changed, 24 insertions(+), 21 deletions(-) diff --git a/guests/README.markdown b/guests/README.markdown index 100ca31..51d9012 100644 --- a/guests/README.markdown +++ b/guests/README.markdown @@ -11,8 +11,7 @@ There are two steps to bringing up a guest: section below; =20 * `./lcitool prepare $guest` will go through all the post-installation - configuration steps required to make the newly-created guest usable as - part of the Jenkins CI setup. + configuration steps required to make the newly-created guest usable; =20 Once those steps have been performed, maintainance will involve running: =20 @@ -46,14 +45,6 @@ along the lines of in your crontab. =20 =20 -Adding new guests ------------------ - -Adding new guests will require tweaking the inventory and host variables, -but it should be very easy to eg. use the Fedora 26 configuration to come -up with a working Fedora 27 configuration. - - Development use --------------- =20 @@ -61,22 +52,26 @@ If you are a developer trying to reproduce a bug on som= e OS you don't have easy access to, you can use these tools to create a suitable test environment. =20 -Since the tools are intended mainly for CI use, you'll have to tweak them -a bit first, including: +The `developer` flavor is used by default, so you don't need to do +anything special in order to use it: just follow the steps outlined +above. Once a guest has been prepared, you'll be able to log in as +`developer` either via SSH (your public key will have been authorized) +or on the serial console (password: `developer`). =20 -* trimming down the `inventory` file to just the guest you're interested i= n; +Once logged in, you'll be able to perform administrative tasks using +`sudo`. Regular root access will still be available, either through +SSH or on the serial console. =20 -* removing any references to the `jenkins` pseudo-project from - `host_vars/$guest/main.yml`, along with any references to projects you're - not interested to (this will cut down on the number of packages installe= d) - and any references to `jenkins_secret`; =20 -* deleting `host_vars/$guest/vault.yml` altogether. +CI use +------ =20 -After performing these tweaks, you should be able to use the same steps -outlined above. +You'll need to configure `lcitool` to use the `ci` flavor for guests: +to do so, just write `ci` in the `~/.config/lcitool/flavor` file. =20 -A better way to deal with this use case will be provided in the future. +Once a guest has been prepared, you'll be able to log in as root either +via SSH (your public key will have been authorized) or on the serial +console (using the password configured earlier). =20 =20 FreeBSD @@ -95,3 +90,11 @@ Some manual tweaking will be needed, in particular: =20 Once these steps have been performed, FreeBSD guests can be managed just like all other guests. + + +Adding new guests +----------------- + +Adding new guests will require tweaking the inventory and host variables, +but it should be very easy to eg. use the Fedora 26 configuration to come +up with a working Fedora 27 configuration. --=20 2.13.6 -- libvir-list mailing list libvir-list@redhat.com https://www.redhat.com/mailman/listinfo/libvir-list