beaker-kubevirt 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 42851521ceebcac0549527587051965bce3698a15ea7995f3111db7b481b5ce9
+  data.tar.gz: 4ed638d67f36721a8d656e57096f09ccd4e32c010c642625608ac830de41fea3
+SHA512:
+  metadata.gz: aaef810b582931893e1828c4fcf7cde1d42b86f30ab030ef0937bde204eb1b8cccc4e520e0b0bbbc854c55f774514c27dc5d5f1c00cb8ea41e1d39d632bd137d
+  data.tar.gz: a56cb846fc5bb309755fca675017abd7c66f518bf266b092c26482ed64254f10e4cfae25580217b750dbb747cf2230c8bdd1cf8e8b947c7c5bf3c399bdc23187

data/.devcontainer/.pryrc

@@ -0,0 +1,10 @@
+if defined?(PryByebug)
+  Pry.commands.alias_command 'c', 'continue'
+  Pry.commands.alias_command 's', 'step'
+  Pry.commands.alias_command 'n', 'next'
+  Pry.commands.alias_command 'f', 'finish'
+  # Hit Enter to repeat last command
+  Pry::Commands.command(/^$/, 'repeat last command') do
+    pry_instance.run_command Pry.history.to_a.last
+  end
+end

data/.devcontainer/Dockerfile

