wiki/documentation/dev_guides/openqa_cli_post_examples/index.html

1443 lines
43 KiB
HTML

<!doctype html>
<html lang="en" class="no-js">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<meta name="description" content="The wiki for the Rocky Linux Testing Team.">
<meta name="author" content="Trevor Cooper">
<link rel="canonical" href="https://testing.rocky.page/documentation/dev_guides/openqa_cli_post_examples/">
<link rel="prev" href="../openqa_access/">
<link rel="next" href="../openqa_clone_job_examples/">
<link rel="icon" href="../../../assets/images/favicon.png">
<meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.20">
<title>openQA - openqa-cli POST Examples - Testing Wiki</title>
<link rel="stylesheet" href="../../../assets/stylesheets/main.66ac8b77.min.css">
<link rel="stylesheet" href="../../../assets/stylesheets/palette.06af60db.min.css">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
<style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
<script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
</head>
<body dir="ltr" data-md-color-scheme="default" data-md-color-primary="teal" data-md-color-accent="teal">
<input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
<input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
<label class="md-overlay" for="__drawer"></label>
<div data-md-component="skip">
<a href="#openqa-cli-post-examples" class="md-skip">
Skip to content
</a>
</div>
<div data-md-component="announce">
</div>
<header class="md-header md-header--shadow" data-md-component="header">
<nav class="md-header__inner md-grid" aria-label="Header">
<a href="../../.." title="Testing Wiki" class="md-header__button md-logo" aria-label="Testing Wiki" data-md-component="logo">
<img src="../../../assets/icon-white.svg" alt="logo">
</a>
<label class="md-header__button md-icon" for="__drawer">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
</label>
<div class="md-header__title" data-md-component="header-title">
<div class="md-header__ellipsis">
<div class="md-header__topic">
<span class="md-ellipsis">
Testing Wiki
</span>
</div>
<div class="md-header__topic" data-md-component="header-topic">
<span class="md-ellipsis">
openQA - openqa-cli POST Examples
</span>
</div>
</div>
</div>
<form class="md-header__option" data-md-component="palette">
<input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="teal" data-md-color-accent="teal" aria-label="Switch to dark mode" type="radio" name="__palette" id="__palette_0">
<label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_1" hidden>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m17.75 4.09-2.53 1.94.91 3.06-2.63-1.81-2.63 1.81.91-3.06-2.53-1.94L12.44 4l1.06-3 1.06 3 3.19.09m3.5 6.91-1.64 1.25.59 1.98-1.7-1.17-1.7 1.17.59-1.98L15.75 11l2.06-.05L18.5 9l.69 1.95 2.06.05m-2.28 4.95c.83-.08 1.72 1.1 1.19 1.85-.32.45-.66.87-1.08 1.27C15.17 23 8.84 23 4.94 19.07c-3.91-3.9-3.91-10.24 0-14.14.4-.4.82-.76 1.27-1.08.75-.53 1.93.36 1.85 1.19-.27 2.86.69 5.83 2.89 8.02a9.96 9.96 0 0 0 8.02 2.89m-1.64 2.02a12.08 12.08 0 0 1-7.8-3.47c-2.17-2.19-3.33-5-3.49-7.82-2.81 3.14-2.7 7.96.31 10.98 3.02 3.01 7.84 3.12 10.98.31Z"/></svg>
</label>
<input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="teal" data-md-color-accent="teal" aria-label="Switch to light mode" type="radio" name="__palette" id="__palette_1">
<label class="md-header__button md-icon" title="Switch to light mode" for="__palette_0" hidden>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 7a5 5 0 0 1 5 5 5 5 0 0 1-5 5 5 5 0 0 1-5-5 5 5 0 0 1 5-5m0 2a3 3 0 0 0-3 3 3 3 0 0 0 3 3 3 3 0 0 0 3-3 3 3 0 0 0-3-3m0-7 2.39 3.42C13.65 5.15 12.84 5 12 5c-.84 0-1.65.15-2.39.42L12 2M3.34 7l4.16-.35A7.2 7.2 0 0 0 5.94 8.5c-.44.74-.69 1.5-.83 2.29L3.34 7m.02 10 1.76-3.77a7.131 7.131 0 0 0 2.38 4.14L3.36 17M20.65 7l-1.77 3.79a7.023 7.023 0 0 0-2.38-4.15l4.15.36m-.01 10-4.14.36c.59-.51 1.12-1.14 1.54-1.86.42-.73.69-1.5.83-2.29L20.64 17M12 22l-2.41-3.44c.74.27 1.55.44 2.41.44.82 0 1.63-.17 2.37-.44L12 22Z"/></svg>
</label>
</form>
<script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
<label class="md-header__button md-icon" for="__search">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
</label>
<div class="md-search" data-md-component="search" role="dialog">
<label class="md-search__overlay" for="__search"></label>
<div class="md-search__inner" role="search">
<form class="md-search__form" name="search">
<input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
<label class="md-search__icon md-icon" for="__search">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
</label>
<nav class="md-search__options" aria-label="Search">
<button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
</button>
</nav>
<div class="md-search__suggest" data-md-component="search-suggest"></div>
</form>
<div class="md-search__output">
<div class="md-search__scrollwrap" data-md-scrollfix>
<div class="md-search-result" data-md-component="search-result">
<div class="md-search-result__meta">
Initializing search
</div>
<ol class="md-search-result__list" role="presentation"></ol>
</div>
</div>
</div>
</div>
</div>
<div class="md-header__source">
<a href="https://git.resf.org/testing/wiki" title="Go to repository" class="md-source" data-md-component="source">
<div class="md-source__icon md-icon">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
</div>
<div class="md-source__repository">
testing/wiki
</div>
</a>
</div>
</nav>
</header>
<div class="md-container" data-md-component="container">
<main class="md-main" data-md-component="main">
<div class="md-main__inner md-grid">
<div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
<div class="md-sidebar__scrollwrap">
<div class="md-sidebar__inner">
<nav class="md-nav md-nav--primary md-nav--integrated" aria-label="Navigation" data-md-level="0">
<label class="md-nav__title" for="__drawer">
<a href="../../.." title="Testing Wiki" class="md-nav__button md-logo" aria-label="Testing Wiki" data-md-component="logo">
<img src="../../../assets/icon-white.svg" alt="logo">
</a>
Testing Wiki
</label>
<div class="md-nav__source">
<a href="https://git.resf.org/testing/wiki" title="Go to repository" class="md-source" data-md-component="source">
<div class="md-source__icon md-icon">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
</div>
<div class="md-source__repository">
testing/wiki
</div>
</a>
</div>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../.." class="md-nav__link">
<span class="md-ellipsis">
Testing Team Wiki
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../members/" class="md-nav__link">
<span class="md-ellipsis">
Members
</span>
</a>
</li>
<li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" checked>
<div class="md-nav__link md-nav__container">
<a href="../../" class="md-nav__link ">
<span class="md-ellipsis">
Documentation
</span>
</a>
<label class="md-nav__link " for="__nav_3" id="__nav_3_label" tabindex="">
<span class="md-nav__icon md-icon"></span>
</label>
</div>
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="true">
<label class="md-nav__title" for="__nav_3">
<span class="md-nav__icon md-icon"></span>
Documentation
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../qa_test_cases/" class="md-nav__link">
<span class="md-ellipsis">
QA:Test Cases
</span>
</a>
</li>
<li class="md-nav__item md-nav__item--active md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3_3" checked>
<label class="md-nav__link" for="__nav_3_3" id="__nav_3_3_label" tabindex="0">
<span class="md-ellipsis">
Wiki Development Guides
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_3_label" aria-expanded="true">
<label class="md-nav__title" for="__nav_3_3">
<span class="md-nav__icon md-icon"></span>
Wiki Development Guides
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../wiki_development_boxes/" class="md-nav__link">
<span class="md-ellipsis">
Development Box Setup
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../commit_signing/" class="md-nav__link">
<span class="md-ellipsis">
Git Commit Signing
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../openqa_access/" class="md-nav__link">
<span class="md-ellipsis">
openQA - Access
</span>
</a>
</li>
<li class="md-nav__item md-nav__item--active">
<input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
<label class="md-nav__link md-nav__link--active" for="__toc">
<span class="md-ellipsis">
openQA - openqa-cli POST Examples
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<a href="./" class="md-nav__link md-nav__link--active">
<span class="md-ellipsis">
openQA - openqa-cli POST Examples
</span>
</a>
<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
<label class="md-nav__title" for="__toc">
<span class="md-nav__icon md-icon"></span>
Table of contents
</label>
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
<li class="md-nav__item">
<a href="#system-access-requirements" class="md-nav__link">
<span class="md-ellipsis">
System / Access Requirements
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#basic-post" class="md-nav__link">
<span class="md-ellipsis">
Basic POST
</span>
</a>
<nav class="md-nav" aria-label="Basic POST">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#flavorboot-iso" class="md-nav__link">
<span class="md-ellipsis">
FLAVOR=boot-iso
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#flavorminimal-iso" class="md-nav__link">
<span class="md-ellipsis">
FLAVOR=minimal-iso
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#flavorpackage-set" class="md-nav__link">
<span class="md-ellipsis">
FLAVOR=package-set
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#advanced-post" class="md-nav__link">
<span class="md-ellipsis">
Advanced POST
</span>
</a>
<nav class="md-nav" aria-label="Advanced POST">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#flavordvd-iso" class="md-nav__link">
<span class="md-ellipsis">
FLAVOR=dvd-iso
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#flavoruniversal" class="md-nav__link">
<span class="md-ellipsis">
FLAVOR=universal
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#collection-of-test-suites-by-build" class="md-nav__link">
<span class="md-ellipsis">
Collection of test suites by BUILD
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#references" class="md-nav__link">
<span class="md-ellipsis">
References
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="../openqa_clone_job_examples/" class="md-nav__link">
<span class="md-ellipsis">
openQA - openqa-clone-job Examples
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../openqa_clone_custom_git_refspec_examples/" class="md-nav__link">
<span class="md-ellipsis">
openQA - openqa-clone-custom-git-refspec Examples
</span>
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--section md-nav__item--nested">
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_4" >
<div class="md-nav__link md-nav__container">
<a href="../../../guidelines/" class="md-nav__link ">
<span class="md-ellipsis">
Guidelines
</span>
</a>
<label class="md-nav__link " for="__nav_4" id="__nav_4_label" tabindex="">
<span class="md-nav__icon md-icon"></span>
</label>
</div>
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_4">
<span class="md-nav__icon md-icon"></span>
Guidelines
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item md-nav__item--nested">
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_4_2" >
<label class="md-nav__link" for="__nav_4_2" id="__nav_4_2_label" tabindex="0">
<span class="md-ellipsis">
Release Criteria & Status
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_4_2_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_4_2">
<span class="md-nav__icon md-icon"></span>
Release Criteria & Status
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../../guidelines/release_criteria/release_criteria/" class="md-nav__link">
<span class="md-ellipsis">
Rocky Linux Release Criteria & Status
</span>
</a>
</li>
<li class="md-nav__item md-nav__item--nested">
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_4_2_2" >
<label class="md-nav__link" for="__nav_4_2_2" id="__nav_4_2_2_label" tabindex="0">
<span class="md-ellipsis">
Rocky Linux 8
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="3" aria-labelledby="__nav_4_2_2_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_4_2_2">
<span class="md-nav__icon md-icon"></span>
Rocky Linux 8
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../../guidelines/release_criteria/r8/8_release_criteria/" class="md-nav__link">
<span class="md-ellipsis">
Rocky Linux 8 Release Criteria
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../guidelines/release_criteria/r8/8.6_qa_testing_summary/" class="md-nav__link">
<span class="md-ellipsis">
Rocky Linux 8.6 QA and Testing Summary
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../guidelines/release_criteria/r8/8.6_qa_testing_go_no_go/" class="md-nav__link">
<span class="md-ellipsis">
Rocky Linux 8.6 GO / NO-GO Status
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--nested">
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_4_2_3" >
<label class="md-nav__link" for="__nav_4_2_3" id="__nav_4_2_3_label" tabindex="0">
<span class="md-ellipsis">
Rocky Linux 9
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="3" aria-labelledby="__nav_4_2_3_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_4_2_3">
<span class="md-nav__icon md-icon"></span>
Rocky Linux 9
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../../guidelines/release_criteria/r9/9_release_criteria/" class="md-nav__link">
<span class="md-ellipsis">
Rocky Linux 9 Release Criteria
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../guidelines/release_criteria/r9/9.0_qa_testing_summary/" class="md-nav__link">
<span class="md-ellipsis">
Rocky Linux 9.0 QA and Testing Summary
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../guidelines/release_criteria/r9/9.0_qa_testing_go_no_go/" class="md-nav__link">
<span class="md-ellipsis">
Rocky Linux 9.0 GO / NO-GO Status
</span>
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="../../../guidelines/openqa_manual_install/" class="md-nav__link">
<span class="md-ellipsis">
openQA Manual Install
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--section md-nav__item--nested">
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_5" >
<div class="md-nav__link md-nav__container">
<a href="../../../sop/" class="md-nav__link ">
<span class="md-ellipsis">
SOP
</span>
</a>
<label class="md-nav__link " for="__nav_5" id="__nav_5_label" tabindex="">
<span class="md-nav__icon md-icon"></span>
</label>
</div>
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_5">
<span class="md-nav__icon md-icon"></span>
SOP
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../../sop/openqa_sop_operator_access/" class="md-nav__link">
<span class="md-ellipsis">
SOP: openQA Operator Access Request
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../sop/openqa_sop_operator_removal/" class="md-nav__link">
<span class="md-ellipsis">
SOP: openQA Operator Access Removal
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../sop/openqa_sop_system_upgrades/" class="md-nav__link">
<span class="md-ellipsis">
SOP: openQA System Upgrades
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../sop/sop_repocompare/" class="md-nav__link">
<span class="md-ellipsis">
SOP: Repocompare
</span>
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</div>
</div>
</div>
<div class="md-content" data-md-component="content">
<article class="md-content__inner md-typeset">
<a href="https://git.resf.org/testing/wiki/_edit/main/docs/documentation/dev_guides/openqa_cli_post_examples.md" title="Edit this page" class="md-content__button md-icon">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
</a>
<h1 id="openqa-cli-post-examples">openqa-cli POST Examples<a class="headerlink" href="#openqa-cli-post-examples" title="Permanent link">&para;</a></h1>
<p>This page will provide a brief overview of some basic <code>openqa-cli</code> <code>POST</code> examples.</p>
<h2 id="system-access-requirements">System / Access Requirements<a class="headerlink" href="#system-access-requirements" title="Permanent link">&para;</a></h2>
<p>To complete any of the examples please complete the API <code>POST</code> Access steps outlined in the <a href="../openqa_access/">openQA - Access</a> document.</p>
<h2 id="basic-post">Basic POST<a class="headerlink" href="#basic-post" title="Permanent link">&para;</a></h2>
<p>A basic <code>POST</code> can be used for any of the default test suites for the various Rocky Linux media that are made available. The following examples show some of these standard <code>POST</code>s that are commonly used by our team and will be used to demonstrate how some minor variations.</p>
<h3 id="flavorboot-iso">FLAVOR=boot-iso<a class="headerlink" href="#flavorboot-iso" title="Permanent link">&para;</a></h3>
<p>This first <code>POST</code> is the most basic, simply providing the minimal set of variables required to trigger the standard test suite for the Rocky Linux 9.1 boot ISO on openqa workers for the <code>x86_64</code> architecture. All tests of the test suite are predetermined and configure on the openQA server. Since the boot ISO doesn't contain any packages this test suite is effectively a network install from standard Rocky Linux repository servers and/or mirrors.</p>
<div class="highlight"><pre><span></span><code>$<span class="w"> </span>openqa-cli<span class="w"> </span>api<span class="w"> </span>-X<span class="w"> </span>POST<span class="w"> </span>isos<span class="w"> </span><span class="nv">ISO</span><span class="o">=</span>Rocky-9.1-x86_64-boot.iso<span class="w"> </span><span class="nv">ARCH</span><span class="o">=</span>x86_64<span class="w"> </span><span class="se">\</span>
<span class="w"> </span><span class="nv">DISTRI</span><span class="o">=</span>rocky<span class="w"> </span><span class="nv">FLAVOR</span><span class="o">=</span>boot-iso<span class="w"> </span><span class="nv">VERSION</span><span class="o">=</span><span class="m">9</span>.1<span class="w"> </span><span class="nv">CURRREL</span><span class="o">=</span><span class="m">9</span><span class="w"> </span><span class="nv">BUILD</span><span class="o">=</span><span class="m">20230409</span>-Rocky-9.1-x86_64.0
</code></pre></div>
<h3 id="flavorminimal-iso">FLAVOR=minimal-iso<a class="headerlink" href="#flavorminimal-iso" title="Permanent link">&para;</a></h3>
<p>This <code>POST</code> demonstrates how a different media type, in this case the minimal ISO, for an alternate Rocky Linux version, in this case Rocky Linux 8.7, can be triggered. As can be seen by this and the previous <code>POST</code> the <code>BUILD</code> variable will typically be designate the date, version and architecture of the test suite. Since the minimal ISO contains all packages required to conduct a <strong><em>minimal</em></strong> install of Rocky Linux that is the behavior of this test suite.</p>
<div class="highlight"><pre><span></span><code>$<span class="w"> </span>openqa-cli<span class="w"> </span>api<span class="w"> </span>-X<span class="w"> </span>POST<span class="w"> </span>isos<span class="w"> </span><span class="nv">ISO</span><span class="o">=</span>Rocky-8.7-x86_64-minimal.iso<span class="w"> </span><span class="nv">ARCH</span><span class="o">=</span>x86_64<span class="w"> </span><span class="se">\</span>
<span class="w"> </span><span class="nv">DISTRI</span><span class="o">=</span>rocky<span class="w"> </span><span class="nv">FLAVOR</span><span class="o">=</span>minimal-iso<span class="w"> </span><span class="nv">VERSION</span><span class="o">=</span><span class="m">8</span>.7<span class="w"> </span><span class="nv">CURRREL</span><span class="o">=</span><span class="m">8</span><span class="w"> </span><span class="nv">BUILD</span><span class="o">=</span><span class="m">20230409</span>-Rocky-8.7-x86_64.0
</code></pre></div>
<h3 id="flavorpackage-set">FLAVOR=package-set<a class="headerlink" href="#flavorpackage-set" title="Permanent link">&para;</a></h3>
<p>This <code>POST</code> demonstrates specification of the final normal media type, the dvd ISO, along with what is called a <code>FLAVOR</code>, in this case <code>package-set</code> for the <code>x86_64</code> architecture and Rocky Linux 9.1. Since the dvd ISO contains all of the packages available at release of a specific version or Rocky Linux the <code>package-set</code> test suite will test installation of all primary installation types of Rocky Linux not included in the <code>minimal-iso</code> test suite above.</p>
<div class="highlight"><pre><span></span><code>$<span class="w"> </span>openqa-cli<span class="w"> </span>api<span class="w"> </span>-X<span class="w"> </span>POST<span class="w"> </span>isos<span class="w"> </span><span class="nv">ISO</span><span class="o">=</span>Rocky-9.1-20221214.1-x86_64-dvd.iso<span class="w"> </span><span class="nv">ARCH</span><span class="o">=</span>x86_64<span class="w"> </span><span class="se">\</span>
<span class="w"> </span><span class="nv">DISTRI</span><span class="o">=</span>rocky<span class="w"> </span><span class="nv">FLAVOR</span><span class="o">=</span>package-set<span class="w"> </span><span class="nv">VERSION</span><span class="o">=</span><span class="m">9</span>.1<span class="w"> </span><span class="nv">CURRREL</span><span class="o">=</span><span class="m">9</span><span class="w"> </span><span class="nv">BUILD</span><span class="o">=</span><span class="m">20230409</span>-Rocky-9.1-x86_64.0
</code></pre></div>
<p>These three test suites provide for the minimal testing of all ISOs produced for a given release of Rocky Linux. </p>
<h2 id="advanced-post">Advanced POST<a class="headerlink" href="#advanced-post" title="Permanent link">&para;</a></h2>
<p>In addition to the <a href="#basic-post">Basic POSTs</a> described above there are additional default test suites that use the dvd ISO media and include substantially more test cases. Those include:</p>
<ul>
<li>installing in graphical, text and serial console</li>
<li>installation for standard BIOS and UEFI</li>
<li>validation of the Anaconda help system</li>
<li>disk layout variations including LVM, RAID, partition shrink and/or grow, iSCSI and LUKS</li>
<li>PXE installation from various network sources</li>
<li>installation in various languages</li>
</ul>
<p>Standard <code>POST</code>s for these test suites is very similar to the basic POSTs above and are shown below...</p>
<h3 id="flavordvd-iso">FLAVOR=dvd-iso<a class="headerlink" href="#flavordvd-iso" title="Permanent link">&para;</a></h3>
<div class="highlight"><pre><span></span><code>$<span class="w"> </span>openqa-cli<span class="w"> </span>api<span class="w"> </span>-X<span class="w"> </span>POST<span class="w"> </span>isos<span class="w"> </span><span class="nv">ISO</span><span class="o">=</span>Rocky-9.1-20221214.1-x86_64-dvd.iso<span class="w"> </span><span class="nv">ARCH</span><span class="o">=</span>x86_64<span class="w"> </span><span class="se">\</span>
<span class="w"> </span><span class="nv">DISTRI</span><span class="o">=</span>rocky<span class="w"> </span><span class="nv">FLAVOR</span><span class="o">=</span>dvd-iso<span class="w"> </span><span class="nv">VERSION</span><span class="o">=</span><span class="m">9</span>.1<span class="w"> </span><span class="nv">CURRREL</span><span class="o">=</span><span class="m">9</span><span class="w"> </span><span class="nv">BUILD</span><span class="o">=</span><span class="m">20230409</span>-Rocky-9.1-x86_64.0
</code></pre></div>
<h3 id="flavoruniversal">FLAVOR=universal<a class="headerlink" href="#flavoruniversal" title="Permanent link">&para;</a></h3>
<div class="highlight"><pre><span></span><code>$<span class="w"> </span>openqa-cli<span class="w"> </span>api<span class="w"> </span>-X<span class="w"> </span>POST<span class="w"> </span>isos<span class="w"> </span><span class="nv">ISO</span><span class="o">=</span>Rocky-9.1-20221214.1-x86_64-dvd.iso<span class="w"> </span><span class="nv">ARCH</span><span class="o">=</span>x86_64<span class="w"> </span><span class="se">\</span>
<span class="w"> </span><span class="nv">DISTRI</span><span class="o">=</span>rocky<span class="w"> </span><span class="nv">FLAVOR</span><span class="o">=</span>universal<span class="w"> </span><span class="nv">VERSION</span><span class="o">=</span><span class="m">9</span>.1<span class="w"> </span><span class="nv">CURRREL</span><span class="o">=</span><span class="m">9</span><span class="w"> </span><span class="nv">BUILD</span><span class="o">=</span><span class="m">20230409</span>-Rocky-9.1-x86_64.0
</code></pre></div>
<h2 id="collection-of-test-suites-by-build">Collection of test suites by BUILD<a class="headerlink" href="#collection-of-test-suites-by-build" title="Permanent link">&para;</a></h2>
<p>A feature of openQA is that for a given job group test suites which use the same <code>BUILD</code> identifier are collected into a single view in the web UI.</p>
<p><img alt="openQA Home View..." loading="lazy" src="/assets/images/openqa_home_view.png" /></p>
<p>Thus, the examples show above which all use <code>BUILD=20230409-Rocky-9.1-x86_64.0</code> are all shown in a single view. Additionally, that view is accessible via a predictable URI, for example <a href="https://openqa.rockylinux.org/tests/overview?build=20230409-Rocky-9.1-x86_64.0"><code>https://openqa.rockylinux.org/tests/overview?build=20230409-Rocky-9.1-x86_64.0</code></a> as shown below...</p>
<p><img alt="openQA Build View..." loading="lazy" src="/assets/images/openqa_build_view.png" /></p>
<h2 id="references">References<a class="headerlink" href="#references" title="Permanent link">&para;</a></h2>
<p><a href="https://open.qa/documentation/">openQA Documentation</a></p>
<h3>Additional Information</h3>
<div class="tabbed-set tabbed-alternate" data-tabs="1:3"><input checked="checked" id="__tabbed_1_1" name="__tabbed_1" type="radio" /><input id="__tabbed_1_2" name="__tabbed_1" type="radio" /><input id="__tabbed_1_3" name="__tabbed_1" type="radio" /><div class="tabbed-labels"><label for="__tabbed_1_1">Contact</label><label for="__tabbed_1_2">Disclaimer</label><label for="__tabbed_1_3">License</label></div>
<div class="tabbed-content">
<div class="tabbed-block">
<p>If you have questions with respect to this content or to report concerns regarding the use or misuse content please do not hesitate to contact us at <a href="mailto:info@rockylinux.org">info@rockylinux.org</a>.</p>
</div>
<div class="tabbed-block">
<p>Rocky Linux and the Rocky Enterprise Software Foundation (RESF) does not make any express or implied warranties, including but not limited to the warranties of non-infringement of any third party intellectual property rights. RESF does not warrant that any pending trademark applications for trademarks of RESF will result in any granted trademark protection. RESF shall not be liable for any claims relating to user's activities falling within the scope of the permission and user hereby agrees to indemnify, defend and hold RESF and its contributors harmless against any such claim.</p>
</div>
<div class="tabbed-block">
<p>This content is licensed under under <a href="https://creativecommons.org/licenses/by-sa/4.0/">Attribution-Share Alike 4.0 International</a> license unless otherwise noted.</p>
</div>
</div>
</div>
<aside class="md-source-file">
<span class="md-source-file__fact">
<span class="md-icon" title="Last update">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1-2.1-2M12.5 7v5.2l4 2.4-1 1L11 13V7h1.5M11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2v1.8Z"/></svg>
</span>
<span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">April 21, 2024</span>
</span>
</aside>
</article>
</div>
<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
</div>
<button type="button" class="md-top md-icon" data-md-component="top" hidden>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8v12Z"/></svg>
Back to top
</button>
</main>
<footer class="md-footer">
<div class="md-footer-meta md-typeset">
<div class="md-footer-meta__inner md-grid">
<div class="md-copyright">
<div class="md-copyright__highlight">
Copyright &copy; 2023 Rocky Enterprise Software Foundation
</div>
Made with
<a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
Material for MkDocs
</a>
</div>
</div>
</div>
</footer>
</div>
<div class="md-dialog" data-md-component="dialog">
<div class="md-dialog__inner md-typeset"></div>
</div>
<script id="__config" type="application/json">{"base": "../../..", "features": ["navigation.expand", "navigation.indexes", "navigation.instant", "navigation.sections", "navigation.top", "navigation.tracking", "navigation.path", "search.highlight", "search.suggest", "toc.integrate", "content.action.edit"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
<script src="../../../assets/javascripts/bundle.dd8806f2.min.js"></script>
</body>
</html>