From Fedora Project Wiki

(Migrated to the new Fedora docs site)
 
(28 intermediate revisions by 5 users not shown)
Line 1: Line 1:
'''Continuous integration''' aims to ensure broken changes do not affect other developers, packagers, maintainers or users. Continuous delivery aims to ensure broken changes do not get delivered or released.
Page moved to: https://docs.fedoraproject.org/en-US/ci/
 
= The Manifesto =
 
Because there are several Continuous Integration efforts, we need to set the basic rules to make sure we’re all playing the same game. When we call a game “football” we need to agree on what that means.
 
Here is a [[CI/Manifesto|Continuous Integration manifesto]] that helps describe the goals, terminology, and rules.
 
= Tests locations =
 
The tests to be executed are stored in the dist-git repositories. The tests are stored or wrapped along-side the spec files that describe the software sources. The tests are branched, maintained along with the package or module they pertain to.
 
Package or RPM specific tests are stored in that package's [https://src.fedoraproject.org/cgit/rpms/ dist-git repository]. Such package repositories will have a <code>rpms/</code> prefix in their name. Other tests refer to larger sets of functionality, [[Modularity|called modules]] and are [https://src.fedoraproject.org/cgit/modules/ stored in a dist-git repository] with <code>modules/</code> prefix in their name.
 
* To checkout a dist-git repo, use [[Package_maintenance_guide|fedpkg tooling]].
* To contribute tests to a dist-git repository get a [https://admin.fedoraproject.org/accounts/ Fedora Account].
* Use Pagure.io to contribute to a dist-git repository using a GitHub style interface.
** '''Done'''
** Contact: [[User:Pingou|Pierre Yves-Chibon]]
* To move or wrap downstream tests to Fedora, use https://upstreamfirst.fedorainfracloud.org/
** Contact: [[User:Tflink|Tim Flink]]
 
= Test format =
 
Tests may be written all sorts of different ways, but have to be exposed and invoked in a standard way. They are stored or wrapped in the <code>tests/</code> directory in a dist-git repository. There is a detailed description of how this is done:
 
* [[CI/Tests|How to run, write and wrap tests]]
* [[Changes/InvokingTests|Standard Spec for Invoking Tests]]
* Helpful [https://pagure.io/standard-test-roles standard-test-roles for wrapping or writing tests].
 
= Gating =
 
When a test fails, continuous integration will be able to prevent the broken package change from affecting other changes. That gating will happen in Bodhi. Packages in the core operating system, such as those in [https://getfedora.org/en/atomic/ Fedora Atomic Host] are most interesting for gating, as when they break they affect the most users.
 
* Modules and packages will be able to opt into gating.
* [[FedoraAtomicCI/gating|Proposals and options]]
* '''Ready: August 2017'''
 
 
== Opting-in ==
 
This effort focus on the packages that are part of the Fedora Atomic Host at first, if can prepare tests for your packages but if they are not part of the Fedora Atomic Host, these tests will not be run and their results not be considered for gating. This is to limit the set of packages considered and allow an iterative approach starting small and growing from there. We do aim to provide testing for more than just the Fedora Atomic Host packages but we needed to start somewhere.
 
If your packages are part of Fedora Atomic Host, we strongly encourage you to join this effort. The procedure to opt-in is fairly simple
 
* read the documentation ([[CI#Test_format| above]]) about the tests format and how to invoke them
* add these tests in a ''tests/'' folder in the dist-git repository of your packages
 
Simply adding the tests in a ''tests/'' folder in the dist-git repository of your packages will be considered as a will to have these tests run and gate your packages.
 
If you have any questions about the tests or the gating, feel free to reach out to us (cf the Contact section below).
 
 
== Notifications ==
 
Notifications about CI results will be available in two ways:
 
* [https://apps.fedoraproject.org/notifications FMN] has been adjusted to notify by default every packager when any step of the CI pipeline fails on one of the package they maintain. So if you are a kernel maintainer and a commit made to the kernel dist-git repository fails to compose an OSTree, FMN will notify you of it.
 
* Bodhi will include the Fedora Atomic CI results in its update page, just as it already includes tests results from taskotron.
 
= Testing pipeline =
 
The pipeline is under development
 
* Source Code: https://github.com/CentOS-PaaS-SIG/ci-pipeline
* Documentation: https://github.com/CentOS-PaaS-SIG/ci-pipeline/blob/master/README.md
* [[FedoraAtomicCI/pipeline|More pipeline description]]
* [[FedoraAtomicCI/KojiBuilds|Build options and ideas]]
* [[FedoraAtomicCI/upstream|Possibilities for upstream open-source project integration]]
* [[Fedora requirements for CI and CD]] -- assembled from input from key members of [[Infrastructure]] and [[Release Engineering]]
 
= Contact =
 
To get involved:
 
* <code>#fedora-ci</code> on FreeNode
* Mailing list: ci@lists.fedoraproject.org
* If you don't know where to go: [https://pagure.io/fedora-ci/AtomicCi pagure.io/fedora-ci/AtomicCi]
 
[[Category:FedoraAtomicCi]]

Latest revision as of 15:46, 18 March 2019