From nobody Mon Feb 9 20:36:04 2026 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.124; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-delivery-124.mimecast.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1695845533; cv=none; d=zohomail.com; s=zohoarc; b=YTAJZ/+U17lxyW65rRJ8dmNJvccgMv5fBOcBIFRibBYmuo2dxGzVMbsaEmEjiRfjLWUL+mHn2k2a5vP4WIsGdg7QXfncizNT7GaFzRYGj8FJo2grIFBV2L9JzL51K2FYfrV9EhxO0El7gArQB5TFEN1juDatGlOQ3aIlyYkVoDw= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1695845533; h=Content-Type:Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=jw0p63usHTa/pH4cpwWi0KisdvEuzbzl3WEpL1NbuiA=; b=QPGvidnN08eU481dcqLl8kxfXgsOGFischQIlMFCaW/42ka6dxodEgUhLtZnDMpvxt9YfXSn1j+09MlDd3WOfHTGOIcHTIFXuqqyxlWZMHBk+e9g9yAqVqTY07Sw2Vw6RTtXXTNo+jJra6MUHuar1MS5Y3IognFw/+8Bg2N0bPY= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) by mx.zohomail.com with SMTPS id 1695845533684800.3545521301891; Wed, 27 Sep 2023 13:12:13 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx-ext.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-281-iRE6d3dGOKyN8pYTEIJ5LA-1; Wed, 27 Sep 2023 16:12:10 -0400 Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.rdu2.redhat.com [10.11.54.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id C04D23C0E449; Wed, 27 Sep 2023 20:12:07 +0000 (UTC) Received: from mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com [10.30.29.100]) by smtp.corp.redhat.com (Postfix) with ESMTP id 844CE176C3; Wed, 27 Sep 2023 20:12:07 +0000 (UTC) Received: from mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (localhost [IPv6:::1]) by mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (Postfix) with ESMTP id 519AF1946588; Wed, 27 Sep 2023 20:12:07 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx02.intmail.prod.int.rdu2.redhat.com [10.11.54.2]) by mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (Postfix) with ESMTP id 5620B1946587 for ; Wed, 27 Sep 2023 18:53:55 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 51C2540C6EA8; Wed, 27 Sep 2023 18:53:55 +0000 (UTC) Received: from orca.home.lan (unknown [10.45.224.38]) by smtp.corp.redhat.com (Postfix) with ESMTP id CE8F640C6E78; Wed, 27 Sep 2023 18:53:54 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1695845532; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=jw0p63usHTa/pH4cpwWi0KisdvEuzbzl3WEpL1NbuiA=; b=jEZ3NEkQkVTwuu6h2L/mPx3EDJQvdQio5RJTOPRSKOdlWuam0WnCpsRrOBf5x/Ndrgroa5 mJPJNfQ64J/5ORVpVbaxOrY6ByvDsqrApSq6Z7Xys1y7Y0FuZXQJhSHUCC9zPEG/DphsWL QaB/aMRVpG0zeGXs+DVTJqFVYsZnIBs= X-MC-Unique: iRE6d3dGOKyN8pYTEIJ5LA-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Erik Skultety To: libvir-list@redhat.com Subject: [libvirt PATCH 7/7] docs: testtck: Expand the 'Run TCK' section on making use of ci/jobs.sh Date: Wed, 27 Sep 2023 20:53:48 +0200 Message-ID: <2ab9260aa3999f460745737421061b1ad632728b.1695840821.git.eskultet@redhat.com> In-Reply-To: References: MIME-Version: 1.0 X-Scanned-By: MIMEDefang 3.1 on 10.11.54.2 X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Erik Skultety Errors-To: libvir-list-bounces@redhat.com Sender: "libvir-list" X-Scanned-By: MIMEDefang 3.1 on 10.11.54.5 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) X-ZM-MESSAGEID: 1695845535222100001 Content-Type: text/plain; charset="utf-8"; x-default="true" Ever since commit 6e9bd600 added a new GitLab job description function handling the integration test suite process to ci/jobs.sh it should be mentioned in the docs. This patch splits the 'Run TCK' section in two, giving user the option to run the integration test suite in their VM environment the same way as we do in GitLab CI or execute everything manually. This patch takes the opportunity to also link to the virtiofs kbase article to give users a different option to get the local libvirt repositories to be used in testing inside a VM. Signed-off-by: Erik Skultety --- docs/testtck.rst | 29 +++++++++++++++++++++++++++-- 1 file changed, 27 insertions(+), 2 deletions(-) diff --git a/docs/testtck.rst b/docs/testtck.rst index f57af61aa8..568899dcdd 100644 --- a/docs/testtck.rst +++ b/docs/testtck.rst @@ -90,8 +90,33 @@ in the future we plan on making the TCK internal couplin= g with Avocado tighter. Running TCK ~~~~~~~~~~~ =20 -Once you have all the dependencies installed, you can then proceed with ru= nning -as root the test suite as root (when running with Avocado): +Once you have all the dependencies installed, you can then proceed with ei= ther +of the following procedures to execute the test suite as root. + +Replicating upstream CI test suite execution locally +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Similarly to how local container builds utilize the standalone ``ci/jobs.s= h`` +script containing functions describing GitLab job definitions it can be +utilized to run integration test suite as well. In this case, one needs to +get a copy of their libvirt repository containing the changes to be tested +inside the VM (either by cloning it manually or sharing the repo e.g. via +`virtiofs `__). Make sure that the +user which is going to execute the following has passwordless "sudo" permi= ssions +(lcitool's default "test" user does). Then it's just a matter of running + +:: + + $ source ci/jobs.sh + $ run_integration + +Manual invocation +^^^^^^^^^^^^^^^^^ + +If you want to have more control over the whole procedure or simply don't = want +to run the exact same steps as libvirt's upstream CI pipeline does in cont= ext +of integration tests then start by cloning the +`TCK `__ repository and run =20 :: =20 --=20 2.41.0