@@ -0,0 +1,49 @@
+FROM mcr.microsoft.com/devcontainers/ruby:1-3.4-bullseye
+
+RUN mkdir -p /buildtmp \
+    && chown -R vscode:vscode /buildtmp
+
+USER vscode
+WORKDIR /home/vscode
+
+RUN set -x; cd "$(mktemp -d)" && \
+    OS="$(uname | tr '[:upper:]' '[:lower:]')" && \
+    ARCH="$(uname -m | sed -e 's/x86_64/amd64/' -e 's/\(arm\)\(64\)\?.*/\1\2/' -e 's/aarch64$/arm64/')" && \
+    KREW="krew-${OS}_${ARCH}" && \
+    curl -fsSLO "https://github.com/kubernetes-sigs/krew/releases/latest/download/${KREW}.tar.gz" && \
+    tar zxvf "${KREW}.tar.gz" && \
+    ./"${KREW}" install krew
+
+# Add krew to PATH
+RUN cat >> /home/vscode/.bashrc <<EOF
+# Add krew to PATH
+export PATH="${KREW_ROOT:-$HOME/.krew}/bin:$PATH"
+
+# Enable shell completion for kubectl
+source <(kubectl completion bash)
+
+# Make kubectl completion work for the alias 'k'
+alias k="kubectl"
+complete -o default -F __start_kubectl k
+
+EOF
+
+COPY --chown=vscode:vscode .devcontainer/.pryrc ./
+RUN mkdir -p /home/vscode/.ssh && \
+    chown -R vscode:vscode /home/vscode/.ssh && \
+    chmod 700 /home/vscode/.ssh
+# Set the working directory in the container
+WORKDIR /buildtmp
+RUN bundle config path /home/vscode/.bundle
+# 1. Copy only the files that define your dependencies.
+# The layer cache for the next step will only be invalidated
+# if these specific files change.
+COPY --chown=vscode:vscode ../*.gemspec ./
+COPY --chown=vscode:vscode ../Gemfile* ./
+# Need the version.rb file to allow bundler to run
+COPY --chown=vscode:vscode ../lib/beaker/kubevirt/version.rb ./lib/beaker/kubevirt/version.rb
+
+# 2. Install all dependencies using Bundler.
+# This is the time-consuming step that we want to cache.
+# It will only re-run if the .gemspec or Gemfile changes.
+RUN bundle install --jobs "$(nproc)"

data/.devcontainer/devcontainer.json

@@ -0,0 +1,53 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the
+// README at: https://github.com/devcontainers/templates/tree/main/src/ruby
+{
+	"name": "Ruby",
+	// Or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
+	"build": {
+		// Use 'dockerfile' to specify a Dockerfile. More info: https://containers.dev/guide/dockerfile
+		"dockerfile": "Dockerfile",
+		// Use 'context' to specify the build context. More info: https://containers.dev/guide/dockerfile#build-context
+		"context": ".."
+		// Use 'args' to pass build arguments. More info: https://containers.dev/guide/dockerfile#build-args
+		// "args": {}
+	},
+	"features": {
+		"ghcr.io/devcontainers/features/kubectl-helm-minikube:1": {},
+		"ghcr.io/devcontainers-extra/features/kubectx-kubens:1": {},
+		"ghcr.io/stuartleeks/dev-container-features/shell-history:0": {},
+		"ghcr.io/larsnieuwenhuizen/features/neovim:0": {},
+		"ghcr.io/devcontainers-extra/features/fzf:1": {}
+	},
+	"customizations": {
+		"vscode": {
+			"settings": {
+				"ruby.useLanguageServer": true,
+				"ruby.lsp.debug": true
+			},
+			"extensions": [
+				"Shopify.ruby-lsp",
+				"adrientoub.base64utils"
+			]
+		}
+	},
+	"workspaceMount": "source=${localWorkspaceFolder},target=/workspaces/${localWorkspaceFolderBasename},type=bind,consistency=cached",
+	"workspaceFolder": "/workspaces/${localWorkspaceFolderBasename}",
+	"postCreateCommand": {
+		"Generate SSH Key": "ssh-keygen -N '' -t rsa -b 4096 -f /home/vscode/.ssh/id_rsa",
+		"Update Dependencies": "bundle install",
+		"Install Kubevirt krew plugin": "kubectl krew install virt"
+	},
+	"mounts": [
+		"type=bind,src=${localEnv:HOME}/.kube,dst=/home/vscode/.kube,consistency=cached",
+	]
+	// Features to add to the dev container. More info: https://containers.dev/features.
+	// "features": {},
+	// Use 'forwardPorts' to make a list of ports inside the container available locally.
+	// "forwardPorts": [],
+	// Use 'postCreateCommand' to run commands after the container is created.
+	// "postCreateCommand": "ruby --version",
+	// Configure tool-specific properties.
+	// "customizations": {},
+	// Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
+	// "remoteUser": "root"
+}

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,30 @@
+---
+inherit_gem:
+  voxpupuli-rubocop: rubocop.yml
+
+Layout/LineLength:
+  Enabled: false
+
+# Increase RSpec example length limits for integration tests
+RSpec/ExampleLength:
+  Max: 40
+
+# Allow more expectations in integration tests
+RSpec/MultipleExpectations:
+  Max: 5
+
+# Allow more memoized helpers for complex test setups
+RSpec/MultipleMemoizedHelpers:
+  Max: 10
+
+# Allow instance variables in before blocks for reactor state tracking
+RSpec/InstanceVariable:
+  Enabled: false
+
+# MessageSpies style is a preference - allow both styles
+RSpec/MessageSpies:
+  Enabled: false
+
+# Allow non-verified doubles for flexibility in testing
+RSpec/VerifiedDoubles:
+  Enabled: false

data/CHANGELOG.md

@@ -0,0 +1,55 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [1.0.0](https://github.com/voxpupuli/beaker-kubevirt/tree/1.0.0) (2026-07-17)
+
+[Full Changelog](https://github.com/voxpupuli/beaker-kubevirt/compare/a388e545ac4aa46006e53f006ad5af1a243bdbbd...1.0.0)
+
+**Closed issues:**
+
+- Add cleanup on exit [\#10](https://github.com/voxpupuli/beaker-kubevirt/issues/10)
+
+**Merged pull requests:**
+
+- CI: Apply Release best practices & Set default token permission & Generate ruby matrix [\#44](https://github.com/voxpupuli/beaker-kubevirt/pull/44) ([bastelfreak](https://github.com/bastelfreak))
+- Update voxpupuli-rubocop requirement from ~\> 5.0.0 to ~\> 5.2.0 [\#43](https://github.com/voxpupuli/beaker-kubevirt/pull/43) ([dependabot[bot]](https://github.com/apps/dependabot))
+- CI: apply Vox Pupuli defaults [\#39](https://github.com/voxpupuli/beaker-kubevirt/pull/39) ([bastelfreak](https://github.com/bastelfreak))
+- Use /portforward/\<port\>/tcp form for VMI WebSocket URL [\#38](https://github.com/voxpupuli/beaker-kubevirt/pull/38) ([jaevans](https://github.com/jaevans))
+- Keep long-running SSH sessions alive past idle timeouts [\#37](https://github.com/voxpupuli/beaker-kubevirt/pull/37) ([jaevans](https://github.com/jaevans))
+- Clean up port forwarder log levels and messages [\#36](https://github.com/voxpupuli/beaker-kubevirt/pull/36) ([jaevans](https://github.com/jaevans))
+- Clean up DataVolumes labeled for the test group [\#35](https://github.com/voxpupuli/beaker-kubevirt/pull/35) ([jaevans](https://github.com/jaevans))
+- Unlink kubeconfig-derived tempfiles at cleanup [\#34](https://github.com/voxpupuli/beaker-kubevirt/pull/34) ([jaevans](https://github.com/jaevans))
+- Bound EventMachine reactor startup wait [\#33](https://github.com/voxpupuli/beaker-kubevirt/pull/33) ([jaevans](https://github.com/jaevans))
+- Validate namespace and URL-encode WebSocket path segments [\#32](https://github.com/voxpupuli/beaker-kubevirt/pull/32) ([jaevans](https://github.com/jaevans))
+- Sanitize hostnames before using as k8s label values [\#31](https://github.com/voxpupuli/beaker-kubevirt/pull/31) ([jaevans](https://github.com/jaevans))
+- Normalize and validate kubeconfig path [\#30](https://github.com/voxpupuli/beaker-kubevirt/pull/30) ([jaevans](https://github.com/jaevans))
+- Tag NodePort services with beaker/test-group for cleanup [\#29](https://github.com/voxpupuli/beaker-kubevirt/pull/29) ([jaevans](https://github.com/jaevans))
+- Don't abort cluster cleanup when a port-forwarder gets stuck [\#28](https://github.com/voxpupuli/beaker-kubevirt/pull/28) ([jaevans](https://github.com/jaevans))
+- Scope at\_exit cleanup suppression to this gem's own tests [\#27](https://github.com/voxpupuli/beaker-kubevirt/pull/27) ([jaevans](https://github.com/jaevans))
+- Preserve existing host\['ssh'\]\['keys'\] when configuring kubevirt key [\#26](https://github.com/voxpupuli/beaker-kubevirt/pull/26) ([jaevans](https://github.com/jaevans))
+- Log SSH private key basename at INFO, full path at DEBUG [\#25](https://github.com/voxpupuli/beaker-kubevirt/pull/25) ([jaevans](https://github.com/jaevans))
+- Pvc namespace [\#22](https://github.com/voxpupuli/beaker-kubevirt/pull/22) ([jaevans](https://github.com/jaevans))
+- Fix Windows VM OOMKills and fail fast on virt-launcher pod failure [\#21](https://github.com/voxpupuli/beaker-kubevirt/pull/21) ([jaevans](https://github.com/jaevans))
+- Add Ruby 4.0 to CI test matrix [\#20](https://github.com/voxpupuli/beaker-kubevirt/pull/20) ([jaevans](https://github.com/jaevans))
+- Add bug tracker URI to gemspec metadata [\#19](https://github.com/voxpupuli/beaker-kubevirt/pull/19) ([jaevans](https://github.com/jaevans))
+- Add error handling for cloud-init YAML parsing [\#18](https://github.com/voxpupuli/beaker-kubevirt/pull/18) ([jaevans](https://github.com/jaevans))
+- Fix SSH key path expansion [\#17](https://github.com/voxpupuli/beaker-kubevirt/pull/17) ([jaevans](https://github.com/jaevans))
+- Add error handling to VM creation in provision [\#16](https://github.com/voxpupuli/beaker-kubevirt/pull/16) ([jaevans](https://github.com/jaevans))
+- Remove dead code and vague TODO [\#14](https://github.com/voxpupuli/beaker-kubevirt/pull/14) ([jaevans](https://github.com/jaevans))
+- Remove stale comment from CI workflow [\#13](https://github.com/voxpupuli/beaker-kubevirt/pull/13) ([jaevans](https://github.com/jaevans))
+- Remove internal files and update .gitignore [\#12](https://github.com/voxpupuli/beaker-kubevirt/pull/12) ([jaevans](https://github.com/jaevans))
+- Add cleanup on exit handler for hypervisor resources [\#11](https://github.com/voxpupuli/beaker-kubevirt/pull/11) ([Copilot](https://github.com/apps/copilot-swe-agent))
+- Remove setting of resources on the VM spec [\#9](https://github.com/voxpupuli/beaker-kubevirt/pull/9) ([jaevans](https://github.com/jaevans))
+- Enhance PVC reference handling [\#8](https://github.com/voxpupuli/beaker-kubevirt/pull/8) ([jaevans](https://github.com/jaevans))
+- Prefix options with "kubevirt\_" [\#7](https://github.com/voxpupuli/beaker-kubevirt/pull/7) ([jaevans](https://github.com/jaevans))
+- Improve-port-forward [\#6](https://github.com/voxpupuli/beaker-kubevirt/pull/6) ([jaevans](https://github.com/jaevans))
+- Initial windows support [\#5](https://github.com/voxpupuli/beaker-kubevirt/pull/5) ([jaevans](https://github.com/jaevans))
+- fix: Modify cleanup to correctly find the name in the resource metadata [\#4](https://github.com/voxpupuli/beaker-kubevirt/pull/4) ([jaevans](https://github.com/jaevans))
+- Switch license from Apache-2.0 to AGPL-3.0-or-later [\#3](https://github.com/voxpupuli/beaker-kubevirt/pull/3) ([silug](https://github.com/silug))
+- More functionality [\#2](https://github.com/voxpupuli/beaker-kubevirt/pull/2) ([jaevans](https://github.com/jaevans))
+- Make functional [\#1](https://github.com/voxpupuli/beaker-kubevirt/pull/1) ([jaevans](https://github.com/jaevans))
+
+
+
+\* *This Changelog was automatically generated by [github_changelog_generator](https://github.com/github-changelog-generator/github-changelog-generator)*

data/History.md

@@ -0,0 +1,48 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+- `kubevirt_memory_overhead` (default `512Mi`) and `kubevirt_memory_request` options.
+  The VM spec now sets `spec.template.spec.domain.resources.requests/limits.memory`
+  explicitly (guest + overhead for the limit) so Windows guests no longer get
+  OOMKilled by KubeVirt's too-small auto-computed virt-launcher overhead.
+- `wait_for_vm_ready` now inspects the virt-launcher pod each poll and fails
+  fast with a specific reason (OOMKilled, CrashLoopBackOff, ImagePullBackOff,
+  terminal VMI phase, ...) instead of hanging for the full timeout.
+- TCP `readinessProbe` on the guest's SSH port is added to the VM spec by
+  default (for `port-forward` and `nodeport` network modes; skipped for
+  `multus`). `wait_for_vm_ready` now waits for the VMI's `Ready` condition to
+  flip to `True`, so provisioning only hands off to Beaker once sshd is
+  actually accepting connections — no more SSH "connection refused" retries
+  while cloud-init / Windows first-boot is still running. Tunable via
+  `kubevirt_readiness_probe` and opt-out via `kubevirt_readiness_probe_disabled`.
+  When the probe is enabled, `timeout` is auto-raised to fit the probe's
+  failure budget.
+- Initial implementation of KubeVirt hypervisor provider for Beaker
+- Support for VM provisioning using KubeVirt VirtualMachine objects
+- Multiple image source support (PVC, ContainerDisk, DataVolume)
+- Cloud-init configuration injection for VM setup
+- Multiple networking modes:
+  - Port-forward (default, works in all environments)
+  - NodePort (requires node access)
+  - Multus (external bridge networking)
+- Automatic VM lifecycle management (provision, test, cleanup)
+- SSH key injection and access setup
+- Resource configuration (CPU, memory)
+- Kubernetes authentication support (token, client certificates)
+- Comprehensive test suite and examples
+
+### Security
+- SSH public key authentication by default
+- Secure handling of Kubernetes credentials
+
+## [0.1.0] - 2025-07-07
+
+### Added
+- Initial gem structure and basic implementation