diff --git a/build-selected.png b/build-selected.png new file mode 100644 index 00000000..ed2df817 Binary files /dev/null and b/build-selected.png differ diff --git a/docs/Process_CI.md b/docs/Process_CI.md new file mode 100644 index 00000000..dfc5e7c1 --- /dev/null +++ b/docs/Process_CI.md @@ -0,0 +1,57 @@ +# Build pipelines + +
+ +Armbian Build pipelines are combination of Github Actions and scripts that run on our servers. Armbian is providing a large quantity of compiled binaries and images which builds are distributed over our self-hosted build farm. + +
+ +## Nightly builds + +
+ +![Build](images/main-pipeline.png) + +- edge branch in https://apt.armbian.com +- all branches in https://beta.armbian.com +- rootfs cache +
+ The repository indexes for BETA are updated immediately. + +
+
+Trigger: every day at 6am CET +
+Condition: change in packages, upstream sources, patches or configuration + +## Updating all beta images + +
+ +![Updating all beta images](images/betaimages.png) + +
+ +- triggered manually or uppon completion of nightly / edge builds; +- running the job manual is possible, +- pipeline is always using packages from https://beta.armbian.com repository. + +
+ +## Updating selected stable images +
+
+ +If you have a commit rights to the repository, go to [Armbian build system actions](https://github.com/armbian/build/actions) and select *Build selected*: + +
+ +![Updating selected stable images](images/build-selected-blured.png) + +You can recreate image(s) from sources - set `packages from repository` to *no* - or from packages that are already in repository (default). In case you choose to build from sources, stable https://apt.armbian.com repository is going to be populated with newly created u-boot, kernel and **BSP packages for all boards** under (patched) stable version (yy.mm.**x+1**) which is incremented automatically if process succeeds. + +![kanban screenshot](images/stable-images.png) + +
+ +When new artifacts are created for stable builds, content is uploaded to CDN, then download and repository indexes are updated. The process is typically complete in 1 to 2 days for major releases. diff --git a/docs/images/betaimages.png b/docs/images/betaimages.png new file mode 100644 index 00000000..1016f936 Binary files /dev/null and b/docs/images/betaimages.png differ diff --git a/docs/images/build-selected-blured.png b/docs/images/build-selected-blured.png new file mode 100644 index 00000000..7d9d11b8 Binary files /dev/null and b/docs/images/build-selected-blured.png differ diff --git a/docs/images/build-single-clean.png b/docs/images/build-single-clean.png new file mode 100644 index 00000000..92682ad0 Binary files /dev/null and b/docs/images/build-single-clean.png differ diff --git a/docs/images/buildselected.png b/docs/images/buildselected.png new file mode 100644 index 00000000..ef852e4b Binary files /dev/null and b/docs/images/buildselected.png differ diff --git a/docs/images/main-pipeline.png b/docs/images/main-pipeline.png new file mode 100644 index 00000000..2f722d72 Binary files /dev/null and b/docs/images/main-pipeline.png differ diff --git a/docs/images/selected-images.png b/docs/images/selected-images.png new file mode 100644 index 00000000..3494640a Binary files /dev/null and b/docs/images/selected-images.png differ diff --git a/docs/images/stable-images.png b/docs/images/stable-images.png new file mode 100644 index 00000000..3e8a674e Binary files /dev/null and b/docs/images/stable-images.png differ diff --git a/mkdocs.yml b/mkdocs.yml index 4048dd19..df7e5596 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -79,6 +79,7 @@ nav: - "Contributor Process" : - "Contribute" : "Process_Contribute.md" - "Merge Policy" : "Process_Merge-Policy.md" + - "Continuous integration" : "Process_CI.md" - "Documentation" : "Process_Documentation.md" - "Release management" :