Skip to content

Commit d5b9eec

Browse files
[DOCS] Add note on building EMT images with older tags
1 parent 7fcf4e9 commit d5b9eec

File tree

2 files changed

+32
-0
lines changed

2 files changed

+32
-0
lines changed

docs/developer-guide/get-started/emt-build-and-deploy.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -90,6 +90,22 @@ skip to [Create a bootable USB installer](#2-create-a-bootable-usb-installer).
9090
sudo make image -j8 REBUILD_TOOLS=y REBUILD_PACKAGES=n CONFIG_FILE=./imageconfigs/edge-image.json
9191
```
9292

93+
**IMPORTANT**:
94+
95+
If you want to create an image with an older tag, for example
96+
[3.0.20250806](https://github.com/open-edge-platform/edge-microvisor-toolkit/releases/tag/3.0.20250806),
97+
make sure to build it **without** the `REBUILD_PACKAGES=n` option.
98+
Otherwise, the build process will download the latest available RPMs,
99+
which do not match those included in the older tag, causing failure in the
100+
installation of the image.
101+
102+
```bash
103+
sudo make -j8 REBUILD_TOOLS=y CONFIG_FILE=./imageconfigs/edge-image.json
104+
```
105+
106+
Keep in mind, that it will perform a full rebuild based on the tag and take
107+
very long time.
108+
93109
The built image will be located in its separate directory under `edge-microvisor-toolkit/out/images/`.
94110

95111
For more information about specific building parameters, refer to [this article](https://github.com/open-edge-platform/edge-microvisor-toolkit/blob/3.0/toolkit/docs/building/building.md#local-build-variables).

docs/developer-guide/get-started/emt-building-howto.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -94,6 +94,22 @@ To build a RAW image with real-time extensions, use the following command:
9494
sudo make image -j8 REBUILD_TOOLS=y REBUILD_PACKAGES=n CONFIG_FILE=./imageconfigs/edge-image-rt.json
9595
```
9696

97+
> **IMPORTANT**:
98+
>
99+
> If you want to create an image with an older tag, for example
100+
> [3.0.20250806](https://github.com/open-edge-platform/edge-microvisor-toolkit/releases/tag/3.0.20250806),
101+
> make sure to build it **without** the `REBUILD_PACKAGES=n` option.
102+
> Otherwise, the build process will download the latest available RPMs,
103+
> which do not match those included in the older tag, causing failure in the
104+
> installation of an image.
105+
>
106+
> ```bash
107+
> sudo make iso -j8 REBUILD_TOOLS=y CONFIG_FILE=./imageconfigs/full.json
108+
> ```
109+
>
110+
> Keep in mind, that it will perform a full rebuild based on the tag and take
111+
> very long time.
112+
97113
## Customize Your Edge Microvisor Toolkit Image
98114
99115
To add packages to the default image, you can define your own `packagelist.json` file, pointing to RPMs that should be included in the image.

0 commit comments

Comments
 (0)