re-generate commons

Author: ilg-ul

.github/workflows/build-darwin-arm64.yml

@@ -69,7 +69,7 @@ jobs:
   darwin-arm64-build:
     name: 'darwin-arm64 riscv-none-elf-gcc ${{github.event.inputs.version}} build'
     timeout-minutes: 2880 # 2 days
-    runs-on: macos-15
+    runs-on: [self-hosted, macos, apple]
     env:
       XBB_ENVIRONMENT_MACOSX_DEPLOYMENT_TARGET: '11.0'
     steps:
@@ -162,6 +162,10 @@ jobs:
           tag: 'test'
           token: ${{secrets.PUBLISH_TOKEN}}
 
+      - name: 'Rename working area'
+        # For just in case absolute paths remain unprocessed.
+        run: mv -v build-assets/build build-assets/build-$(date -u +%Y%m%d-%H%M%S)
+
   darwin-arm64-test:
     name: 'darwin-arm64 riscv-none-elf-gcc ${{github.event.inputs.version}} test'
     # https://github.com/actions/runner-images/blob/main/images/macos/macos-15-Readme.md
@@ -176,6 +180,7 @@ jobs:
           df -gH /
           ls -lA /Library/Developer/CommandLineTools/SDKs || true
           ls -lA /Applications
+          sudo xcode-select --switch /Applications/Xcode_16.4.app
           xcode-select --print-path
           xcodebuild -version || true
           pkgutil --pkg-info=com.apple.pkg.CLTools_Executables || true

.github/workflows/build-darwin-x64.yml

@@ -69,7 +69,7 @@ jobs:
   darwin-x64-build:
     name: 'darwin-x64 riscv-none-elf-gcc ${{github.event.inputs.version}} build'
     timeout-minutes: 2880 # 2 days
-    runs-on: macos-15-intel
+    runs-on: [self-hosted, macos, intel]
     env:
       XBB_ENVIRONMENT_MACOSX_DEPLOYMENT_TARGET: '11.0'
     steps:
@@ -162,6 +162,10 @@ jobs:
           tag: 'test'
           token: ${{secrets.PUBLISH_TOKEN}}
 
+      - name: 'Rename working area'
+        # For just in case absolute paths remain unprocessed.
+        run: mv -v build-assets/build build-assets/build-$(date -u +%Y%m%d-%H%M%S)
+
   darwin-x64-test:
     name: 'darwin-x64 riscv-none-elf-gcc ${{github.event.inputs.version}} test'
     # https://github.com/actions/runner-images/blob/main/images/macos/macos-15-Readme.md
@@ -176,6 +180,7 @@ jobs:
           df -gH /
           ls -lA /Library/Developer/CommandLineTools/SDKs || true
           ls -lA /Applications
+          sudo xcode-select --switch /Applications/Xcode_16.4.app
           xcode-select --print-path
           xcodebuild -version || true
           pkgutil --pkg-info=com.apple.pkg.CLTools_Executables || true

.github/workflows/build-linux-arm64.yml

@@ -69,7 +69,7 @@ jobs:
   linux-arm64-build:
     name: 'linux-arm64 riscv-none-elf-gcc ${{github.event.inputs.version}} build'
     timeout-minutes: 2880 # 2 days
-    runs-on: ubuntu-24.04-arm
+    runs-on: [self-hosted, linux, arm64, xbbla, xbblax]
     defaults:
       run:
         shell: bash
@@ -96,6 +96,11 @@ jobs:
           echo "$(which npm): $(npm --version)"
           echo "$(which xpm): $(xpm --version)"
 
+      - name: 'Clean working area' # Mandatory for self-hosted runners.
+        run: |
+          chmod -Rf a+w * || true
+          rm -rf * .git*
+
       - name: 'Checkout project'
         uses: actions/checkout@v1 # v1 for old Git
         with:
@@ -140,6 +145,10 @@ jobs:
           tag: 'test'
           token: ${{secrets.PUBLISH_TOKEN}}
 
+      - name: 'Rename working area'
+        # For just in case absolute paths remain unprocessed.
+        run: echo mv -v build-assets/build build-assets/build-$(date -u +%Y%m%d-%H%M%S)
+
   linux-arm64-test:
     name: 'linux-arm64 riscv-none-elf-gcc ${{github.event.inputs.version}} test'
     runs-on: ubuntu-24.04-arm

.github/workflows/build-linux-x64.yml

@@ -69,7 +69,7 @@ jobs:
   linux-x64-build:
     name: 'linux-x64 riscv-none-elf-gcc ${{github.event.inputs.version}} build'
     timeout-minutes: 2880 # 2 days
-    runs-on: ubuntu-24.04
+    runs-on: [self-hosted, linux, x64, xbblix]
     defaults:
       run:
         shell: bash
@@ -96,6 +96,11 @@ jobs:
           echo "$(which npm): $(npm --version)"
           echo "$(which xpm): $(xpm --version)"
 
+      - name: 'Clean working area' # Mandatory for self-hosted runners.
+        run: |
+          chmod -Rf a+w * || true
+          rm -rf * .git*
+
       - name: 'Checkout project'
         uses: actions/checkout@v1 # v1 for old Git
         with:
@@ -140,6 +145,10 @@ jobs:
           tag: 'test'
           token: ${{secrets.PUBLISH_TOKEN}}
 
+      - name: 'Rename working area'
+        # For just in case absolute paths remain unprocessed.
+        run: echo mv -v build-assets/build build-assets/build-$(date -u +%Y%m%d-%H%M%S)
+
   linux-x64-test:
     name: 'linux-x64 riscv-none-elf-gcc ${{github.event.inputs.version}} test'
     runs-on: ubuntu-24.04

.github/workflows/build-win32-x64.yml

@@ -69,7 +69,7 @@ jobs:
   win32-x64-build:
     name: 'win32-x64 riscv-none-elf-gcc ${{github.event.inputs.version}} build'
     timeout-minutes: 2880 # 2 days
-    runs-on: ubuntu-24.04
+    runs-on: [self-hosted, linux, x64, xbbliw]
     defaults:
       run:
         shell: bash
@@ -96,6 +96,11 @@ jobs:
           echo "$(which npm): $(npm --version)"
           echo "$(which xpm): $(xpm --version)"
 
+      - name: 'Clean working area' # Mandatory for self-hosted runners.
+        run: |
+          chmod -Rf a+w * || true
+          rm -rf * .git*
+
       - name: 'Checkout project'
         uses: actions/checkout@v1 # v1 for old Git
         with:
@@ -140,6 +145,10 @@ jobs:
           tag: 'test'
           token: ${{secrets.PUBLISH_TOKEN}}
 
+      - name: 'Rename working area'
+        # For just in case absolute paths remain unprocessed.
+        run: echo mv -v build-assets/build build-assets/build-$(date -u +%Y%m%d-%H%M%S)
+
   win32-x64-test:
     name: 'win32-x64 riscv-none-elf-gcc ${{github.event.inputs.version}} test'
     runs-on: windows-2025

.github/workflows/test-prime.yml

@@ -114,6 +114,10 @@ jobs:
 
       - name: 'Remove Homebrew'
         uses: xpack/remove-homebrew-action@v1
+      - name: 'Clean working area' # Mandatory for self-hosted runners.
+        run: |
+          chmod -Rf a+w * || true
+          rm -rf * .git*
 
       # https://github.com/actions/checkout
       - name: 'Checkout project'
@@ -161,6 +165,11 @@ jobs:
       - name: 'Remove Homebrew'
         uses: xpack/remove-homebrew-action@v1
 
+      - name: 'Clean working area' # Mandatory for self-hosted runners.
+        run: |
+          chmod -Rf a+w * || true
+          rm -rf * .git*
+
       # https://github.com/actions/checkout
       - name: 'Checkout project'
         uses: actions/checkout@v5

package.json

@@ -108,7 +108,7 @@
     "upstreamDescriptiveName": "GNU RISC-V Embedded GCC",
     "permalinkName": "riscv-none-elf-gcc",
     "skipCiTests": "true",
