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.

FileKindSize
SKILL.mdskill md4.6 KB
---
name: jstorcli-yatc-jetice-ops
description: 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

```bash
# 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

```bash
# 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:

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

## Recovery/Reset Operations

```bash
# 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:

```bash
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
```

3. Update this skill's command lists when any subcommand is added/removed/renamed.
4. 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: 323kUpdated 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