Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
60 commits
Select commit Hold shift + click to select a range
41674cb
Add support for arm64-based AMIs
joshfrench Apr 15, 2026
ed7ff4c
goss var naming
joshfrench Apr 27, 2026
b495b4e
ova: fix Photon 5 distro-sync failure due to alternatives/chkconfig c…
knabben Apr 28, 2026
b2c0637
ova: also swap chkconfig->alternatives in vmware-photon provider role
knabben Apr 28, 2026
9ebf91a
Bump ansible to v2.18.16
mboersma May 5, 2026
598fb62
chore(ci): updating the cloudbuild gcb-docker-gcloud image to the lat…
drew-viles May 6, 2026
3428a09
Merge pull request #1997 from drew-viles/update-gcb-cloudbuild
k8s-ci-robot May 6, 2026
5cc8e31
docs: Update docs for image-builder v0.1.52
drew-viles May 6, 2026
1463886
Merge pull request #1998 from drew-viles/release-v0.1.52
k8s-ci-robot May 6, 2026
0306dd4
Merge pull request #1995 from mboersma/bump-ansible-2.18.16
k8s-ci-robot May 6, 2026
fede562
Merge pull request #1988 from joshfrench/arm64-amis
k8s-ci-robot May 6, 2026
a6e54d6
Fix windows-cvm source SKUs after Marketplace removal
mboersma May 8, 2026
7e4c97c
Remove dead python2 references
mboersma May 8, 2026
2b67324
Remove dead RHEL 7/8 ansible code paths and orphaned nutanix cloud-in…
mboersma May 8, 2026
1ae7ef8
fix(ansible): disable both .list and .sources repos when disable_publ…
Alethuillier May 11, 2026
14be687
Windows: robustify StartKubelet.ps1 kubelet bootstrap
mboersma May 11, 2026
ba4b627
Merge pull request #1989 from knabben/photon-5-add-alternatives
k8s-ci-robot May 11, 2026
22d6dab
Merge pull request #1999 from mboersma/fix-windows-cvm-source-sku
k8s-ci-robot May 11, 2026
567d5b0
Merge pull request #2000 from mboersma/cleanup-dead-python2-refs
k8s-ci-robot May 12, 2026
36d3653
Bump CAPG nightly Kubernetes versions to 1.34.8 and 1.35.5
damdo May 13, 2026
8d400b5
Merge pull request #2010 from damdo/bump-capg-k8s-1.34.8-1.35.5
k8s-ci-robot May 13, 2026
f511ec3
Merge pull request #2009 from mboersma/windows-startkubelet-cleanup
k8s-ci-robot May 13, 2026
1f4c42b
Remove dead RHEL/CentOS 8 entries from goss-vars
mboersma May 8, 2026
3d71228
Add CentOS Stream 10 support for PowerVS image builds
aman4433 May 11, 2026
6b83258
Merge pull request #2006 from aman4433/main
k8s-ci-robot May 14, 2026
7fb4109
feat: adding containerd_enable_limit_no_file as an option to allow us…
drew-viles May 10, 2026
6e39fd5
Merge pull request #2004 from drew-viles/no-limit
k8s-ci-robot May 18, 2026
a06cb71
Merge pull request #2002 from mboersma/cleanup-goss-vars-rhel8
k8s-ci-robot May 18, 2026
d54761d
Merge pull request #2001 from mboersma/cleanup-orphaned-rhel8-photon3…
k8s-ci-robot May 18, 2026
2a1e88d
Merge pull request #2008 from Alethuillier/fix/disable-public-repos-u…
k8s-ci-robot May 19, 2026
ed4f467
⬆️ Bump containerd to v2.3.1 and runc to v1.4.2
Whisper40 May 21, 2026
a7d0577
Retire Azure VHD (unmanaged disk) builder
mboersma May 26, 2026
d8b7bf5
Merge pull request #2017 from Whisper40/bump-containerd-2.3.1-runc-1.4.2
k8s-ci-robot May 26, 2026
b336fb1
Validate target names in top-level Makefile to prevent command injection
mboersma May 20, 2026
fe291bd
Fix apt-mark hold race with apt-daily/unattended-upgrades
mboersma May 26, 2026
34d723e
Merge pull request #2022 from mboersma/fix-makefile-command-injection
k8s-ci-robot May 26, 2026
eee1435
Merge pull request #2020 from mboersma/retire-azure-vhd-builder
k8s-ci-robot May 27, 2026
c0891fd
Merge pull request #2024 from mboersma/fix-apt-mark-hold-race
k8s-ci-robot May 27, 2026
a0c6aa1
MAAS ARM64 Support
kreeuwijk May 27, 2026
d32b8fc
Merge pull request #1912 from kreeuwijk/maas-arm64
k8s-ci-robot May 27, 2026
6bd2ed1
Update Scaleway OWNERS
Tomy2e Mar 27, 2026
dac9a92
Merge pull request #1967 from Tomy2e/scw-owners
k8s-ci-robot Jun 1, 2026
63ffa19
Resolve latest Flatcar version from release server version.txt
hajowieland Jun 2, 2026
31ac090
fix(facts): ansible_architecture
reasonofsky Jun 2, 2026
6b75357
Merge pull request #2029 from hajowieland/flatcar-version
k8s-ci-robot Jun 2, 2026
7c9caa0
Merge pull request #2028 from reasonofsky/ansible_facts_architecture
k8s-ci-robot Jun 2, 2026
97fbb77
Add Ubuntu 26.04 LTS (Resolute Raccoon) support
Whisper40 Jun 3, 2026
bbdede9
Merge pull request #1987 from Whisper40/try-ubuntu26
k8s-ci-robot Jun 3, 2026
acff0c1
Add initial support for Oxide.
jmcarp May 26, 2026
5e16c2e
move kubelet --system-reserved deprecated flag to kubelet-config file…
ffais Jun 3, 2026
eee0041
dependabot(deps): bump actions/checkout in the all-github-actions group
dependabot[bot] Jun 5, 2026
40217e4
Merge pull request #2034 from kubernetes-sigs/dependabot/github_actio…
k8s-ci-robot Jun 5, 2026
a18df8f
Exclude Ubuntu 26.04 OVA build from CI
mboersma Jun 5, 2026
e2dbbc4
Merge pull request #2023 from oxidecomputer/jmcarp/oxide
k8s-ci-robot Jun 5, 2026
d380641
Move Azure WS2022 builds to new windowsserver2022 offer
mboersma Jun 5, 2026
f5b207f
Mask apt-daily and unattended-upgrades early in node role
mboersma Jun 2, 2026
74bdedf
Merge pull request #2030 from mboersma/fix-apt-daily-race-early
k8s-ci-robot Jun 6, 2026
96e8c75
Merge pull request #2036 from mboersma/exclude-ova-ubuntu-2604
k8s-ci-robot Jun 6, 2026
1195259
Merge pull request #2037 from mboersma/migrate-windows-2022-marketpla…
k8s-ci-robot Jun 6, 2026
7c358ba
Fix Ubuntu 26.04 Azure build: drop stale Microsoft 18.04 apt source
zrk02 Jun 9, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions .github/workflows/build-azure-sig.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -132,7 +132,7 @@ jobs:

