Skip to content

docs(virtualization): document vm-default-images as opt-in package#538

Open
myasnikovdaniil wants to merge 1 commit into
mainfrom
docs/vm-default-images-optin
Open

docs(virtualization): document vm-default-images as opt-in package#538
myasnikovdaniil wants to merge 1 commit into
mainfrom
docs/vm-default-images-optin

Conversation

@myasnikovdaniil
Copy link
Copy Markdown
Contributor

@myasnikovdaniil myasnikovdaniil commented May 14, 2026

Summary

  • Add a "Default Image Collection (opt-in package)" section to the Golden Images page in v1.3/ and next/.
  • Document that vm-default-images is disabled by default, the ~320Gi storage footprint of the default 16-image set, how to enable it via bundles.enabledPackages, and how to override storageClass / the images[] list through the cozystack.vm-default-images Package.

Test plan

  • hugo --buildDrafts --buildFuture builds without errors.
  • The {{% alert %}} shortcode renders to alert alert-warning markup in the generated docs/v1.3/virtualization/vm-image/index.html.
  • Spot-check the Netlify deploy preview for both /docs/v1.3/virtualization/vm-image/ and /docs/next/virtualization/vm-image/.

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Documentation
    • Added guide for Default Image Collection (opt-in package), covering enablement, verification of HelmRelease and DataVolumes, Golden Image naming behavior, image list configuration including storage sizing and metadata, and image removal procedures.

Review Change Stack

Add a "Default Image Collection (opt-in package)" section to the Golden
Images page in v1.3/ and next/, covering the disabled-by-default status,
storage footprint (~320Gi for the default 16-image set), enabling via
bundles.enabledPackages, and overriding the image list through the
cozystack.vm-default-images Package values.

Signed-off-by: Myasnikov Daniil <myasnikovdaniil2001@gmail.com>
@netlify
Copy link
Copy Markdown

netlify Bot commented May 14, 2026

Deploy Preview for cozystack ready!

Name Link
🔨 Latest commit 106e425
🔍 Latest deploy log https://app.netlify.com/projects/cozystack/deploys/6a0554d05a702a0008e5ce24
😎 Deploy Preview https://deploy-preview-538--cozystack.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented May 14, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 2fb06766-ec22-4a72-8d1b-ef7f79989940

📥 Commits

Reviewing files that changed from the base of the PR and between f466d34 and 106e425.

📒 Files selected for processing (2)
  • content/en/docs/next/virtualization/vm-image.md
  • content/en/docs/v1.3/virtualization/vm-image.md

📝 Walkthrough

Walkthrough

This PR adds documentation for an opt-in virtual machine default images package across two documentation versions. Both updates introduce a new section explaining how to enable cozystack.vm-default-images, verify the provisioned resources, understand tenant-facing naming conventions, customize the image list with storage and metadata configuration, and remove images post-installation.

Changes

VM Default Images Documentation

Layer / File(s) Summary
Default Image Collection opt-in documentation
content/en/docs/next/virtualization/vm-image.md, content/en/docs/v1.3/virtualization/vm-image.md
New "Default Image Collection (opt-in package)" section is added to both current and v1.3 documentation versions, documenting the cozystack.vm-default-images package with enablement steps, verification commands, HelmRelease and DataVolume details, tenant-exposed Golden Image naming, storage requirements, configuration schema and value overrides for the images[] list, and procedures to remove images by deleting their DataVolumes.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

🐰 A fluffy update hops our way,
VM images, golden, bright to display,
Opt-in packages, docs so clear,
Tenants rejoice—default images here! 🖼️

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title directly and specifically describes the main change: adding documentation for vm-default-images as an opt-in package, which aligns perfectly with the changeset's focus on documenting this feature in both documentation versions.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/vm-default-images-optin
⚔️ Resolve merge conflicts
  • Resolve merge conflict in branch docs/vm-default-images-optin

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces documentation for the vm-default-images opt-in package, which provides a curated set of pre-built Golden Images for virtualization. The documentation covers enabling the package, storage requirements, and configuration of the image list. Feedback was provided to correct the naming convention for DataVolumes from vm-default-images- to vm-image- to ensure consistency with Cozystack's standard resource identification.

kubectl -n cozy-public get dv
```

DataVolumes provisioned by the package are named `vm-default-images-<image>` and are exposed to tenants as Golden Images named `<image>` (e.g. `ubuntu-24.04`, `debian-12`).
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The naming convention for golden images in Cozystack typically requires the vm-image- prefix (as defined in the naming conventions table on line 25 and the script section on line 142) for them to be correctly identified and exposed to tenants. If the vm-default-images package follows this standard, the documentation should reflect the vm-image- prefix instead of vm-default-images- to avoid confusion.

Suggested change
DataVolumes provisioned by the package are named `vm-default-images-<image>` and are exposed to tenants as Golden Images named `<image>` (e.g. `ubuntu-24.04`, `debian-12`).
DataVolumes provisioned by the package are named vm-image-<image> and are exposed to tenants as Golden Images named <image> (e.g. ubuntu-24.04, debian-12).

To drop an image after the package is installed, remove it from `images[]` and delete the orphaned DataVolume:

```bash
kubectl -n cozy-public delete dv vm-default-images-<name>
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

Update the deletion command to use the correct prefix for the DataVolume, consistent with the standard naming convention for golden images in Cozystack.

Suggested change
kubectl -n cozy-public delete dv vm-default-images-<name>
kubectl -n cozy-public delete dv vm-image-<name>

kubectl -n cozy-public get dv
```

DataVolumes provisioned by the package are named `vm-default-images-<image>` and are exposed to tenants as Golden Images named `<image>` (e.g. `ubuntu-24.04`, `debian-12`).
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The naming convention for golden images in Cozystack typically requires the vm-image- prefix (as defined in the naming conventions table on line 25 and the script section on line 142) for them to be correctly identified and exposed to tenants. If the vm-default-images package follows this standard, the documentation should reflect the vm-image- prefix instead of vm-default-images- to avoid confusion.

Suggested change
DataVolumes provisioned by the package are named `vm-default-images-<image>` and are exposed to tenants as Golden Images named `<image>` (e.g. `ubuntu-24.04`, `debian-12`).
DataVolumes provisioned by the package are named vm-image-<image> and are exposed to tenants as Golden Images named <image> (e.g. ubuntu-24.04, debian-12).

To drop an image after the package is installed, remove it from `images[]` and delete the orphaned DataVolume:

```bash
kubectl -n cozy-public delete dv vm-default-images-<name>
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

Update the deletion command to use the correct prefix for the DataVolume, consistent with the standard naming convention for golden images in Cozystack.

Suggested change
kubectl -n cozy-public delete dv vm-default-images-<name>
kubectl -n cozy-public delete dv vm-image-<name>

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant