View source for QA:Testcase toolbox

{{QA/Test_Case
|description=This test case ensures that Fedora can successfully use Toolbox for managing containers, specifically by listing, creating, and running Toolbox containers. Optionally, this test case can also be used to test a specific Toolbox container image, for instance the one produced by a Fedora compose undergoing validation testing.
|setup=Download and install the latest version of Fedora on a bare metal system or virtual machine. Ensure that {{package|toolbox}} is installed on the system.
|actions=
* Open a terminal on the Fedora system.
* Optionally, to test a specific Toolbox container image - e.g. when doing release validation testing:
*# Download the image (for release validation testing, you can find the URL for the Toolbox image from the ''Container_Toolbox docker'' row of the image table at the top of the validation matrix page).
*# Import the image by running {{command|skopeo copy docker-archive:/path/to/imagefile containers-storage:registry.fedoraproject.org/fedora-toolbox:{{FedoraVersionNumber|next}}}}. Replace {{code|/path/to/imagefile}} with the actual path to the downloaded image, and adjust the release number as appropriate.
* Execute the command <code>toolbox list</code> to display the list of available Toolbox containers. Note the initial number of containers.
* Execute the command <code>toolbox create</code> to create a new Toolbox container using the default settings.
** If you are testing a specific toolbox container image, and the release number you used when importing it is not the same as the release number for the host distribution, run {{command|toolbox create --release {{FedoraVersionNumber|next}}}}, or whatever the appropriate number is. If you do this correctly, toolbox should not prompt you to download an image.
* Execute the command <code>toolbox list</code> again to verify that the new container has been created and is listed.
* Execute the command <code>toolbox enter</code> to enter the newly created Toolbox container.
** If you are testing a specific toolbox container image, and the release number you used when importing it is not the same as the release number for the host system, run {{command|toolbox enter --release {{FedoraVersionNumber|next}}}}, or whatever the appropriate number is.
* Inside the Toolbox container, execute the command <code>echo "Hello from Toolbox"</code> to verify that commands can be run within the container.
* Exit the Toolbox container by executing the command exit.
|results=   
* The toolbox list command displays the list of available Toolbox containers without errors.
* The toolbox create command successfully creates a new Toolbox container.
* The new container is listed in the output of the toolbox list command after creation.
* The toolbox enter command successfully enters the newly created Toolbox container.
* Commands can be executed within the Toolbox container, as shown by the output of the echo command.
* The exit command successfully exits the Toolbox container.
    
|optional=Optionally, test different Toolbox configurations, such as creating containers with custom names, creating containers based on different images, and running various commands within the containers to ensure that Fedora can handle a wide range of Toolbox scenarios.
    }}

[[Category:Package_toolbox_test_cases]]
[[Category:Base_Acceptance_Test_Cases]]