From patchwork Mon Nov 26 10:27:25 2012 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Senthil Kumaran X-Patchwork-Id: 13198 Return-Path: X-Original-To: patchwork@peony.canonical.com Delivered-To: patchwork@peony.canonical.com Received: from fiordland.canonical.com (fiordland.canonical.com [91.189.94.145]) by peony.canonical.com (Postfix) with ESMTP id 32A4423FC2 for ; Mon, 26 Nov 2012 10:27:29 +0000 (UTC) Received: from mail-ie0-f180.google.com (mail-ie0-f180.google.com [209.85.223.180]) by fiordland.canonical.com (Postfix) with ESMTP id BADFFA193DB for ; Mon, 26 Nov 2012 10:27:28 +0000 (UTC) Received: by mail-ie0-f180.google.com with SMTP id c10so4316395ieb.11 for ; Mon, 26 Nov 2012 02:27:28 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20120113; h=x-forwarded-to:x-forwarded-for:delivered-to:received-spf :content-type:mime-version:x-launchpad-project:x-launchpad-branch :x-launchpad-message-rationale:x-launchpad-branch-revision-number :x-launchpad-notification-type:to:from:subject:message-id:date :reply-to:sender:errors-to:precedence:x-generated-by :x-launchpad-hash:x-gm-message-state; bh=Qpb3xNXyUTBdEVDtbX1KER5oSSeyXRQrjLmaG7l9EZo=; b=mclYRs7dP0LZqC59ROIZztklPkQfIHcXYevNKr12PTzHeU0T2yFMRIGvEY42TdS4Rn H4A2ZoufjaGU+S/qe/V4IxnUzSjbg79GtdTvY4BC5GHuDh+CQk/buNM1LHYsd+HEM1qW FHFk5MqXOKhHDfzU8ma81F/+kj7vdNieYmW7OcGqNAgzz5YLGLUFVcoAQNT+V5oUqwIH kTqd4cWUNYbNkf4BPzWvhEkfDgwpmsdkTcQ+54Pice9Fp1qK6NT2G3tg7NwwEklXXArp lxJ66sE4popU24bg1FtgfB9u53sZ1vzPsQraN9Fl0O5rAj4Esd5LZnWKvrqcsG06dgwT 2pFQ== Received: by 10.50.152.137 with SMTP id uy9mr10343579igb.62.1353925648089; Mon, 26 Nov 2012 02:27:28 -0800 (PST) X-Forwarded-To: linaro-patchwork@canonical.com X-Forwarded-For: patch@linaro.org linaro-patchwork@canonical.com Delivered-To: patches@linaro.org Received: by 10.50.67.148 with SMTP id n20csp233037igt; Mon, 26 Nov 2012 02:27:27 -0800 (PST) Received: by 10.180.14.162 with SMTP id q2mr20059984wic.21.1353925646717; Mon, 26 Nov 2012 02:27:26 -0800 (PST) Received: from indium.canonical.com (indium.canonical.com. [91.189.90.7]) by mx.google.com with ESMTPS id n73si7587016wej.99.2012.11.26.02.27.25 (version=TLSv1/SSLv3 cipher=OTHER); Mon, 26 Nov 2012 02:27:26 -0800 (PST) Received-SPF: pass (google.com: best guess record for domain of bounces@canonical.com designates 91.189.90.7 as permitted sender) client-ip=91.189.90.7; Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of bounces@canonical.com designates 91.189.90.7 as permitted sender) smtp.mail=bounces@canonical.com Received: from ackee.canonical.com ([91.189.89.26]) by indium.canonical.com with esmtp (Exim 4.71 #1 (Debian)) id 1TcvuP-0001AO-HA for ; Mon, 26 Nov 2012 10:27:25 +0000 Received: from ackee.canonical.com (localhost [127.0.0.1]) by ackee.canonical.com (Postfix) with ESMTP id 70643E03A6 for ; Mon, 26 Nov 2012 10:27:25 +0000 (UTC) MIME-Version: 1.0 X-Launchpad-Project: lava-dispatcher X-Launchpad-Branch: ~linaro-validation/lava-dispatcher/trunk X-Launchpad-Message-Rationale: Subscriber X-Launchpad-Branch-Revision-Number: 465 X-Launchpad-Notification-Type: branch-revision To: Linaro Patch Tracker From: noreply@launchpad.net Subject: [Branch ~linaro-validation/lava-dispatcher/trunk] Rev 465: Update documentation for new job definition format which specifies pulling Message-Id: <20121126102725.17030.65955.launchpad@ackee.canonical.com> Date: Mon, 26 Nov 2012 10:27:25 -0000 Reply-To: noreply@launchpad.net Sender: bounces@canonical.com Errors-To: bounces@canonical.com Precedence: bulk X-Generated-By: Launchpad (canonical.com); Revision="16293"; Instance="launchpad-lazr.conf" X-Launchpad-Hash: bf7259771d44d1e0646e07e282cfed70964d55e5 X-Gm-Message-State: ALoCoQlbhrzHmy2Qm7DJiiTlQGsVm6e5zLwMdzWQeu6Xwx2ne/OyMmkVaJ5LnWEEb3il+Q2i6Fc6 Merge authors: Senthil Kumaran S (stylesen) Related merge proposals: https://code.launchpad.net/~stylesen/lava-dispatcher/testdef-from-repo-doc/+merge/136125 proposed by: Senthil Kumaran S (stylesen) review: Approve - Dave Pigott (dpigott) ------------------------------------------------------------ revno: 465 [merge] committer: Senthil Kumaran branch nick: trunk timestamp: Mon 2012-11-26 15:56:11 +0530 message: Update documentation for new job definition format which specifies pulling test definitions from bzr/git repositories. modified: doc/jobfile.rst --- lp:lava-dispatcher https://code.launchpad.net/~linaro-validation/lava-dispatcher/trunk You are subscribed to branch lp:lava-dispatcher. To unsubscribe from this branch go to https://code.launchpad.net/~linaro-validation/lava-dispatcher/trunk/+edit-subscription === modified file 'doc/jobfile.rst' --- doc/jobfile.rst 2012-10-10 19:29:04 +0000 +++ doc/jobfile.rst 2012-11-26 10:03:08 +0000 @@ -68,7 +68,7 @@ Using LAVA Test Shell ===================== The ``lava_test_shell`` action provides a way to employ a more black-box style -testing appoach with the target device. The action only requires that a +testing approach with the target device. The action only requires that a deploy action (deploy_linaro_image/deploy_linaro_android_image) has been executed. Its format is:: @@ -82,14 +82,57 @@ } } -You can put multiple test definition URLs in the "testdef_urls" section. These -will be run sequentially without reboot. Alternatively, you can specify each -URL in a separate ``lava_test_shell`` action which will allow for a reboot -between each test. - -.. seealso:: The test definition format for ``lava_test_shell`` actions here_ - -.. _here: lava_test_shell.html +You can put multiple test definition URLs in "testdef_urls" +section. The "testdef_urls" section takes a python list of strings +which are URLs. These will be run sequentially without +reboot. Alternatively, you can specify each URL in a separate +``lava_test_shell`` action which will allow for a reboot between each test. + +If your test definitions are available in a git repository then +``lava_test_shell`` can automatically pull the test definition from +the git repository and execute it. The format is:: + + { + "command": "lava_test_shell", + "parameters": { + "testdef_repos": [ + {"git-repo": "git://git.linaro.org/people/stylesen/sampletestdefs.git", + "revision": "91df22796f904677c0fe5df787fc04234bf97691", + "testdef": "testdef.yaml" + }], + "timeout": 1800 + } + } + +Alternatively, if your test definitions are available in a bzr repository then +``lava_test_shell`` can automatically pull the test definition from +the bzr repository and execute it. The format is:: + + { + "command": "lava_test_shell", + "parameters": { + "testdef_repos": [ + {"bzr-repo": "lp:~stylesen/lava-dispatcher/sampletestdefs-bzr", + "revision": "1", + "testdef": "testdef.yaml" + }], + "timeout": 1800 + } + }, + +In both the above formats "revision" and "testdef" are optional. If +"revision" is not specified then the latest revision in the repository is +cloned. If there is no "testdef" specified, then inside the cloned +directory of the repository a file with name "lavatest.yaml" is looked +up which is the default name for test definitions. The "testdef" +parameter could be used in order to override the default name for test +definition file. + +.. seealso:: The test definition format for ``lava_test_shell`` + actions `here `_ + + Developer documentation for ``lava_test_shell`` is + available `here `_ Adding Meta-Data ================