Skip to content

Commit d2bc652

Browse files
committed
website: re-generate commons
1 parent fe1cf3c commit d2bc652

File tree

9 files changed

+120
-43
lines changed

9 files changed

+120
-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+
- realpath
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: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
{/* DO NOT EDIT! */}
2+
{/* Automatically generated from docusaurus-template-liquid/templates/docusaurus. */}
3+
4+
{/* ------------------------------------------------------------------------ */}
5+
6+
## Prerequisites
7+
8+
- x64 macOS: 11.0 or later
9+
- arm64 macOS: 11.0 or later
10+
- x64 GNU/Linux: any system with **GLIBC 2.28** or higher
11+
(like Ubuntu 20 or later, Debian 10 or later, RedHat 8 or later,
12+
Fedora 29 or later, etc)
13+
- arm64 GNU/Linux: any system with **GLIBC 2.28** or higher
14+
(like Raspberry Pi OS, Ubuntu 20 or later, Debian 10 or later,
15+
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
@@ -61,7 +61,6 @@ for each platform:
6161
- `darwin-arm64`
6262
- `linux-x64`
6363
- `linux-arm64`
64-
- `linux-arm`
6564

6665
:::note
6766

@@ -300,10 +299,6 @@ git -C ~/Work/xpack-dev-tools/xbb-helper-xpack.git pull
300299
<PlatformDockerSection platform="linux-arm64"/>
301300
</TabItem>
302301

303-
<TabItem value="linux-arm" label="GNU/Linux arm" default>
304-
<PlatformDockerSection platform="linux-arm"/>
305-
</TabItem>
306-
307302
</Tabs>
308303

309304
### 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 GNU realpath** are:
99

1010
- A convenient, uniform and portable install/uninstall/upgrade
1111
procedure; the same procedure is used for all major
12-
platforms (**x64 macOS**, **arm64 macOS**, **x64 GNU/Linux**, **arm64 GNU/Linux**, **arm GNU/Linux**).
12+
platforms (**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
@@ -509,7 +509,6 @@ Download the latest version named like:
509509
<ul>
510510
<li><code>xpack-realpath-9.5.0-1-linux-x64.tar.gz</code></li>
511511
<li><code>xpack-realpath-9.5.0-1-linux-arm64.tar.gz</code></li>
512-
<li><code>xpack-realpath-9.5.0-1-linux-arm.tar.gz</code></li>
513512
</ul>
514513

515514
:::note

website/docs/maintainer/_common/_content.mdx

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

180180
Navigate to the **Maintainer Info** page,
181-
the **[Update the version specific code](http://localhost:3000/openocd-xpack/docs/maintainer/#update-the-version-specific-code)** section.
181+
the **[Update the version specific code](http://localhost:3000/realpath-xpack/docs/maintainer/#update-the-version-specific-code)** section.
182182

183183
<UpdateVersionSpecific/>
184184

@@ -237,7 +237,7 @@ will build again the previous release!
237237

238238
## Run the development builds
239239

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

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

@@ -272,7 +272,7 @@ commits are pushed to GitHub.
272272

273273
:::caution
274274

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

278278
:::
@@ -347,26 +347,15 @@ caffeinate ssh xbbli
347347

348348
### Build the arm64 GNU/Linux binaries
349349

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

353353
```sh
354-
caffeinate ssh xbbla
354+
caffeinate ssh ampere
355355
```
356356

357357
<PlatformDockerBuild platform="linux-arm64"/>
358358

359-
### Build the arm GNU/Linux (32-bit) binaries
360-
361-
Run the docker build on the production machine (`xbbla32`);
362-
start a VS Code remote session, or connect with a terminal:
363-
364-
```sh
365-
caffeinate ssh xbbla32
366-
```
367-
368-
<PlatformDockerBuild platform="linux-arm"/>
369-
370359
### Update the durations of the development builds
371360

372361
In `website/docs/_shared/_development-durations.mdx`, update
@@ -444,14 +433,13 @@ is available in the `xbb-helper` and
444433
requires `GITHUB_API_XPACK_DEV_TOOLS_RUNNERS_TOKEN` to be present.
445434

446435
- on the development machine (`wksi`) open
447-
ssh sessions to the build machines (`xbbmi`, `xbbma`, `xbbli`, `xbbla`, `xbbla32`):
436+
ssh sessions to the build machines (`xbbmi`, `xbbma`, `xbbli`, `ampere`):
448437

449438
```sh
450439
caffeinate ssh xbbmi
451440
caffeinate ssh xbbma
452441
caffeinate ssh xbbli
453-
caffeinate ssh xbbla
454-
caffeinate ssh xbbla32
442+
caffeinate ssh ampere
455443
```
456444

457445
Create a `screen` session, to provide a persistent standard output for
@@ -463,7 +451,7 @@ screen -S ga
463451

464452
To quit it, use `# Ctrl-a Ctrl-d`.
465453

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

468456
```sh
469457
~/actions-runners/xpack-dev-tools/1/run.sh &
@@ -474,7 +462,7 @@ For the macOS x64 runners, be sure the deployment target is defined:
474462

475463
```sh
476464
unset WORK_FOLDER_PATH
477-
export XBB_ENVIRONMENT_MACOSX_DEPLOYMENT_TARGET="10.13"
465+
export XBB_ENVIRONMENT_MACOSX_DEPLOYMENT_TARGET="11.0"
478466
~/actions-runners/xpack-dev-tools/run.sh &
479467
```
480468

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

565553
- **push** the `xpack-development` branch to GitHub
566554

555+
:::caution
556+
557+
This is particularly crucial for large projects; otherwise,
558+
the build may proceed with the previous version.
559+
560+
:::
561+
567562
### Check if the helper is pushed and published
568563

569564
The helper `xpack` branch must be updated and the npm package published.
@@ -578,15 +573,13 @@ To trigger the GitHub Actions builds, use the xpm actions:
578573
- **trigger-workflow-build-darwin-arm64**
579574
- **trigger-workflow-build-linux-x64**
580575
- **trigger-workflow-build-linux-arm64**
581-
- **trigger-workflow-build-linux-arm**
582576

583577

584578
```sh
585579
xpm run trigger-workflow-build-darwin-x64 -C ~/Work/xpack-dev-tools/realpath-xpack.git/build-assets
586580
xpm run trigger-workflow-build-darwin-arm64 -C ~/Work/xpack-dev-tools/realpath-xpack.git/build-assets
587581
xpm run trigger-workflow-build-linux-x64 -C ~/Work/xpack-dev-tools/realpath-xpack.git/build-assets
588582
xpm run trigger-workflow-build-linux-arm64 -C ~/Work/xpack-dev-tools/realpath-xpack.git/build-assets
589-
xpm run trigger-workflow-build-linux-arm -C ~/Work/xpack-dev-tools/realpath-xpack.git/build-assets
590583
```
591584

592585
The scripts behind these actions require the `GITHUB_API_DISPATCH_TOKEN`
@@ -640,13 +633,6 @@ These actions use the `xpack-development` branch of this repo and the
640633
[pre-releases/test](https://github.com/xpack-dev-tools/pre-releases/releases/tag/test/)
641634
binaries.
642635

643-
:::caution
644-
645-
Some of the `docker-linux-arm` tests have an issue on Debian and the
646-
**Clean working area** step fails.
647-
648-
:::
649-
650636
The tests results are available from the
651637
[GitHub Actions](https://github.com/xpack-dev-tools/realpath-xpack/actions) page.
652638

@@ -719,10 +705,6 @@ with all binaries attached.
719705

720706
- edit the draft and be sure it is attached to the `xpack-development` branch (important!)
721707
- perform the final edits (maintenance vs. new release) and check if everything is fine
722-
- add entries in the **Bug fixes**; use the following syntax
723-
```
724-
- [[#N](https://github.com/xpack-dev-tools/realpath-xpack/issues/N)]:
725-
```
726708
- **keep the pre-release button enabled**
727709
- do **not** enable Discussions yet
728710
- click the **Publish release** button
@@ -744,6 +726,10 @@ this will add a file in the `website/blog` folder:
744726
```
745727
- edit the `description` property in the post front matter
746728
- select the correct summary (maintenance vs. new release)
729+
- add entries in the **Bug fixes**; use the following syntax
730+
```
731+
- [[#N](https://github.com/xpack-dev-tools/realpath-xpack/issues/N)]:
732+
```
747733
- copy/paste the folders hierarchies from the install guide
748734
- **commit** with the message _**website: blog post release 9.5.0-1 published**_
749735

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/realpath-xpack.git/b
2222
To update the build scripts and build the development binaries:
2323

2424
<CodeBlock language="sh"> {
25-
`rm -f ~/Work/xpack-dev-tools/realpath-xpack.git/build-assets/package-lock.json && \\
25+
`export XBB_ENVIRONMENT_MACOSX_DEPLOYMENT_TARGET='11.0' && \\
26+
rm -f ~/Work/xpack-dev-tools/realpath-xpack.git/build-assets/package-lock.json && \\
2627
git -C ~/Work/xpack-dev-tools/realpath-xpack.git pull && \\
2728
xpm run install -C ~/Work/xpack-dev-tools/realpath-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/realpath-xpack.git/package-lock.json && \\
48+
`export XBB_ENVIRONMENT_MACOSX_DEPLOYMENT_TARGET='11.0' && \\
49+
rm -f ~/Work/xpack-dev-tools/realpath-xpack.git/package-lock.json && \\
4850
git -C ~/Work/xpack-dev-tools/realpath-xpack.git pull && \\
4951
xpm run install -C ~/Work/xpack-dev-tools/realpath-xpack.git/build-assets && \\
5052
\\

0 commit comments

Comments
 (0)