Skip to content

Process_CI: point automation docs at armbian/ci (armbian/os deprecated) - #950

Open
igorpecovnik wants to merge 1 commit into
mainfrom
process-ci-move-to-ci
Open

Process_CI: point automation docs at armbian/ci (armbian/os deprecated)#950
igorpecovnik wants to merge 1 commit into
mainfrom
process-ci-move-to-ci

Conversation

@igorpecovnik

@igorpecovnik igorpecovnik commented Aug 2, 2026

Copy link
Copy Markdown
Member

The build automation moved out of the now-deprecated armbian/os repository:

  • Build pipelinearmbian/ci (reusable complete-artifact-matrix.yml + thin track wrappers build-standard-support, build-apps, build-all, build-nightly).
  • Repository / download-page / mirror automationarmbian/armbian.github.io.

This updates Process_CI.md to match:

  • standard-support / apps / all / nightly badges + links → armbian/ci build-*.yml
  • targets-all-not-eos.yamlarmbian/ci/userpatches/
  • repository update → armbian.github.io infrastructure-repository-update.yml
  • download-page refresh → armbian.github.io data-update-download-index.yml
  • dropped stable.json/nightly.json — versioning is now driven by GitHub releases on the target repo (versionOverride for stable, -trunk.N bump for nightly)
  • removed the Full distro test builds section (no armbian/ci equivalent)
  • added a deprecation note for armbian/os

The armbian/os wiki link for 3rd-party package import is kept (still valid).

Create docs preview on PR

Documentation website preview will be available shortly:


 Open WWW preview 

The build pipeline moved from armbian/os (deprecated) to armbian/ci, and
repository/download-page automation now lives in armbian.github.io. Update
all workflow/badge links accordingly:

- standard-support/apps/all/nightly -> armbian/ci build-*.yml workflows
- targets-all-not-eos.yaml -> armbian/ci/userpatches/
- repository-update -> armbian.github.io infrastructure-repository-update.yml
- webindex refresh -> armbian.github.io data-update-download-index.yml
- drop stable.json/nightly.json (versioning now driven by GitHub releases)
- remove the Full distro test builds section (no armbian/ci equivalent)
- add a deprecation note for armbian/os

Signed-off-by: Igor Pecovnik <igor@armbian.com>
@github-actions github-actions Bot added size/small PR with less then 50 lines Needs review Seeking for review labels Aug 2, 2026
@coderabbitai

coderabbitai Bot commented Aug 2, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Walkthrough

Updated docs/Process_CI.md for the migration from armbian/os to armbian/ci and armbian.github.io. Updated versioning guidance to use GitHub releases. Added documentation for all-artifact and nightly image workflows. Removed the obsolete full distro test-build section.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Possibly related PRs

Suggested labels: documentation

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly summarizes the documentation update to reference armbian/ci and the deprecated armbian/os repository.
Description check ✅ Passed The description directly explains the repository migration and the corresponding documentation updates.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch process-ci-move-to-ci

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

github-actions Bot pushed a commit that referenced this pull request Aug 2, 2026

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 3

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/Process_CI.md`:
- Line 147: Update the versioning guidance in Process_CI.md to state that stable
builds may omit versionOverride and will reuse the newest X.Y.Z release by
default. Clarify that versionOverride is only needed to seed a repository or
select a different version, while retaining the existing nightly-build behavior.
- Around line 265-266: Update the documentation links in the nightly image
description to reference targets-release-nightly.yaml under the data branch’s
data/release-targets directory, and link the generator workflow to
generate-build-lists.yaml instead of the unavailable generate-targets.yaml URL.
- Line 259: Update the Build All Artifacts documentation in Process_CI.md to
remove the claim that this job must successfully complete before OS image
generation. State that standard-support and application workflows invoke
artifact-build jobs independently, while Build All Artifacts only pre-populates
the cache and does not gate image workflow execution.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: cb11e9da-87ac-426e-8827-d5f4921f3652

📥 Commits

Reviewing files that changed from the base of the PR and between d07f106 and 549e9c0.

📒 Files selected for processing (1)
  • docs/Process_CI.md

Comment thread docs/Process_CI.md

- https://github.com/armbian/os/blob/main/stable.json
- https://github.com/armbian/os/blob/main/nightly.json
Versioning is driven by the GitHub releases on the target repository — there is no version file to edit. Stable builds require an explicit `versionOverride` (e.g. `26.8.0`); nightly builds pick the newest `<base>-trunk.N` release and bump `N`.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎯 Functional Correctness | 🟠 Major | ⚡ Quick win

Do not require versionOverride for every stable build.

Stable workflows default versionOverride to empty. The reusable workflow reuses the newest X.Y.Z release when no override is supplied. An override is required only to seed a repository or select a different version. (raw.githubusercontent.com)

Proposed wording
-Versioning is driven by the GitHub releases on the target repository — there is no version file to edit. Stable builds require an explicit `versionOverride` (e.g. `26.8.0`); nightly builds pick the newest `<base>-trunk.N` release and bump `N`.
+Versioning is driven by the GitHub releases on the target repository — there is no version file to edit. Stable builds reuse the newest `X.Y.Z` release unless `versionOverride` is set; use the override to seed a release or select a different version. Nightly builds pick the newest `<base>-trunk.N` release and bump `N`.
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
Versioning is driven by the GitHub releases on the target repository — there is no version file to edit. Stable builds require an explicit `versionOverride` (e.g. `26.8.0`); nightly builds pick the newest `<base>-trunk.N` release and bump `N`.
Versioning is driven by the GitHub releases on the target repository — there is no version file to edit. Stable builds reuse the newest `X.Y.Z` release unless `versionOverride` is set; use the override to seed a release or select a different version. Nightly builds pick the newest `<base>-trunk.N` release and bump `N`.
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/Process_CI.md` at line 147, Update the versioning guidance in
Process_CI.md to state that stable builds may omit versionOverride and will
reuse the newest X.Y.Z release by default. Clarify that versionOverride is only
needed to seed a repository or select a different version, while retaining the
existing nightly-build behavior.

