Skip to content

Commit fb4e80d

Browse files
committed
website: re-generate commons
1 parent 4c5a48d commit fb4e80d

File tree

9 files changed

+123
-43
lines changed

9 files changed

+123
-43
lines changed

website/blog/2025-02-13-xbb.mdx

Lines changed: 59 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,59 @@
1+
---
2+
3+
# DO NOT EDIT!
4+
# Automatically generated from docusaurus-template-liquid/templates/docusaurus.
5+
6+
title: The project was upgraded to use XBB v6.0.0
7+
seo_title: Upgrade to XBB v6.0.0
8+
description: The project was upgraded to use XBB v6.0.0 based on Debian 10 and macOS 11.0.
9+
keywords:
10+
- xpack
11+
- qemu-riscv
12+
- website
13+
14+
date: 2025-02-13 13:21:00 +0300
15+
16+
authors: ilg-ul
17+
18+
tags:
19+
- xbb
20+
21+
---
22+
23+
import {PageMetadata} from '@docusaurus/theme-common';
24+
25+
The project configuration was upgraded to use **XBB v6.0.0** based
26+
on **Debian 10** and **macOS 11**
27+
and **support for Arm 32-bit was discontinued**.
28+
29+
Therefore, all future builds will use XBB v6.0.0 or later.
30+
31+
<!--truncate-->
32+
33+
<PageMetadata title={frontMatter.seo_title} />
34+
35+
## GLIBC 2.28
36+
37+
The GNU/Linux base was raised to GLIBC 2.28, with builds performed on **Debian 10**.
38+
The resulting binaries should run on Ubuntu 20 or later, RedHat 8 or later,
39+
Fedora 29 or later, etc.
40+
41+
## MacOS 11.0
42+
43+
The macOS base was raised to 11.0, with builds performed on** macOS 11.7** with
44+
`MACOSX_DEPLOYMENT_TARGET="11.0"`. The resulting binaries, both x64 and arm64,
45+
should run on any macOS 11 or later.
46+
47+
## Support for Arm 32-bit discontinued
48+
49+
With regret for the inconvenience caused to some Raspberry Pi users,
50+
due to the extremely high burdon on maintenance (toolchain builds took
51+
more than half a day), support for Arm 32-bit GNU/Linux had to be discontinued.
52+
53+
This allowed all arm64 GNU/Linux builds to be performed on the Oracle Ampere
54+
machine, which is many times faster than the Raspberry Pi 4 machines.
55+
56+
## Website updates
57+
58+
The website was also updated to reflect the new changes, and references to
59+
**arm GNU/Linux**, **linux-arm** and **xbbla32** were removed.
Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
2+
{/* DO NOT EDIT! */}
3+
{/* Automatically generated from docusaurus-template-liquid/templates/docusaurus. */}
4+
5+
{/* ------------------------------------------------------------------------ */}
6+
7+
## Deprecation notices
8+
9+
### GNU/Linux minimum requirements
10+
11+
The minimum requirement is **GLIBC 2.28**, available starting
12+
with Ubuntu 20, Debian 10 and RedHat 8.
13+
Support for RedHat 7 was dropped in 2022.
14+
Support for Ubuntu 18 was dropped in 2025.
15+
16+
### 32-bit support
17+
18+
Support for 32-bit x86 GNU/Linux and x86 Windows was
19+
dropped in 2022 and for 32-bit Arm GNU/Linux in 2025.
Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
{/* DO NOT EDIT! */}
2+
{/* Automatically generated from docusaurus-template-liquid/templates/docusaurus. */}
3+
4+
{/* ------------------------------------------------------------------------ */}
5+
6+
## Prerequisites
7+
8+
- x64 Windows: Windows 7 with the Universal C Runtime
9+
([UCRT](https://support.microsoft.com/en-us/topic/update-for-universal-c-runtime-in-windows-c0514201-7fe6-95a3-b0a5-287930f3560c)),
10+
Windows 8, Windows 10, Windows 11
11+
- x64 macOS: 11.0 or later
12+
- arm64 macOS: 11.0 or later
13+
- x64 GNU/Linux: any system with **GLIBC 2.28** or higher
14+
(like Ubuntu 20 or later, Debian 10 or later, RedHat 8 or later,
15+
Fedora 29 or later, etc)
16+
- arm64 GNU/Linux: any system with **GLIBC 2.28** or higher
17+
(like Raspberry Pi OS, Ubuntu 20 or later, Debian 10 or later,
18+
RedHat 8 or later, Fedora 29 or later, etc)

website/blog/tags.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,3 +4,5 @@
44
releases:
55

66
web:
7+
8+
xbb:

website/docs/developer/_common/_content.mdx

Lines changed: 0 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -62,7 +62,6 @@ for each platform:
6262
- `darwin-arm64`
6363
- `linux-x64`
6464
- `linux-arm64`
65-
- `linux-arm`
6665

6766
:::note
6867

@@ -305,10 +304,6 @@ git -C ~/Work/xpack-dev-tools/xbb-helper-xpack.git pull
305304
<PlatformDockerSection platform="linux-arm64"/>
306305
</TabItem>
307306

308-
<TabItem value="linux-arm" label="GNU/Linux arm" default>
309-
<PlatformDockerSection platform="linux-arm"/>
310-
</TabItem>
311-
312307
</Tabs>
313308

314309
### Compile with debug info

website/docs/getting-started/_common/_benefits.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ The main advantages of using the **xPack QEMU RISC-V** are:
99

1010
- A convenient, uniform and portable install/uninstall/upgrade
1111
procedure; the same procedure is used for all major
12-
platforms (**x64 Windows**, **x64 macOS**, **arm64 macOS**, **x64 GNU/Linux**, **arm64 GNU/Linux**, **arm GNU/Linux**).
12+
platforms (**x64 Windows**, **x64 macOS**, **arm64 macOS**, **x64 GNU/Linux**, **arm64 GNU/Linux**).
1313
- Multiple versions of the same package can be installed at the same time on
1414
the same system.
1515
- No need to worry about dependent libraries, they are all included.

website/docs/install/_common/_content.mdx

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -596,7 +596,6 @@ Download the latest version named like:
596596
<ul>
597597
<li><code>xpack-qemu-riscv-8.2.6-1-linux-x64.tar.gz</code></li>
598598
<li><code>xpack-qemu-riscv-8.2.6-1-linux-arm64.tar.gz</code></li>
599-
<li><code>xpack-qemu-riscv-8.2.6-1-linux-arm.tar.gz</code></li>
600599
</ul>
601600

602601
:::note

website/docs/maintainer/_common/_content.mdx

Lines changed: 20 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -179,7 +179,7 @@ or run the following in a terminal:
179179
```
180180

181181
Navigate to the **Maintainer Info** page,
182-
the **[Update the version specific code](http://localhost:3000/openocd-xpack/docs/maintainer/#update-the-version-specific-code)** section.
182+
the **[Update the version specific code](http://localhost:3000/qemu-riscv-xpack/docs/maintainer/#update-the-version-specific-code)** section.
183183

184184
<UpdateVersionSpecific/>
185185

@@ -238,7 +238,7 @@ will build again the previous release!
238238

239239
## Run the development builds
240240

241-
The builds currently run on 5 dedicated machines (x64 GNU/Linux, x64 macOS, arm64 macOS, arm64 GNU/Linux, arm GNU/Linux).
241+
The builds currently run on 4 dedicated machines (x64 GNU/Linux, x64 macOS, arm64 macOS, arm64 GNU/Linux).
242242

243243
Before the real build, run test/development builds on all platforms.
244244

@@ -273,7 +273,7 @@ commits are pushed to GitHub.
273273

274274
:::caution
275275

276-
This is particularly crucial for extensive projects; otherwise,
276+
This is particularly crucial for large projects; otherwise,
277277
the build may proceed with the previous version.
278278

279279
:::
@@ -359,26 +359,15 @@ caffeinate ssh xbbli
359359

360360
### Build the arm64 GNU/Linux binaries
361361

362-
Run the docker build on the production machine (`xbbla`);
362+
Run the docker build on the production machine (`ampere`);
363363
start a VS Code remote session, or connect with a terminal:
364364

365365
```sh
366-
caffeinate ssh xbbla
366+
caffeinate ssh ampere
367367
```
368368

369369
<PlatformDockerBuild platform="linux-arm64"/>
370370

371-
### Build the arm GNU/Linux (32-bit) binaries
372-
373-
Run the docker build on the production machine (`xbbla32`);
374-
start a VS Code remote session, or connect with a terminal:
375-
376-
```sh
377-
caffeinate ssh xbbla32
378-
```
379-
380-
<PlatformDockerBuild platform="linux-arm"/>
381-
382371
### Update the durations of the development builds
383372

384373
In `website/docs/_shared/_development-durations.mdx`, update
@@ -456,14 +445,13 @@ is available in the `xbb-helper` and
456445
requires `GITHUB_API_XPACK_DEV_TOOLS_RUNNERS_TOKEN` to be present.
457446

458447
- on the development machine (`wksi`) open
459-
ssh sessions to the build machines (`xbbli`, `xbbmi`, `xbbma`, `xbbla`, `xbbla32`):
448+
ssh sessions to the build machines (`xbbli`, `xbbmi`, `xbbma`, `ampere`):
460449

461450
```sh
462451
caffeinate ssh xbbli
463452
caffeinate ssh xbbmi
464453
caffeinate ssh xbbma
465-
caffeinate ssh xbbla
466-
caffeinate ssh xbbla32
454+
caffeinate ssh ampere
467455
```
468456

469457
Create a `screen` session, to provide a persistent standard output for
@@ -475,7 +463,7 @@ screen -S ga
475463

476464
To quit it, use `# Ctrl-a Ctrl-d`.
477465

478-
For `xbbli` & `xbbla`, which have more memory, start two runners:
466+
For `xbbli` & `ampere`, which have more memory, start two runners:
479467

480468
```sh
481469
~/actions-runners/xpack-dev-tools/1/run.sh &
@@ -486,7 +474,7 @@ For the macOS x64 runners, be sure the deployment target is defined:
486474

487475
```sh
488476
unset WORK_FOLDER_PATH
489-
export XBB_ENVIRONMENT_MACOSX_DEPLOYMENT_TARGET="10.13"
477+
export XBB_ENVIRONMENT_MACOSX_DEPLOYMENT_TARGET="11.0"
490478
~/actions-runners/xpack-dev-tools/run.sh &
491479
```
492480

@@ -576,6 +564,13 @@ rm -rf ~/Work/xpack-dev-tools/*/build-assets/build
576564

577565
- **push** the `xpack-development` branch to GitHub
578566

567+
:::caution
568+
569+
This is particularly crucial for large projects; otherwise,
570+
the build may proceed with the previous version.
571+
572+
:::
573+
579574
### Check if the helper is pushed and published
580575

581576
The helper `xpack` branch must be updated and the npm package published.
@@ -591,7 +586,6 @@ To trigger the GitHub Actions builds, use the xpm actions:
591586
- **trigger-workflow-build-linux-x64**
592587
- **trigger-workflow-build-win32-x64**
593588
- **trigger-workflow-build-linux-arm64**
594-
- **trigger-workflow-build-linux-arm**
595589

596590

597591
```sh
@@ -600,7 +594,6 @@ xpm run trigger-workflow-build-darwin-arm64 -C ~/Work/xpack-dev-tools/qemu-riscv
600594
xpm run trigger-workflow-build-linux-x64 -C ~/Work/xpack-dev-tools/qemu-riscv-xpack.git/build-assets
601595
xpm run trigger-workflow-build-win32-x64 -C ~/Work/xpack-dev-tools/qemu-riscv-xpack.git/build-assets
602596
xpm run trigger-workflow-build-linux-arm64 -C ~/Work/xpack-dev-tools/qemu-riscv-xpack.git/build-assets
603-
xpm run trigger-workflow-build-linux-arm -C ~/Work/xpack-dev-tools/qemu-riscv-xpack.git/build-assets
604597
```
605598

606599
The scripts behind these actions require the `GITHUB_API_DISPATCH_TOKEN`
@@ -654,13 +647,6 @@ These actions use the `xpack-development` branch of this repo and the
654647
[pre-releases/test](https://github.com/xpack-dev-tools/pre-releases/releases/tag/test/)
655648
binaries.
656649

657-
:::caution
658-
659-
Some of the `docker-linux-arm` tests have an issue on Debian and the
660-
**Clean working area** step fails.
661-
662-
:::
663-
664650
The tests results are available from the
665651
[GitHub Actions](https://github.com/xpack-dev-tools/qemu-riscv-xpack/actions) page.
666652

@@ -733,10 +719,6 @@ with all binaries attached.
733719

734720
- edit the draft and be sure it is attached to the `xpack-development` branch (important!)
735721
- perform the final edits (maintenance vs. new release) and check if everything is fine
736-
- add entries in the **Bug fixes**; use the following syntax
737-
```
738-
- [[#N](https://github.com/xpack-dev-tools/qemu-riscv-xpack/issues/N)]:
739-
```
740722
- **keep the pre-release button enabled**
741723
- do **not** enable Discussions yet
742724
- click the **Publish release** button
@@ -758,6 +740,10 @@ this will add a file in the `website/blog` folder:
758740
```
759741
- edit the `description` property in the post front matter
760742
- select the correct summary (maintenance vs. new release)
743+
- add entries in the **Bug fixes**; use the following syntax
744+
```
745+
- [[#N](https://github.com/xpack-dev-tools/qemu-riscv-xpack/issues/N)]:
746+
```
761747
- copy/paste the folders hierarchies from the install guide
762748
- **commit** with the message _**website: blog post release 8.2.6-1 published**_
763749

website/docs/maintainer/_common/_platform-native-build.mdx

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,8 @@ xpm run clear-all-projects-builds -C ~/Work/xpack-dev-tools/qemu-riscv-xpack.git
2222
To update the build scripts and build the development binaries:
2323

2424
<CodeBlock language="sh"> {
25-
`rm -f ~/Work/xpack-dev-tools/qemu-riscv-xpack.git/build-assets/package-lock.json && \\
25+
`export XBB_ENVIRONMENT_MACOSX_DEPLOYMENT_TARGET='11.0' && \\
26+
rm -f ~/Work/xpack-dev-tools/qemu-riscv-xpack.git/build-assets/package-lock.json && \\
2627
git -C ~/Work/xpack-dev-tools/qemu-riscv-xpack.git pull && \\
2728
xpm run install -C ~/Work/xpack-dev-tools/qemu-riscv-xpack.git/build-assets && \\
2829
git -C ~/Work/xpack-dev-tools/xbb-helper-xpack.git pull && \\
@@ -44,7 +45,8 @@ the <code>build-assets/build/{props.platform}/deploy</code> folder:
4445
To update the build scripts and build the release binaries:
4546

4647
<CodeBlock language="sh"> {
47-
`rm -f ~/Work/xpack-dev-tools/qemu-riscv-xpack.git/package-lock.json && \\
48+
`export XBB_ENVIRONMENT_MACOSX_DEPLOYMENT_TARGET='11.0' && \\
49+
rm -f ~/Work/xpack-dev-tools/qemu-riscv-xpack.git/package-lock.json && \\
4850
git -C ~/Work/xpack-dev-tools/qemu-riscv-xpack.git pull && \\
4951
xpm run install -C ~/Work/xpack-dev-tools/qemu-riscv-xpack.git/build-assets && \\
5052
\\

0 commit comments

Comments
 (0)