Skip to content

Release Smoke Test v1.1.3

This guide is for maintainers validating v1.1.3 on a real Linux/KVM host.

Run it on a fresh machine when possible. The goal is to prove fresh install, update, artifact download, VM lifecycle, guest control, snapshots, private networking, template initialization, raw exec output, and the daily update notice cache.

Prepare

export YEAST_SMOKE_VERSION="v1.1.3"
export YEAST_SMOKE_ROOT="$HOME/yeast-${YEAST_SMOKE_VERSION}-smoke"
mkdir -p "$YEAST_SMOKE_ROOT"
cd "$YEAST_SMOKE_ROOT"

Host checks:

uname -m
ls -l /dev/kvm || true
id

Artifact Check

mkdir -p artifact-test
cd artifact-test
curl -fLO "https://github.com/Twarga/yeast/releases/download/${YEAST_SMOKE_VERSION}/yeast_linux_amd64.tar.gz"
curl -fLO "https://github.com/Twarga/yeast/releases/download/${YEAST_SMOKE_VERSION}/SHA256SUMS.txt"
grep "yeast_linux_amd64.tar.gz" SHA256SUMS.txt | sha256sum -c -
tar -tzf yeast_linux_amd64.tar.gz
tar -xzf yeast_linux_amd64.tar.gz
./yeast version
sudo install -m 0755 yeast /usr/local/bin/yeast
hash -r
yeast version
cd "$YEAST_SMOKE_ROOT"

The tarball must contain a binary named yeast.

Installer Check

mkdir -p installer-test
cd installer-test
curl -fsSL "https://raw.githubusercontent.com/Twarga/yeast/${YEAST_SMOKE_VERSION}/install.sh" -o install.sh
bash -n install.sh
YEAST_VERSION="${YEAST_SMOKE_VERSION}" bash install.sh
hash -r
yeast version
yeast doctor
cd "$YEAST_SMOKE_ROOT"

Updater Check

yeast update --check --version "${YEAST_SMOKE_VERSION}"
sudo yeast update --force --version "${YEAST_SMOKE_VERSION}"
hash -r
yeast version

Official Labs Check

git clone --depth 1 --branch "${YEAST_SMOKE_VERSION}" https://github.com/Twarga/yeast.git source
cd source
YEAST_BIN="$(command -v yeast)" bash scripts/smoke/tutorials.sh lab01
YEAST_BIN="$(command -v yeast)" bash scripts/smoke/tutorials.sh lab02
YEAST_BIN="$(command -v yeast)" bash scripts/smoke/tutorials.sh lab03
cd "$YEAST_SMOKE_ROOT"

Lab 02 must verify exact raw command output:

cloudinit-lab
yeast

Single VM Manual Check

mkdir -p vm-basic
cd vm-basic
yeast init --template ubuntu-basic
grep "sudo: nopasswd" yeast.yaml
yeast up
test -f "$HOME/.yeast/cache/update-check.json"
yeast status
yeast inspect web
test "$(yeast exec web -- whoami)" = "yeast"
yeast exec web -- hostname
printf 'yeast-smoke\n' > artifact.txt
yeast copy web --to-guest ./artifact.txt /home/yeast/artifact.txt
yeast copy web --from-guest /home/yeast/artifact.txt ./artifact-out.txt
diff -u artifact.txt artifact-out.txt
yeast down
yeast snapshot web baseline --description "v1.1.3 smoke baseline"
yeast up
yeast exec web -- touch /home/yeast/broken-marker
yeast down
yeast restore web baseline
yeast up
yeast exec web -- test ! -e /home/yeast/broken-marker
yeast down
yeast destroy --yes
cd "$YEAST_SMOKE_ROOT"

Two VM Networking Check

mkdir -p vm-network
cd vm-network
yeast init --template two-vm-lab
yeast up
yeast status
yeast exec attacker -- ping -c 2 10.10.10.20
yeast exec target -- ping -c 2 10.10.10.10
yeast status --json
yeast inspect attacker --json
yeast down
yeast destroy --yes

Pass Criteria

  • artifact download and checksum pass
  • tarball extracts yeast
  • installed version is v1.1.3
  • update path completes
  • yeast doctor has no blockers
  • yeast up creates the daily update-check cache
  • ubuntu-basic initializes with user: yeast and sudo: nopasswd
  • Lab 02 returns exact raw hostname and whoami outputs
  • single VM boots and accepts guest control
  • copy to/from guest works
  • snapshot/restore removes the marker file
  • two VMs can ping over the private lab network

The embedded terminal version is available with:

yeast docs release-smoke