From Fedora Project Wiki

(simpler expectations)
 
(6 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
{{QA/Test_Case
 
{{QA/Test_Case
|description= Install Fedora CoreOS in a libvirt. For the sake of the testing the freshly-oven-baked changes, we would be using the <code>next</code> image.  
+
|description=Install Fedora CoreOS as a virtual machine using the <code>next</code> image.
 
|setup=
 
|setup=
# Download and verify the latest [https://getfedora.org/coreos/download?tab=metal_virtualized&stream=next FCOS <b>next</b> image for QEMU]
+
# Download and verify the latest [https://getfedora.org/coreos/download?tab=metal_virtualized&stream=next FCOS '''next''' image for QEMU]
 +
# Familiarize yourself with FCOS [https://docs.fedoraproject.org/en-US/fedora-coreos/getting-started/#_provisioning_philosophy provisioning philosophy], i.e. the role of a an Ignition file during system installation.
  
 
|actions=
 
|actions=
# Prepare an Ignition file to configure your FCOS instance. Read [https://docs.fedoraproject.org/en-US/fedora-coreos/getting-started/#_provisioning_philosophy Provisioning Philosophy]
+
# [https://docs.fedoraproject.org/en-US/fedora-coreos/producing-ign/ Create an Ignition config]. You can use the simplest example available which includes your SSH key.
# [https://docs.fedoraproject.org/en-US/fedora-coreos/producing-ign/ Produce the ignition file].
+
# Follow the documentation for [https://docs.fedoraproject.org/en-US/fedora-coreos/provisioning-libvirt/ launching with libvirt] or [https://docs.fedoraproject.org/en-US/fedora-coreos/provisioning-qemu/ launching with QEMU] to start up a virtual machine.
# Follow [https://docs.fedoraproject.org/en-US/fedora-coreos/getting-started/#_launching_with_qemu_or_libvirt Launching with QEMU or libvirt] documentation to start up a virtual machine.
+
# You should be able to see the IP address printed at the login prompt of the serial console.
 +
# SSH into the machine using `ssh username@ipaddress` (replace ''username'' and ''ipaddress'' with actual values).
  
 
|results=
 
|results=
The following must be true to consider this a successful test run:
+
# The system runs in a virtual machine according to the instructions.
# Confirm that you can SSH successfully into the machine according to the instructions (and the contents of your Ignition file).
+
# You can read the IP address of the machine from the serial console.
# Verify the linked documentation works without a hitch and all steps are understandable.
+
# You can connect to the machine via SSH.
# The virtual machine once destroyed, should deallocate all resources.
+
# The linked documentation is clear, all steps are understandable, and nothing important is missing from it.
 +
}}
  
|optional=If you see some issues, investigate the logs in journal, make sure the services are running.
+
[[Category:CoreOS Test Cases]]
# To be added
 
}}
 

Latest revision as of 19:17, 6 November 2020

Description

Install Fedora CoreOS as a virtual machine using the next image.

Setup

  1. Download and verify the latest FCOS next image for QEMU
  2. Familiarize yourself with FCOS provisioning philosophy, i.e. the role of a an Ignition file during system installation.

How to test

  1. Create an Ignition config. You can use the simplest example available which includes your SSH key.
  2. Follow the documentation for launching with libvirt or launching with QEMU to start up a virtual machine.
  3. You should be able to see the IP address printed at the login prompt of the serial console.
  4. SSH into the machine using ssh username@ipaddress (replace username and ipaddress with actual values).

Expected Results

  1. The system runs in a virtual machine according to the instructions.
  2. You can read the IP address of the machine from the serial console.
  3. You can connect to the machine via SSH.
  4. The linked documentation is clear, all steps are understandable, and nothing important is missing from it.