Skip to content

tjl8787/mycodex-skills / skills/jstorcli-yatc-jetice-ops

jstorcli-yatc-jetice-ops

Flagged

Use when operating jstorcli with yatc and jetice/jetlake workflows, especially for VM lifecycle, image prep, deployment checks, and command lookup without hardcoded paths.

jstorcli + yatc + jetice/jetlake Ops

Overview

This skill is the first command reference for deployment and validation work involving jstorcli, yatc, jetice-env, and JetLake planes/profiles.

Use dynamic path discovery first. Do not hardcode project directories.

Environment Discovery

# Project root (prefer current repo root)
export YATC_ROOT="${YATC_ROOT:-$(git rev-parse --show-toplevel 2>/dev/null || pwd)}"

# Compose directory (first compose.yaml under repo, override when needed)
export YATC_COMPOSE_DIR="${YATC_COMPOSE_DIR:-$(find "$YATC_ROOT" -maxdepth 3 -type f -name compose.yaml -print -quit | xargs -r dirname)}"

# jstorcli source root (contains src/jstorcli/__main__.py)
export JSTORCLI_ROOT="${JSTORCLI_ROOT:-$(find "$YATC_ROOT" -type f -path '*/jstorcli/src/jstorcli/__main__.py' -print -quit | sed 's#/src/jstorcli/__main__.py##')}"
export JSTORCLI_SRC="${JSTORCLI_SRC:-$JSTORCLI_ROOT/src}"

# Optional image URL input for local mirror/download
export YATC_IMAGE_URL="${YATC_IMAGE_URL:-http://factory.jetio.net/artifactory/packer-os-images/jetice/ubuntu/ubuntu-22.04.5-jetice-uefi-2507.2-2-amd64-20250724.qcow2}"

yatc Build/Install/Deploy Flow

# 1) Build latest wheel
cd "$YATC_ROOT"
uv build

# 2) Install latest wheel to system python
sudo uv pip install --system "$(ls -t dist/*.whl | head -n 1)"

# 3) Register local images manifest (edit images.yaml path first)
sudo yatc images register -m "$YATC_ROOT/images.yaml"

# 4) Pull configured image name from images.yaml
sudo yatc pull ubuntu-22045-jetice

# 5) Start compose VM group
sudo yatc compose up --provider qemu --dir "$YATC_COMPOSE_DIR"

# 6) Check VM/IP
sudo yatc ps

# 7) Stop and remove compose resources when done
sudo yatc compose down --provider qemu --dir "$YATC_COMPOSE_DIR"
sudo yatc compose rm --dir "$YATC_COMPOSE_DIR"

jstorcli Current Command Surface

Source of truth:

  • src/jstorcli/__main__.py
  • each sub-CLI parser file

Top-level multiplexer:

  • jstorcli drbd (drbd-cli, drbd_cli)
  • jstorcli lvm (lvm-pool, lvm_pool for legacy)
  • jstorcli jetlake
  • jstorcli hagroup
  • jstorcli zfs
  • jstorcli bash-completion (bash-completetion alias exists in code)

DRBD

  • status
  • prepare
  • process
  • delete
  • adjust
  • primary
  • secondary

LVM

Group pool:

  • discover
  • define
  • create
  • delete
  • list
  • show

Group lv:

  • create
  • resize
  • delete
  • rename
  • snapshot
  • restore
  • rollback

Legacy lvm-pool also exposes:

  • discover, define, create, delete, list, show
  • lv-create, lv-resize, lv-delete, lv-rename
  • lv-snapshot, lv-restore, lv-rollback

JetLake

Group profile:

  • define
  • validate
  • create
  • destroy
  • undef

Group plane:

  • define
  • create
  • destroy
  • list
  • undef

HAGroup

  • define
  • update
  • create
  • get
  • list
  • delete
  • resolve

ZFS

Group pool:

  • list
  • info
  • create
  • delete

Group volume:

  • list
  • create
  • resize
  • delete
  • rename

Group snapshot:

  • create
  • delete
  • clone
  • rollback

Group profile:

  • define
  • list
  • show
  • validate
  • apply
  • init

Also:

  • send
  • receive

jetice-env Runtime Commands (inside VM)

jetice-env command family:

  • check
  • pull
  • config
  • reconf
  • init
  • compose
  • prep
  • verify
  • deploy
  • state
  • remove

Common VM validation:

cloud-init status
cd /opt/jetice-vtl
./jetice_s3gw_acceptance jetice s3gw http://0.0.0.0:9000

Recovery/Reset Operations

# Host key cleanup when VM IP changes
ssh-keygen -f ~/.ssh/known_hosts -R "192.168.122.2"

# Last-resort cleanup (destructive)
sudo rm -rf /opt/yatc/compute

Maintenance: Keep This Skill Updated

When jstorcli changes, refresh this skill in the same commit:

  1. Re-check parser definitions in:
    • src/jstorcli/__main__.py
    • src/jstorcli/*_cli.py
  2. Re-run help snapshots:
cd "$JSTORCLI_ROOT"
export PYTHONPATH="$JSTORCLI_SRC"
python3 -m jstorcli --help
python3 -m jstorcli.drbd_cli --help
python3 -m jstorcli.lvm_cli --help
python3 -m jstorcli.lvm_pool_cli --help
python3 -m jstorcli.jetlake_cli --help
python3 -m jstorcli.hagroup_cli --help
python3 -m jstorcli.zfs_cli --help
  1. Update this skill's command lists when any subcommand is added/removed/renamed.
  2. Keep path handling dynamic (YATC_ROOT, YATC_COMPOSE_DIR, JSTORCLI_ROOT) and avoid fixed absolute paths.
writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deploymentStars: 322kUpdated Claude CodeCodexVerifiedInstall
xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release.Stars: 118kUpdated Claude CodeCodexVerifiedInstall