diff --git a/docs/User-Guide_Armbian-Software/Armbian.md b/docs/User-Guide_Armbian-Software/Armbian.md new file mode 100644 index 00000000..7dad6f65 --- /dev/null +++ b/docs/User-Guide_Armbian-Software/Armbian.md @@ -0,0 +1,124 @@ +--- +comments: true +--- + +# Armbian infrastructure services + +## CDN router + + +Router for repository mirror automation + + + +[![CDN router](/images/ART001.png)](#) + + + + +The Armbian Router is an intelligent redirector system that optimizes file downloads by automatically directing users to the best available mirror. It evaluates each download request based on geographic location, server health, and file availability, ensuring faster downloads, balanced load distribution, and high availability. This core service underpins Armbian's scalable mirror network, seamlessly routing traffic to improve performance and reliability for end users worldwide. + + + +**Author:** @efectn + +**Status:** Stable + + +~~~ custombash +armbian-config --cmd ART001 +~~~ + + +~~~ bash title="Remove CDN router:" +armbian-config --cmd ART002 +~~~ + + + +## GH runners + + +GitHub runners for Armbian automation + + + +[![GH runners](/images/GHR001.png)](#) + + + + +This module automates the installation, removal, and status checking of GitHub self-hosted runners for the Armbian project. It supports batch operations and user input through dialog prompts when running interactively. + + + +**Author:** @efectn + +**Status:** Stable + + +~~~ custombash +armbian-config --cmd GHR001 +~~~ + + + +=== "Supported Commands" + +- **`install`** + Installs one or more GitHub runners using the provided configuration or interactively prompted values. + +- **`purge` / `remove`** + Removes runners based on the provided runner name series and target organization or repository. + +- **`status`** + Quietly checks if any `actions.runner` services are currently running on the system. + +=== "Available Switches" + +| Switch | Description | +|--------------------|-----------------------------------------------------------------------------| +| `gh_token` | GitHub token with admin rights to manage self-hosted runners. | +| `runner_name` | Name prefix for the runner series (default: `armbian`). | +| `start` | Start index of the runner series (e.g., `01`). | +| `stop` | End index of the runner series (e.g., `05`). | +| `label_primary` | Labels for the first runner (default: `alfa`). | +| `label_secondary` | Labels for additional runners (default: `fast,images`). | +| `organisation` | GitHub organization name (default: `armbian`). | +| `owner` | GitHub user or organization owner (used for repo-level runners). | +| `repository` | GitHub repository name (used for repo-level runners). | + +=== "Behavior" + +- Prompts the user for missing switches via `dialog` **only in interactive mode**. +- Supports bulk installation of runners using sequential numbering (`start` to `stop`). +- Calls internal `actions.runner.install` and `actions.runner.remove` helpers. +- Returns `0` if any runner services are active, `1` otherwise (for scripting use). +- Suppresses errors and outputs when checking status to remain quiet in background use. + + + + +~~~ bash title="Remove GitHub runners for Armbian automation:" +armbian-config --cmd GHR002 +~~~ + + + +## Rsyncd server + +**Author:** @igorpecovnik + +**Status:** Stable + + +~~~ custombash +armbian-config --cmd RSD001 +~~~ + + +~~~ bash title="Remove Armbian rsyncd server:" +armbian-config --cmd RSD002 +~~~ + + diff --git a/docs/User-Guide_Armbian-Software/DevTools.md b/docs/User-Guide_Armbian-Software/DevTools.md index dca45b78..eb395a3c 100644 --- a/docs/User-Guide_Armbian-Software/DevTools.md +++ b/docs/User-Guide_Armbian-Software/DevTools.md @@ -24,42 +24,3 @@ armbian-config --cmd GIT002 ~~~ - -## Armbian CDN router - - -Armbian router for repository mirror automation - -**Author:** @efectn - -**Status:** Stable - - -~~~ custombash -armbian-config --cmd ART001 -~~~ - - -~~~ bash title="Remove Armbian router:" -armbian-config --cmd ART002 -~~~ - - - -## Armbian rsyncd server - -**Author:** @igorpecovnik - -**Status:** Stable - - -~~~ custombash -armbian-config --cmd RSD001 -~~~ - - -~~~ bash title="Remove Armbian rsyncd server:" -armbian-config --cmd RSD002 -~~~ - - diff --git a/docs/User-Guide_Armbian-Software/Software.md b/docs/User-Guide_Armbian-Software/Software.md index 1f5de434..023e9e52 100644 --- a/docs/User-Guide_Armbian-Software/Software.md +++ b/docs/User-Guide_Armbian-Software/Software.md @@ -1614,6 +1614,127 @@ armbian-config --cmd MYA003 +## Armbian infrastructure services + +#### CDN router + + +Router for repository mirror automation + + + +[![CDN router](/images/ART001.png)](#) + + + + +The Armbian Router is an intelligent redirector system that optimizes file downloads by automatically directing users to the best available mirror. It evaluates each download request based on geographic location, server health, and file availability, ensuring faster downloads, balanced load distribution, and high availability. This core service underpins Armbian's scalable mirror network, seamlessly routing traffic to improve performance and reliability for end users worldwide. + + + +**Author:** @efectn + +**Status:** Stable + + +~~~ custombash +armbian-config --cmd ART001 +~~~ + + +~~~ bash title="Remove CDN router:" +armbian-config --cmd ART002 +~~~ + + + +#### GH runners + + +GitHub runners for Armbian automation + + + +[![GH runners](/images/GHR001.png)](#) + + + + +This module automates the installation, removal, and status checking of GitHub self-hosted runners for the Armbian project. It supports batch operations and user input through dialog prompts when running interactively. + + + +**Author:** @efectn + +**Status:** Stable + + +~~~ custombash +armbian-config --cmd GHR001 +~~~ + + + +=== "Supported Commands" + +- **`install`** + Installs one or more GitHub runners using the provided configuration or interactively prompted values. + +- **`purge` / `remove`** + Removes runners based on the provided runner name series and target organization or repository. + +- **`status`** + Quietly checks if any `actions.runner` services are currently running on the system. + +=== "Available Switches" + +| Switch | Description | +|--------------------|-----------------------------------------------------------------------------| +| `gh_token` | GitHub token with admin rights to manage self-hosted runners. | +| `runner_name` | Name prefix for the runner series (default: `armbian`). | +| `start` | Start index of the runner series (e.g., `01`). | +| `stop` | End index of the runner series (e.g., `05`). | +| `label_primary` | Labels for the first runner (default: `alfa`). | +| `label_secondary` | Labels for additional runners (default: `fast,images`). | +| `organisation` | GitHub organization name (default: `armbian`). | +| `owner` | GitHub user or organization owner (used for repo-level runners). | +| `repository` | GitHub repository name (used for repo-level runners). | + +=== "Behavior" + +- Prompts the user for missing switches via `dialog` **only in interactive mode**. +- Supports bulk installation of runners using sequential numbering (`start` to `stop`). +- Calls internal `actions.runner.install` and `actions.runner.remove` helpers. +- Returns `0` if any runner services are active, `1` otherwise (for scripting use). +- Suppresses errors and outputs when checking status to remain quiet in background use. + + + + +~~~ bash title="Remove GitHub runners for Armbian automation:" +armbian-config --cmd GHR002 +~~~ + + + +#### Rsyncd server + +**Author:** @igorpecovnik + +**Status:** Stable + + +~~~ custombash +armbian-config --cmd RSD001 +~~~ + + +~~~ bash title="Remove Armbian rsyncd server:" +armbian-config --cmd RSD002 +~~~ + + + ## Applications and tools for development #### Git CLI @@ -1637,45 +1758,6 @@ armbian-config --cmd GIT002 -#### Armbian CDN router - - -Armbian router for repository mirror automation - -**Author:** @efectn - -**Status:** Stable - - -~~~ custombash -armbian-config --cmd ART001 -~~~ - - -~~~ bash title="Remove Armbian router:" -armbian-config --cmd ART002 -~~~ - - - -#### Armbian rsyncd server - -**Author:** @igorpecovnik - -**Status:** Stable - - -~~~ custombash -armbian-config --cmd RSD001 -~~~ - - -~~~ bash title="Remove Armbian rsyncd server:" -armbian-config --cmd RSD002 -~~~ - - - ## Docker containerization and KVM virtual machines #### Docker diff --git a/docs/images/ART001.png b/docs/images/ART001.png new file mode 100644 index 00000000..d4e966d4 Binary files /dev/null and b/docs/images/ART001.png differ diff --git a/docs/images/GHR001.png b/docs/images/GHR001.png new file mode 100644 index 00000000..10fd031c Binary files /dev/null and b/docs/images/GHR001.png differ