-    "useSelfHostedRunners": "false"
+    "useSelfHostedRunners": "true"
   },
   "engines": {
     "node": " >=20.0"

website/docs/maintainer/_common/_content.mdx

@@ -154,6 +154,19 @@ triggered via the VS Code graphical interface, utilising the
 
 <ProjectPatches/>
 
+### Restart the Docker daemons
+
+If, for any reason, the Docker builds need to be cancelled, it is very
+likely that some processes will continue to execute in the background.
+
+To completely terminate them, and ensure that Docker executes
+from a clean slate, restart the Docker daemons on all GNU/Linux
+machines:
+
+```sh
+sudo systemctl restart docker
+```
+
 ### Verify if both projects are pushed
 
 Verify that both the **current project** and the **helper** are
@@ -330,7 +343,71 @@ place them in the XBB cache (`Work/cache`) and restart the build.
 
 ## Execute the production builds
 
-The automation is provided by GitHub Actions on GitHub-hosted runners.
+The automation is provided by GitHub Actions and three self-hosted runners
+(the GitHub hosted runners do not have the necessary resources).
+
+### Start the self-hosted runners
+
+If the runners have expired (more than 2 weeks since last use), execute the
+`github-runner-configure.sh` script to reconfigure them. This script
+is available in the `xbb-helper` and
+requires `GITHUB_API_XPACK_DEV_TOOLS_RUNNERS_TOKEN` to be present.
+
+- On the development machine (`wksi`) open
+SSH sessions to the build machines (`xbbli`, `xbbmi`, `xbbma`, `ampere`):
+
+```sh
+caffeinate ssh xbbli
+caffeinate ssh xbbmi
+caffeinate ssh xbbma
+caffeinate ssh ampere
+```
+
+Create a `screen` session, to provide a persistent standard output for
+the runners:
+
+```sh
+screen -S ga
+```
+
+To exit it, use `# Ctrl-a Ctrl-d`.
+
+For `xbbli` & `ampere`, which have additional memory, start two runners:
+
+```sh
+~/actions-runners/xpack-dev-tools/1/run.sh &
+~/actions-runners/xpack-dev-tools/2/run.sh &
+```
+
+For the macOS x64 runners, ensure the deployment target is defined:
+
+```sh
+unset WORK_FOLDER_PATH
+export XBB_ENVIRONMENT_MACOSX_DEPLOYMENT_TARGET="11.0"
+~/actions-runners/xpack-dev-tools/run.sh &
+```
+
+On all other machines, start the runner with:
+
+```sh
+~/actions-runners/xpack-dev-tools/run.sh &
+```
+
+To check the status of the runners locally:
+
+```sh
+ps -a | grep 'Runner.Listener'
+```
+
+To terminate them:
+
+```sh
+killall Runner.Listener
+```
+
+### Check the status of the runners
+
+The status of all self-hosted runners is available at the [GitHub Runners](https://github.com/organizations/xpack-dev-tools/settings/actions/runners) page.
 
 ### Publish the helper
 
@@ -343,6 +420,49 @@ to `"@xpack-dev-tools/xbb-helper":`.
 
 <CommonGenerateTopCommons />
 
+### Check for disk space
+
+Verify that the build machines have sufficient free space and perform
+cleanup operations as necessary:
+
+```sh
+xpm run check-space -C ~/Work/xpack-dev-tools/riscv-none-elf-gcc-xpack.git/build-assets
+```
+
+This is equivalent to executing a `df` command.
+
+<Tabs groupId="operating-systems">
+
+<TabItem value="macos" label="macOS">
+
+```
+df -gH /
+```
+
+</TabItem>
+
+<TabItem value="linux" label="GNU/Linux">
+
+```sh
+df -BG -H /
+```
+
+</TabItem>
+
+</Tabs>
+
+To free the space utilised by all previous builds of all `xpack-dev-tools` packages:
+
+```sh
+xpm run clear-all-projects-builds -C ~/Work/xpack-dev-tools/riscv-none-elf-gcc-xpack.git/build-assets
+```
+
+This is equivalent to executing a comprehensive `rm` to remove the `build` folders:
+
+```sh
+rm -rf ~/Work/xpack-dev-tools/*/build-assets/build
+```
+
 ### Commit and push
 
 - **Push** the `xpack-development` branch to GitHub
@@ -439,11 +559,6 @@ xpm run install -C ~/Work/xpack-dev-tools/riscv-none-elf-gcc-xpack.git/build-ass
 xpm run test-pre-release -C ~/Work/xpack-dev-tools/riscv-none-elf-gcc-xpack.git/build-assets
 ```
 
-:::caution
-Since the builds were performed on the latest GitHub macOS runners,
-it is strongly recommended to also execute the tests on an older macOS 11 machine.
-:::
-
 For additional tests, on each platform,
 download the archive from
 [pre-releases/test](https://github.com/xpack-dev-tools/pre-releases/releases/tag/test/)
@@ -566,6 +681,19 @@ The test results are available from the
 - Navigate to https://github.com/xpack-dev-tools/pre-releases/releases/tag/test/
 - Remove the test binaries
 
+### Clean the work area
+
+Execute the **trigger-workflow-deep-clean** xpm action:
+
+```sh
+xpm run trigger-workflow-deep-clean -C ~/Work/xpack-dev-tools/riscv-none-elf-gcc-xpack.git/build-assets
+```
+
+This will remove the build folders on all self-hosted runners.
+
+The results are available from the
+[GitHub Actions](https://github.com/xpack-dev-tools/riscv-none-elf-gcc-xpack/actions) page.
+
 <CommonCloseOpenIssues />
 
 <CommonShareOnTwitter />