Source: MCP tools

Comment thread docs/Process_CI.md
Generates all build artifacts cache for targets defined in [targets-all-not-eos.yaml](https://github.com/armbian/os/blob/main/userpatches/targets-all-not-eos.yaml). This build job runs **every 8 hours** and can also be run manually when needed.
Generates all build artifacts cache for targets defined in [targets-all-not-eos.yaml](https://github.com/armbian/ci/blob/main/userpatches/targets-all-not-eos.yaml). This build job runs on a schedule and can also be run manually when needed.

This build job **needs to be successfully completed** in order to proceed generating any OS images!

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎯 Functional Correctness | 🟠 Major | ⚡ Quick win

Do not document Build All Artifacts as a prerequisite.

The standard-support and application workflows run the artifact-build jobs in their own invocation. Build All Artifacts pre-populates the cache; it does not gate image workflow execution. (raw.githubusercontent.com)

Proposed wording
-This build job **needs to be successfully completed** in order to proceed generating any OS images!
+This build job pre-populates the artifact cache used by image builds. Image workflows also build their required artifacts in the same workflow run.
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
This build job **needs to be successfully completed** in order to proceed generating any OS images!
This build job pre-populates the artifact cache used by image builds. Image workflows also build their required artifacts in the same workflow run.
🧰 Tools
🪛 LanguageTool

[style] ~259-~259: Consider a more concise word here.
Context: ... needs to be successfully completed in order to proceed generating any OS images! ## B...

(IN_ORDER_TO_PREMIUM)

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/Process_CI.md` at line 259, Update the Build All Artifacts documentation
in Process_CI.md to remove the claim that this job must successfully complete
before OS image generation. State that standard-support and application
workflows invoke artifact-build jobs independently, while Build All Artifacts
only pre-populates the cache and does not gate image workflow execution.

Source: MCP tools

Comment thread docs/Process_CI.md
Comment on lines 265 to 266
Generates all nightly (Rolling Release) images defined in [targets-release-nightly.yaml](https://github.com/armbian/armbian.github.io/blob/main/release-targets/targets-release-nightly.yaml). This file is automatically generated from `image-info.json` by the [generate-targets workflow](https://github.com/armbian/armbian.github.io/blob/main/.github/workflows/generate-targets.yaml).

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎯 Functional Correctness | 🟠 Major | ⚡ Quick win

Fix the generated-target and generator-workflow references.

The linked generated file is not under main/release-targets; generated output is published under the data branch at data/release-targets. The generator is generate-build-lists.yaml, while the referenced generate-targets.yaml URL is unavailable. ()

Proposed fix
-Generates all nightly (Rolling Release) images defined in [targets-release-nightly.yaml](https://github.com/armbian/armbian.github.io/blob/main/release-targets/targets-release-nightly.yaml). This file is automatically generated from `image-info.json` by the [generate-targets workflow](https://github.com/armbian/armbian.github.io/blob/main/.github/workflows/generate-targets.yaml).
+Generates all nightly (Rolling Release) images defined in [targets-release-nightly.yaml](https://github.com/armbian/armbian.github.io/blob/data/data/release-targets/targets-release-nightly.yaml). This file is automatically generated from `image-info.json` by the [generate-build-lists workflow](https://github.com/armbian/armbian.github.io/blob/main/.github/workflows/generate-build-lists.yaml).
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
Generates all nightly (Rolling Release) images defined in [targets-release-nightly.yaml](https://github.com/armbian/armbian.github.io/blob/main/release-targets/targets-release-nightly.yaml). This file is automatically generated from `image-info.json` by the [generate-targets workflow](https://github.com/armbian/armbian.github.io/blob/main/.github/workflows/generate-targets.yaml).
Generates all nightly (Rolling Release) images defined in [targets-release-nightly.yaml](https://github.com/armbian/armbian.github.io/blob/data/data/release-targets/targets-release-nightly.yaml). This file is automatically generated from `image-info.json` by the [generate-build-lists workflow](https://github.com/armbian/armbian.github.io/blob/main/.github/workflows/generate-build-lists.yaml).
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/Process_CI.md` around lines 265 - 266, Update the documentation links in
the nightly image description to reference targets-release-nightly.yaml under
the data branch’s data/release-targets directory, and link the generator
workflow to generate-build-lists.yaml instead of the unavailable
generate-targets.yaml URL.

Source: MCP tools

@EvilOlaf

EvilOlaf commented Aug 3, 2026

Copy link
Copy Markdown
Member

maybe a good idea to archive armbian/os then and update its readme? not necessarily in this order though 😁

@igorpecovnik

Copy link
Copy Markdown
Member Author

Archive is plan, yes. There is one service left to move out - adding 3rd party packages to repo. Once that is migrated.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Needs review Seeking for review size/small PR with less then 50 lines

Development

Successfully merging this pull request may close these issues.

2 participants