Project

General

Profile

Actions
Copy link

action #179485

closed

Document self-service workflow for setup of new machines

Added by livdywan 28 days ago. Updated 22 days ago.

Status:
Resolved
Priority:
Low
Assignee:
okurz
Category:
Feature requests
Target version:
openQA Project (public) - Ready
Start date:
Due date:
% Done:

0%

Estimated time:
Tags:
infra, reactive work

Description

Motivation

Machines are newly setup or repurposed once in a while. Allowing individual squads to setup hardware themselves can help get things done quicker. However documentation on this process is sparse.

Acceptance Criteria

  • AC1: Members of squads other than QE Tools have access to documentation on how to setup hardware
  • AC2: Setup steps are documented in a way that can be easily looked up and linked to

Suggestions

  • Provide a template with steps to follow to setup new machines
    • How to setup IPMI and the according management web interface
    • Ensure access via QA engineering networks in DE, CZ, BJ
    • DNS hostname and zones
    • Setup of ipxe
    • Integration with OSD / salt / workerconf.sls
    • Jira SD ticket flow
    • Provide a reference test to validate the setup
  • Consider existing Setup guide for new machines
  • Docs for qe infra
  • Ask members of squads for feedback e.g. from QE Virt

Related issues 1 (1 open — 0 closed)

Copied from openQA Infrastructure (public) - action #179380: Finish fundamental setup for orion to serve as a vmware 7 server in OSD size:SBlockedokurz2025-03-24

Actions
Actions
Copy link
 #1

Updated by livdywan 28 days ago

  • Copied from action #179380: Finish fundamental setup for orion to serve as a vmware 7 server in OSD size:S added
Actions
Copy link
 #2

Updated by okurz 28 days ago

  • Due date set to 2025-04-09
  • Status changed from New to Feedback
  • Assignee set to okurz
  • Priority changed from Normal to Low
  • Target version set to Ready

What do you guys think we can do to improve? I think existing documentation e.g. https://progress.opensuse.org/projects/openqav3/wiki/#Setup-guide-for-new-machines is already sufficient enough. The question is if people can discover the documentation.

Actions
Copy link
 #3

Updated by livdywan 28 days ago

okurz wrote in #note-2:

What do you guys think we can do to improve? I think existing documentation e.g. https://progress.opensuse.org/projects/openqav3/wiki/#Setup-guide-for-new-machines is already sufficient enough. The question is if people can discover the documentation.

I don't think you are the target audience here to be honest. See AC1 😉

Actions
Copy link
 #4

Updated by okurz 28 days ago

livdywan wrote in #note-3:

okurz wrote in #note-2:

What do you guys think we can do to improve? I think existing documentation e.g. https://progress.opensuse.org/projects/openqav3/wiki/#Setup-guide-for-new-machines is already sufficient enough. The question is if people can discover the documentation.

I don't think you are the target audience here to be honest. See AC1 😉

Exactly. That's why I am asking others for feedback. Who had problems finding documentation? Where did they look? And then we can say where they didn't look and maybe link back and forth

Actions
Copy link
 #5

Updated by okurz 22 days ago

  • Due date deleted (2025-04-09)
  • Status changed from Feedback to Resolved

Asked in https://suse.slack.com/archives/C02AJ1E568M/p1743495962170209

Hi about https://progress.opensuse.org/issues/179485 "Document self-service workflow for setup of new machines" what help would you guys need for installing up new machines?

No response. Calling this done based on what we already have documented.

Actions
Copy link

Also available in: Atom PDF