CI/Tests/HowToStart

Obsoleted Content
This page has been obsoleted by the Quick Start Guide.

== Contributing tests for Fedora Atomic Host CI ==

Documentation and Account

To start contributing you should read the following pages in the first place:

• https://fedoraproject.org/wiki/CI
• https://fedoraproject.org/wiki/Changes/InvokingTests
• https://fedoraproject.org/wiki/CI/Tests#Testing_an_Atomic_Host

Make sure you have a FAS account. You can also find useful information and tools related to working with packages in the Package maintenance guide:

• https://admin.fedoraproject.org/accounts/user/new
• https://fedoraproject.org/wiki/Package_maintenance_guide

Adding Tests

Clone repositories with tests and project code, run the tests:

• Clone tests from https://upstreamfirst.fedorainfracloud.org/
• Run them and make sure sure that all tests with Atomic tag are Passed.
• Clone project from https://src.fedoraproject.org/browse/projects/

Include tests into the project:

• Move tests into the project folder.
• Rename folder with tests to "tests".
• Make sure there are no *.log files inside.
• Don't forget to delete the .git/ folder.
• Make changes, create a new git branch, eg. git checkout -b new_tests.
• Commit (include links to the project in the commit links).

Example Commit Message:

Add CI tests using the standard test interface

Adding tests according to the CI wiki [0] and standard test interface [1]
[0] https://fedoraproject.org/wiki/CI
[1] https://fedoraproject.org/wiki/Changes/InvokingTests

Pull Request

Unless you are a Fedora packager follow instructions for creating a public git repo on fedorapeople and upload package folder there:

scp -r <package> @fedorapeople.org:public_git/

Navigate to the fedoraproject.org (select appropriate package). Press File Pull Request button then press Remote pull request.

Fill the required fields:

• Title: Add CI tests using the standard test interface
• Git repo address: git://fedorapeople.org/~<username>/<package folder>
• Git branch: new_tests
• To branch: master

• Press the Preview button.

Initial Comment

Add an Initial Comment with tests results. Make sure you mentioned right maintainer contact person. For example: