Skip to content

Infra Playbooks

Escenarios: 27

INFRA

Apply Dry Run Profile Source Multipass

Show the local `multipass` apply path in dry-run mode from the source-oriented Infra workflow.

cd productive-k3s-infra
PRODUCTIVE_K3S_PROFILES_REPO_DIR=../productive-k3s-profiles \
  bash ./productive-k3s-infra.sh apply --dry-run --profile ../productive-k3s-profiles/profiles/local/multipass/1-server-2-agents.env
INFRA

Apply Dry Run Profile Source Onprem Basic

Preview the source-based `onprem-basic` apply path in dry-run mode.

cd productive-k3s-infra
PRODUCTIVE_K3S_PROFILES_REPO_DIR=../productive-k3s-profiles \
  bash ./productive-k3s-infra.sh apply --profile ../productive-k3s-profiles/profiles/edge/on-prem/basic.env --dry-run
INFRA

Artifact Review Exported Multipass K3sup

Export a source-based `multipass` installer bundle with `PRODUCTIVE_K3S_ENGINE=k3sup` and inspect the resulting artifact layout plus embedded `profile.env`.

cd productive-k3s-infra
set -euo pipefail;
rm -rf "/tmp/infra-export";
PRODUCTIVE_K3S_PROFILES_REPO_DIR="../productive-k3s-profiles" PRODUCTIVE_K3S_ENGINE=k3sup bash ./productive-k3s-infra.sh export --profile "../productive-k3s-profiles/profiles/local/multipass/1-server-2-agents.env" --output "/tmp/infra-export" >/dev/null;
find "/tmp/infra-export" -maxdepth 2 -type f | sort;
printf '\n';
printf '%s\n' '--- profile.tgz entries ---';
tar -tzf "/tmp/infra-export/profile.tgz" | sort;
printf '\n';
printf '%s\n' '--- embedded profile.env ---';
tar -xOf "/tmp/infra-export/profile.tgz" ./profile.env
INFRA

Bundle Info And Bom

Inspect the Infra CLI/runtime metadata and bill of materials from a local `productive-k3s-infra` checkout.

cd productive-k3s-infra
bash -lc './productive-k3s-infra.sh bundle info --json && printf "\n" && ./productive-k3s-infra.sh bom --json'
INFRA

Cluster Up Source Multipass

Run the source-based `multipass` cluster bootstrap phase from the sibling `productive-k3s-profiles` checkout.

cd productive-k3s-profiles/scenarios/local/multipass
make cluster-up
INFRA

Destroy Profile Packaged AWS Single Node

Destroy the package-first `aws-single-node` runtime through the public Infra profile lifecycle.

cd productive-k3s-infra
bash ./productive-k3s-infra.sh profile destroy \
  --tgz "$PRODUCTIVE_K3S_INFRA_PLAYBOOK_PROFILE_TGZ" \
  --env-file "$PRODUCTIVE_K3S_INFRA_PLAYBOOK_ENV_FILE"
INFRA

Destroy Profile Packaged Onprem Basic Rejected

Show the explicit public guardrail that packaged `onprem-basic` does not support `destroy`.

cd productive-k3s-infra
./productive-k3s-infra.sh profile destroy --tgz /abs/path/to/on-prem-basic-profile.tgz
INFRA

Doctor Basic

Run the shortest local operator-facing environment sanity check for `productive-k3s-infra`.

cd productive-k3s-infra
PRODUCTIVE_K3S_PROFILES_REPO_DIR=../productive-k3s-profiles bash ./productive-k3s-infra.sh doctor
INFRA

Doctor Without Profiles Warning

Run the explicit warning path for `productive-k3s-infra doctor` without wiring the sibling `productive-k3s-profiles` checkout.

cd productive-k3s-infra
env -u PRODUCTIVE_K3S_PROFILES_REPO_DIR bash ./productive-k3s-infra.sh doctor
INFRA

Down Source Multipass

Destroy the source-based `multipass` scenario VMs through the sibling `productive-k3s-profiles` checkout.

cd productive-k3s-profiles/scenarios/local/multipass
make down
INFRA

Export Profile Packaged Multipass

Export a packaged `multipass` `profile.tgz` into a self-contained installer bundle.

cd productive-k3s-infra
./productive-k3s-infra.sh profile export \
  --tgz /abs/path/to/multipass-profile.tgz \
  --output /tmp/multipass-installer
INFRA

Export Profile Source Multipass

Export the source `multipass` profile into a self-contained installer bundle.

cd productive-k3s-infra
PRODUCTIVE_K3S_PROFILES_REPO_DIR=../productive-k3s-profiles \
  bash ./productive-k3s-infra.sh export \
    --profile ../productive-k3s-profiles/profiles/local/multipass/1-server-2-agents.env \
    --output /tmp/infra-source-export
INFRA

Export Profile Source Multipass K3sup

Export the source-based `multipass` profile into a self-contained installer bundle while forcing `PRODUCTIVE_K3S_ENGINE=k3sup`.

cd productive-k3s-infra
PRODUCTIVE_K3S_PROFILES_REPO_DIR=../productive-k3s-profiles \
PRODUCTIVE_K3S_ENGINE=k3sup \
  bash ./productive-k3s-infra.sh export --profile ../productive-k3s-profiles/profiles/local/multipass/1-server-2-agents.env --output /tmp/infra-k3sup-export
INFRA

Exported Installer Replay Multipass

Run the strongest current end-to-end proof for the Infra exported installer contract on the `multipass` profile.

cd productive-k3s-infra
PRODUCTIVE_K3S_PROFILES_REPO_DIR=../productive-k3s-profiles \
  bash ./tests/test-profile-export-artifact.sh
INFRA

List Profiles Source

List the curated source profiles currently visible to Infra from the sibling `productive-k3s-profiles` checkout.

cd productive-k3s-infra
PRODUCTIVE_K3S_PROFILES_REPO_DIR=../productive-k3s-profiles \
  bash ./productive-k3s-infra.sh list-profiles
INFRA

Plan Profile Packaged AWS Single Node

Preview the package-first OpenTofu plan for an `aws-single-node` `profile.tgz`.

cd productive-k3s-infra
bash ./productive-k3s-infra.sh profile plan \
  --tgz "$PRODUCTIVE_K3S_INFRA_PLAYBOOK_PROFILE_TGZ" \
  --env-file "$PRODUCTIVE_K3S_INFRA_PLAYBOOK_ENV_FILE"
INFRA

Plan Profile Packaged Multipass

Preview the package-first OpenTofu plan for a packaged `multipass` `profile.tgz`.

cd productive-k3s-infra
./productive-k3s-infra.sh profile plan --tgz /abs/path/to/multipass-profile.tgz
INFRA

Plan Profile Source Multipass

Preview the local `multipass` infrastructure plan from the source-oriented Infra workflow.

cd productive-k3s-infra
PRODUCTIVE_K3S_PROFILES_REPO_DIR=../productive-k3s-profiles \
  bash ./productive-k3s-infra.sh plan --profile ../productive-k3s-profiles/profiles/local/multipass/1-server-2-agents.env
INFRA

Plan Profile Source Multipass K3sup

Preview the source-based `multipass` plan while forcing `PRODUCTIVE_K3S_ENGINE=k3sup`.

cd productive-k3s-infra
PRODUCTIVE_K3S_PROFILES_REPO_DIR=../productive-k3s-profiles \
PRODUCTIVE_K3S_ENGINE=k3sup \
  bash ./productive-k3s-infra.sh plan --profile ../productive-k3s-profiles/profiles/local/multipass/1-server-2-agents.env
INFRA

Plan Profile Source Onprem Basic

Preview the source-based `onprem-basic` plan through the profile-driven Infra CLI.

cd productive-k3s-infra
PRODUCTIVE_K3S_PROFILES_REPO_DIR=../productive-k3s-profiles \
  bash ./productive-k3s-infra.sh plan --profile ../productive-k3s-profiles/profiles/edge/on-prem/basic.env
INFRA

Preflight Source Onprem Basic

Run the source-based `onprem-basic` preflight path through the profile-driven Infra CLI.

cd productive-k3s-profiles/scenarios/edge/onprem-basic
make preflight \
  ONPREM_ENV_FILE=/abs/path/to/onprem.env
INFRA

Status Profile Packaged Multipass

Show the packaged runtime status for a `multipass` `profile.tgz` after a prior package-first plan or install.

cd productive-k3s-infra
bash ./productive-k3s-infra.sh profile status --tgz "$PRODUCTIVE_K3S_INFRA_PLAYBOOK_PROFILE_TGZ"
INFRA

Status Source Multipass

Re-render and print the source-based `multipass` generated cluster metadata.

cd productive-k3s-profiles/scenarios/local/multipass
make status
INFRA

Validate Profile Packaged AWS Single Node

Validate a packaged `aws-single-node` `profile.tgz` through the public Infra runtime surface.

cd productive-k3s-infra
bash ./productive-k3s-infra.sh profile validate --tgz "$PRODUCTIVE_K3S_INFRA_PLAYBOOK_PROFILE_TGZ"
INFRA

Validate Profile Packaged Multipass

Validate a packaged `multipass` `profile.tgz` through the public Infra runtime surface.

cd productive-k3s-infra
./productive-k3s-infra.sh profile validate --tgz /abs/path/to/multipass-profile.tgz
INFRA

Validate Profile Source Multipass

Validate the public local `multipass` source profile contract from the sibling `productive-k3s-profiles` checkout.

cd productive-k3s-infra
PRODUCTIVE_K3S_PROFILES_REPO_DIR=../productive-k3s-profiles \
  bash ./productive-k3s-infra.sh validate-profile --profile ../productive-k3s-profiles/profiles/local/multipass/1-server-2-agents.env
INFRA

Validate Profile Source Onprem Basic

Validate the public `onprem-basic` source profile contract from the sibling `productive-k3s-profiles` checkout.

cd productive-k3s-infra
PRODUCTIVE_K3S_PROFILES_REPO_DIR=../productive-k3s-profiles \
  bash ./productive-k3s-infra.sh validate-profile --profile ../productive-k3s-profiles/profiles/edge/on-prem/basic.env