From Fedora Project Wiki

Template documentation [edit]

This documentation is transcluded from Template:Cloud test matrix/doc. It will not be transcluded on pages that use this template.
Wikitcms core page
This page is a core component of the Wikitcms system for storing release validation testing results in the Fedora wiki. This system relies on specific expectations regarding page naming, contents, and categorization. Please take special care when editing this page, especially if you change any element of wiki syntax, especially templating elements. If you are at all unsure about the consequences of your planned change, please contact the QA group before applying it.
This template contains the Cloud 'test matrix' of test cases that are usually executed as part of release validation testing. It is pulled into release validation results pages using several nested templates, and can be used in other pages as appropriate. If all you need to do is add, remove or edit a Cloud validation test case, though, don't worry about that stuff, and put it in here.

Cloud Provider Setup

Expand one of the sections below for instructions on setting up and running these testcases on a specific provider. More information can be found on the Fedora Cloud page and the Cloud Working Group website.

Amazon EC2 (via management console)

Personal account
  1. Obtain an AWS account (the approval process can take several hours).
Fedora group account

Amazon provides us with a community account. This account is currently used by: Fedora Infra, CentOS, Fedora-CI, openQA, logdetective, CoreOS, Cloud, ABRT, and others.

To avoid costs, you can contact the Infrastructure team and request access to Fedora's AWS account for testing purposes, per this SOP.

  1. Check your groups at https://accounts.fedoraproject.org/user/<ACCOUNT>.
  2. You must be in the aws-* FAS group (or another group with access) to perform this action.
  3. To access the AWS Console via Ipsilon authentication, use this SAML link.

Launch an Instance

  1. Log in to the AWS Management Console.
  2. Navigate to the EC2 console.
  3. To select the desired Amazon Machine Image (AMI), you can either:
    • Use the "Direct launch link" (if provided).
    • Search for and select the desired AMI in the IMAGES > AMIs section of the EC2 console.
  4. Ensure that your instance's security group is configured to allow SSH access (default TCP port 22).
  5. Launch an instance with the AMI.

Amazon EC2 (via Testing Farm)

Testing Farm Access - Testing Farm provides a streamlined way for Fedora and CentOS Stream contributors to access Amazon machines for testing. More information about public ranch users can be found here.

  1. Access Method: You can access Amazon images via Testing Farm; see the installation steps.
  2. Obtain API Key: Generate your public API key for Testing Farm. Note: The API key is shown only once and is distinct from the API ID. Generate API key.
  3. In Terminal: export TESTING_FARM_API_TOKEN=<TOKEN>
  4. Search: Find the appropriate nightly build and architecture from the latest datagrepper message (e.g., x86_64 or aarch64).
  5. In Terminal (Reserve Machine): Use the following command as an example: testing-farm request --sanity --compose Fedora-Cloud-Base-AmazonEC2.x86_64-Rawhide-20251119.0 --arch x86_64 --reserve

Openstack

  1. Use your own OpenStack deployment
  2. Provide or create an SSH keypair
  3. Make sure that your security group allows for SSH (default tcp port 22)
  4. Log in to the Horizon dashboard
  5. Find the image URL at http://cloud.fedoraproject.org/ or as provided in release candidate documents.
  6. Add the image to OpenStack, either using the OpenStack web dashboard (see step 4 here) or with glance image-create --name "Fedora version" --disk-format qcow2 --container-format bare --is-public true --copy-from url
  7. Launch the instance (in the dashboard, under the "Images" heading, click the "Launch" button for the appropriate image

Local testing

  1. You can deploy the cloud image locally either using the well-known virt-install tool or a Fedora-specific testcloud tool. See Local cloud testing with virt-install or Testcloud quickstart guide, respectively.
  2. Once logged in the virtual cloud instance, you can perform the tests below.

x86_64

Milestone Test Case EC2 (KVM) EC2 (Xen) Local (Optional) Openstack (Optional) Azure (Optional)
Basic QA:Testcase_base_startup
none
none
none
none
none
Basic QA:Testcase_base_reboot_unmount
none
none
none
none
none
Basic QA:Testcase_base_system_logging
none
none
none
none
none
Basic QA:Testcase_base_update_cli
none
none
none
none
none
Basic / Beta QA:Testcase_package_install_remove
none
none
none
none
none
Basic / Final QA:Testcase_base_artwork_release_identification
none
none
none
none
none
Final QA:Testcase_base_edition_self_identification
none
none
none
none
none
Final QA:Testcase_base_services_start
none
none
none
none
none
Final QA:Testcase_base_selinux
none
none
none
none
none
Final QA:Testcase_base_service_manipulation
none
none
none
none
none


aarch64

Milestone Test Case EC2 (KVM) Local (Optional) Openstack (Optional)
Basic QA:Testcase_base_startup
none
none
none
Basic QA:Testcase_base_reboot_unmount
none
none
none
Basic QA:Testcase_base_system_logging
none
none
none
Basic QA:Testcase_base_update_cli
none
none
none
Basic / Beta QA:Testcase_package_install_remove
none
none
none
Basic / Final QA:Testcase_base_artwork_release_identification
none
none
none
Final QA:Testcase_base_edition_self_identification
none
none
none
Final QA:Testcase_base_services_start
none
none
none
Final QA:Testcase_base_selinux
none
none
none
Final QA:Testcase_base_service_manipulation
none
none
none
Retrieved from "https://fedoraproject.org/w/index.php?title=Template:Cloud_test_matrix&oldid=755273"