steps:
- name: Checkout repository
uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3

- name: Configure Kubernetes version
uses: ./.github/actions/configure-k8s-version
Expand Down Expand Up @@ -287,7 +287,7 @@ jobs:

steps:
- name: Checkout repository
uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3

- name: Download publishing info artifact
uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
Expand Down Expand Up @@ -646,7 +646,7 @@ jobs:

steps:
- name: Checkout repository
uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3

- name: Download publishing info artifact
uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
Expand Down Expand Up @@ -799,7 +799,7 @@ jobs:

steps:
- name: Checkout repository
uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3

- name: Download publishing info artifact
uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
Expand Down
4 changes: 3 additions & 1 deletion Makefile
Original file line number Diff line number Diff line change
Expand Up @@ -34,4 +34,6 @@ update-release-docs: ## Updates the docs with reference to the latest release ve
images/capi/scripts/release-update-docs.sh

.DEFAULT:
$(MAKE) -C images/capi $@
@$(if $(or $(findstring ',$@),$(findstring \,$@)),$(error Invalid target name: $@))
@case '$@' in *[!a-zA-Z0-9_./-]*) echo 'Invalid target name' >&2; exit 1 ;; esac
@$(MAKE) -C images/capi '$@'
3 changes: 1 addition & 2 deletions OWNERS_ALIASES
Original file line number Diff line number Diff line change
Expand Up @@ -24,8 +24,7 @@ aliases:
- yadvr
image-builder-scaleway-reviewers:
- Tomy2e
- Mia-Cross
- remyleone
- pablo-ruth
image-builder-raw-maintainers:
- detiber
- thebsdbox
Expand Down
39 changes: 20 additions & 19 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,25 +20,26 @@ The table below shows the currently provided operating systems for each provider
- ✅: Image is available for the provider
- ❌: Image is not available for the provider

| OS | ami | azure | digitalocean | gce | hcloud | huaweicloud | maas | nutanix | oci | openstack | outscale | ova | powervs | proxmox | qemu | raw | scaleway | vultr |
|-------------------|----|----|----|----|----|----|----|----|----|----|----|----|----|----|----|----|----|----|
| AlmaLinux 9 | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| Amazon Linux 2 | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| Amazon Linux 2023 | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| Azure Linux 3 | ❌ | 💙 | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| CentOS 9 | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ |
| Flatcar | ✅ | 💙 | ❌ | ❌ | ✅ | ❌ | ❌ | ✅ | ❌ | ✅ | ❌ | 💙 | ❌ | ✅ | ✅ | ✅ | ❌ | ❌ |
| Oracle Linux 9 | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| Photon 4 | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| Photon 5 | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | 💙 | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| RHEL 9 | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ✅ | ✅ | ❌ | ❌ |
| Rocky Linux 9 | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ✅ | ❌ | ✅ | ❌ | 💙 | ❌ | ✅ | ✅ | ❌ | ✅ | ❌ |
| Ubuntu 22.04 | ✅ | 💙 | ✅ | 💙 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | 💙 | ❌ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Ubuntu 24.04 | ✅ | 💙 | ✅ | 💙 | ✅ | ❌ | ✅ | ✅ | ❌ | ✅ | ✅ | 💙 | ❌ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Windows 2019 | ✅ | 💙 | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| Windows 2022 | ❌ | 💙 | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ✅ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| Windows 2025 | ❌ | 💙 | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| Windows Annual | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| OS | ami | azure | digitalocean | gce | hcloud | huaweicloud | maas | nutanix | oci | openstack | outscale | ova | oxide | powervs | proxmox | qemu | raw | scaleway | vultr |
|-------------------|----|----|----|----|----|----|----|----|----|----|----|----|----|----|----|----|----|----|----|
| AlmaLinux 9 | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| Amazon Linux 2 | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| Amazon Linux 2023 | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| Azure Linux 3 | ❌ | 💙 | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| CentOS 9 | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ |
| Flatcar | ✅ | 💙 | ❌ | ❌ | ✅ | ❌ | ❌ | ✅ | ❌ | ✅ | ❌ | 💙 | ❌ | ❌ | ✅ | ✅ | ✅ | ❌ | ❌ |
| Oracle Linux 9 | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| Photon 4 | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| Photon 5 | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | 💙 | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| RHEL 9 | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ✅ | ✅ | ❌ | ❌ |
| Rocky Linux 9 | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ✅ | ❌ | ✅ | ❌ | 💙 | ❌ | ❌ | ✅ | ✅ | ❌ | ✅ | ❌ |
| Ubuntu 22.04 | ✅ | 💙 | ✅ | 💙 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | 💙 | ❌ | ❌ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Ubuntu 24.04 | ✅ | 💙 | ✅ | 💙 | ✅ | ❌ | ✅ | ✅ | ❌ | ✅ | ✅ | 💙 | ✅ | ❌ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Ubuntu 26.04 | ✅ | 💙 | ✅ | 💙 | ✅ | ❌ | ✅ | ✅ | ❌ | ✅ | ✅ | 💙 | ❌ | ❌ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Windows 2019 | ✅ | 💙 | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| Windows 2022 | ❌ | 💙 | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ✅ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| Windows 2025 | ❌ | 💙 | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| Windows Annual | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |

## Community, discussion, contribution, and support

Expand Down
4 changes: 2 additions & 2 deletions RELEASE.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
# Image Builder Releases

The current release of Image Builder is [v0.1.50][] (April 1, 2026). The corresponding container image is `registry.k8s.io/scl-image-builder/cluster-node-image-builder-amd64:v0.1.50`.
The current release of Image Builder is [v0.1.52][] (April 1, 2026). The corresponding container image is `registry.k8s.io/scl-image-builder/cluster-node-image-builder-amd64:v0.1.52`.

## Release Process

For more detail about image-builder project releases, see the [Image Builder Book][].


[v0.1.50]: https://github.com/kubernetes-sigs/image-builder/releases/tag/v0.1.50
[v0.1.52]: https://github.com/kubernetes-sigs/image-builder/releases/tag/v0.1.52
[Image Builder Book]: https://image-builder.sigs.k8s.io/capi/releasing.html
2 changes: 1 addition & 1 deletion cloudbuild.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ timeout: 3000s
options:
substitution_option: ALLOW_LOOSE
steps:
- name: 'gcr.io/k8s-staging-test-infra/gcb-docker-gcloud@sha256:63840f133e0dfeea0af9ef391210da7fab9d2676172e2967fccab0cd6110c4e7' # v20250513-9264efb079
- name: 'gcr.io/k8s-staging-test-infra/gcb-docker-gcloud@sha256:ff388e0dc16351e96f8464e2e185b74a7578a5ccb7a112cf3393468e59e6e2d2' # v20260205-38cfa9523f
entrypoint: make
env:
- DOCKER_CLI_EXPERIMENTAL=enabled
Expand Down
1 change: 1 addition & 0 deletions docs/book/src/SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@
- [OpenStack](./capi/providers/openstack.md)
- [OpenStack remote image building](./capi/providers/openstack-remote.md)
- [OCI](./capi/providers/oci.md)
- [Oxide](./capi/providers/oxide.md)
- [raw](./capi/providers/raw.md)
- [Scaleway](./capi/providers/scaleway.md)
- [vSphere](./capi/providers/vsphere.md)
Expand Down
10 changes: 5 additions & 5 deletions docs/book/src/capi/container-image.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ Run the docker build target of Makefile
The latest image-builder container image release is available here:

```commandline
docker pull registry.k8s.io/scl-image-builder/cluster-node-image-builder-amd64:v0.1.50
docker pull registry.k8s.io/scl-image-builder/cluster-node-image-builder-amd64:v0.1.52
```

### Examples
Expand All @@ -27,7 +27,7 @@ docker pull registry.k8s.io/scl-image-builder/cluster-node-image-builder-amd64:v
- If the AWS CLI is already installed on your machine, you can simply mount the `~/.aws` folder that stores all the required credentials.

```commandline
docker run -it --rm -v /Users/<user>/.aws:/home/imagebuilder/.aws registry.k8s.io/scl-image-builder/cluster-node-image-builder-amd64:v0.1.50 build-ami-ubuntu-2404
docker run -it --rm -v /Users/<user>/.aws:/home/imagebuilder/.aws registry.k8s.io/scl-image-builder/cluster-node-image-builder-amd64:v0.1.52 build-ami-ubuntu-2404
```
- Another alternative is to use an `aws-creds.env` file to load the credentials and pass it during docker run.

Expand All @@ -37,7 +37,7 @@ docker pull registry.k8s.io/scl-image-builder/cluster-node-image-builder-amd64:v
```

```commandline
docker run -it --rm --env-file aws-creds.env registry.k8s.io/scl-image-builder/cluster-node-image-builder-amd64:v0.1.50 build-ami-ubuntu-2404
docker run -it --rm --env-file aws-creds.env registry.k8s.io/scl-image-builder/cluster-node-image-builder-amd64:v0.1.52 build-ami-ubuntu-2404
```

- AZURE
Expand All @@ -51,7 +51,7 @@ docker pull registry.k8s.io/scl-image-builder/cluster-node-image-builder-amd64:v
```

```commandline
docker run -it --rm --env-file az-creds.env registry.k8s.io/scl-image-builder/cluster-node-image-builder-amd64:v0.1.50 build-azure-sig-ubuntu-2404
docker run -it --rm --env-file az-creds.env registry.k8s.io/scl-image-builder/cluster-node-image-builder-amd64:v0.1.52 build-azure-sig-ubuntu-2404
```

- Proxmox
Expand Down Expand Up @@ -83,7 +83,7 @@ docker pull registry.k8s.io/scl-image-builder/cluster-node-image-builder-amd64:v
- Docker's `--net=host` option to ensure http server starts with the host IP and not the Docker container IP. This option is Linux specific and thus implies that it can be run only from a Linux machine.

```commandline
docker run -it --rm --net=host --env PACKER_VAR_FILES=/home/imagebuilder/vsphere.json -v <complete path of vsphere.json>:/home/imagebuilder/vsphere.json registry.k8s.io/scl-image-builder/cluster-node-image-builder-amd64:v0.1.50 build-node-ova-vsphere-ubuntu-2404
docker run -it --rm --net=host --env PACKER_VAR_FILES=/home/imagebuilder/vsphere.json -v <complete path of vsphere.json>:/home/imagebuilder/vsphere.json registry.k8s.io/scl-image-builder/cluster-node-image-builder-amd64:v0.1.52 build-node-ova-vsphere-ubuntu-2404
```

In addition to this, further customizations can be done as discussed [here](./capi.md#customization).
8 changes: 8 additions & 0 deletions docs/book/src/capi/containerd/customizing-containerd.md
Original file line number Diff line number Diff line change
Expand Up @@ -84,3 +84,11 @@ You can also add further configuration by adding values for `containerd_addition
end of the
[`config.toml`](https://github.com/kubernetes-sigs/image-builder/blob/main/images/capi/ansible/roles/containerd/templates/etc/containerd/config.toml#L86)
default template.

## Overriding `LimitNOFILE`

By default a `LimitNOFILE` systemd drop-in (capping the value at `1048576`) is only deployed on
Common Base Linux Mariner, Flatcar, and Microsoft Azure Linux, where the upstream `infinity` value
has been known to cause issues with some containerized software. To opt-in to deploying the same
drop-in on other operating systems, set `containerd_enable_limit_no_file` to `true`. It defaults to
`false`.
1 change: 1 addition & 0 deletions docs/book/src/capi/providers/3dsoutscale.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,7 @@ the different operating systems.
|------|-------------|
| `ubuntu-2204.json` | The settings for the Ubuntu 22.04 image |
| `ubuntu-2404.json` | The settings for the Ubuntu 24.04 image |
| `ubuntu-2604.json` | The settings for the Ubuntu 26.04 image |

You must have your [Access Keys](https://docs.outscale.com/en/userguide/About-Access-Keys.html).
You must have your [Account Id](https://docs.outscale.com/en/userguide/Getting-Information-About-Your-Account-and-Quotas.html).
Expand Down
1 change: 1 addition & 0 deletions docs/book/src/capi/providers/aws.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,6 +46,7 @@ the different operating systems.
| `rockylinux.json` | The settings for the Rocky Linux image |
| `ubuntu-2204.json` | The settings for the Ubuntu 22.04 image |
| `ubuntu-2404.json` | The settings for the Ubuntu 24.04 image |
| `ubuntu-2604.json` | The settings for the Ubuntu 26.04 image |
| `windows-2019.json` | The settings for the Windows 2019 image |


Expand Down
23 changes: 4 additions & 19 deletions docs/book/src/capi/providers/azure.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ These images are designed for use with [Cluster API Provider Azure](https://capz
- An Azure account
- The Azure CLI installed and configured
- Set environment variables for `AZURE_SUBSCRIPTION_ID`, `AZURE_CLIENT_ID`, `AZURE_CLIENT_SECRET`
- Set optional environment variables `RESOURCE_GROUP_NAME`, `BUILD_RESOURCE_GROUP_NAME`, `STORAGE_ACCOUNT_NAME`, `AZURE_LOCATION` & `GALLERY_NAME` to override the default values
- Set optional environment variables `RESOURCE_GROUP_NAME`, `BUILD_RESOURCE_GROUP_NAME`, `AZURE_LOCATION` & `GALLERY_NAME` to override the default values

## Building Images

Expand All @@ -20,11 +20,7 @@ make deps-azure

### Building Managed Images in Shared Image Galleries

From the `images/capi` directory, run `make build-azure-sig-ubuntu-1804`

### Building VHDs

From the `images/capi` directory, run `make build-azure-vhd-ubuntu-1804`
From the `images/capi` directory, run `make build-azure-sig-ubuntu-2204`

> If building the Windows images from a Mac there is a known issue with connectivity. Please see details on running [macOS with ansible](../windows/windows.md#macos-with-ansible).

Expand All @@ -34,14 +30,12 @@ Most of the images built from the `images/capi` directory for Azure will be Hype

```bash
# Generation 1 image
make build-azure-sig-ubuntu-1804
make build-azure-sig-ubuntu-2204

# Generation 2 image
make build-azure-sig-ubuntu-1804-gen2
make build-azure-sig-ubuntu-2204-gen2
```

Generation 2 images may only be used with Shared Image Gallery, not VHD.

### Confidential VM Images

Confidential VMs require specific generation 2 OS images. The naming pattern of those images includes the suffix `-cvm`. For example:
Expand Down Expand Up @@ -76,15 +70,6 @@ list, and greater explanation can be found in the

If you are adding features to image builder than it is sometimes useful to work with the images directly. This section gives some tips.

### Provision a VM directly from a VHD

After creating a VHD, create a managed image using the url output from `make build-azure-vhd-<image>` and use it to [create the VM](https://learn.microsoft.com/azure/virtual-machines/windows/build-image-with-packer#create-a-vm-from-the-packer-image):

```bash
az image create -n testvmimage -g cluster-api-images --os-type <Windows/Linux> --source <storage url for vhd file>
az vm create -n testvm --image testvmimage -g cluster-api-images
```

### Debugging Packer scripts
There are several ways to debug Packer scripts: https://developer.hashicorp.com/packer/docs/debugging

1 change: 1 addition & 0 deletions docs/book/src/capi/providers/digitalocean.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,3 +27,4 @@ the different operating systems.
|------|-------------|
| `ubuntu-2204.json` | The settings for the Ubuntu 22.04 image |
| `ubuntu-2404.json` | The settings for the Ubuntu 24.04 image |
| `ubuntu-2604.json` | The settings for the Ubuntu 26.04 image |
1 change: 1 addition & 0 deletions docs/book/src/capi/providers/gcp.md
Original file line number Diff line number Diff line change
Expand Up @@ -50,6 +50,7 @@ The `gce` sub-directory inside `images/capi/packer` stores JSON configuration fi
| -------- | --------
| `ubuntu-2204.json` | Settings for Ubuntu 22.04 image |
| `ubuntu-2404.json` | Settings for Ubuntu 24.04 image |
| `ubuntu-2604.json` | Settings for Ubuntu 26.04 image |

#### Common GCP options

Expand Down
1 change: 1 addition & 0 deletions docs/book/src/capi/providers/hcloud.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,3 +29,4 @@ the different operating systems.
| `rockylinux-9.json` | The settings for the RockyLinux 9 image |
| `ubuntu-2204.json` | The settings for the Ubuntu 22.04 image |
| `ubuntu-2404.json` | The settings for the Ubuntu 24.04 image |
| `ubuntu-2604.json` | The settings for the Ubuntu 26.04 image |
4 changes: 2 additions & 2 deletions docs/book/src/capi/providers/maas.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ From the `image-builder` directory, run:
make build-maas-ubuntu-xxxx-efi
```

The image will be located in `images/capi/output/BUILD_NAME+kube-KUBERNETES_VERSION`. Replace `xxxx` with `2204` or `2404`, depending on the Ubuntu version.
The image will be located in `images/capi/output/BUILD_NAME+kube-KUBERNETES_VERSION`. Replace `xxxx` with `2204`, `2404` or `2604`, depending on the Ubuntu version.

To build a Ubuntu 22.04-based CAPI image:

Expand Down Expand Up @@ -73,7 +73,7 @@ Use the **.tar.gz** file for the upload:
maas admin boot-resources create name=custom/your-image architecture=amd64/generic title=your-image subarches=generic base_image=ubuntu/jammy content@=./ubuntu-2204-efi-kube-v1.30.5.tar.gz
```

**Note:** Set `base_image=ubuntu/jammy` for Ubuntu 22.04 or `ubuntu/noble` for 24.04.
**Note:** Set `base_image=ubuntu/jammy` for Ubuntu 22.04, `ubuntu/noble` for 24.04, or `ubuntu/resolute` for 26.04.

## Custom Curtin Scripts
If you need to override the default MaaS curtin scripts, create a custom role containing the curtin hooks. The files must be copied to the `/curtin` directory
Expand Down
30 changes: 30 additions & 0 deletions docs/book/src/capi/providers/oxide.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
# Building Images for Oxide

## Prerequisites for Oxide

- Credentials for an Oxide rack, configured via either `OXIDE_PROFILE` or `OXIDE_HOST`/`OXIDE_TOKEN` in the environment.
- The following environment variables set:

| Variable | Description |
|----------|-------------|
| `OXIDE_PROJECT` | Name or ID of the Oxide project to build the image in. |
| `OXIDE_BOOT_DISK_IMAGE_ID` | UUID of the image to use as the build source. |

## Building Images

The build [prerequisites](../capi.md#prerequisites) for using `image-builder` for
building Oxide images are managed by running:

```bash
make deps-oxide
```

From the `images/capi` directory, run `make build-oxide-<OS>` where `<OS>` is the desired operating system. The available choices are listed via `make help`.

### Configuration

In addition to the configuration found in `images/capi/packer/config`, the `oxide` directory includes per-OS JSON files that define defaults for each supported image:

| File | Description |
|------|-------------|
| `ubuntu-2404.json` | Settings for the Ubuntu 24.04 image |
1 change: 1 addition & 0 deletions docs/book/src/capi/providers/proxmox.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,7 @@ the different operating systems.
|--------------------|-----------------------------------------|
| `ubuntu-2204.json` | The settings for the Ubuntu 22.04 image |
| `ubuntu-2404.json` | The settings for the Ubuntu 24.04 image |
| `ubuntu-2604.json` | The settings for the Ubuntu 26.04 image |

The full list of available environment vars can be found in the `variables` section of `images/capi/packer/proxmox/packer.json`.

Expand Down
1 change: 1 addition & 0 deletions docs/book/src/capi/providers/scaleway.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,3 +27,4 @@ the different operating systems.
| `rockylinux-9.json` | The settings for the Rocky Linux 9 image |
| `ubuntu-2204.json` | The settings for the Ubuntu 22.04 image |
| `ubuntu-2404.json` | The settings for the Ubuntu 24.04 image |
| `ubuntu-2604.json` | The settings for the Ubuntu 26.04 image |
Loading