菜单
This skill should be used when the user asks to "install sandbox-cli", "setup sandbox", "configure sandbox-cli", "get sandbox-cli working", "download sandbox-cli", or "I don't have sandbox-cli installed".
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
This skill should be used when the user asks to "create a catalog", "build a common.yaml", "add a new RHDP lab", "set up a new catalog item", "create an AgnosticV catalog", "build a dev.yaml", "add a catalog entry", or "create a new lab catalog for RHDP".
This skill should be used when the user asks to "validate my catalog", "check my AgnosticV config", "review common.yaml", "validate my RHDP catalog", "check for errors in my catalog", "lint my AgnosticV files", or "verify my catalog before submitting".
This skill should be used when the user asks to "turn this lab into a blog post", "write a blog post from this module", "generate a blog from my Showroom content", "convert my workshop to a blog", "write a Red Hat Developer blog post", or "create a blog post from my demo".
This skill should be used when the user asks to "create a demo module", "write a Know/Show demo", "build a presenter demo", "create a Showroom demo", "write a facilitator guide", "build a demo script", or "create a presenter-led demo for RHDP".
This skill should be used when the user asks to "create a lab module", "write a workshop module", "build a Showroom lab", "convert docs to a lab", "write a hands-on exercise", "create an AsciiDoc module", or "turn this documentation into a lab exercise".
This skill should be used when the user asks to "write solve and validate playbooks", "add E2E testing to my lab", "generate solve.yml", "generate validate.yml", "add solve and validate buttons", "set up runtime automation", "add ZT grading to my lab", "set up load testing for my lab", "add Demolition grading", or "configure run_e2e_load_test".
| name | sandbox-cli:sandbox-setup |
| description | This skill should be used when the user asks to "install sandbox-cli", "setup sandbox", "configure sandbox-cli", "get sandbox-cli working", "download sandbox-cli", or "I don't have sandbox-cli installed". |
Name: Sandbox CLI Setup Description: Install and configure the sandbox-cli tool for managing OCP shared clusters via the RHDP Sandbox API.
Guide the user through installing sandbox-cli and authenticating with the Sandbox API. This skill handles platform detection, binary download, VPN verification, and initial login.
Determine the user's OS and architecture:
uname -s # Darwin or Linux
uname -m # arm64 or x86_64
Map to binary name:
sandbox-cli-darwin-arm64sandbox-cli-darwin-amd64sandbox-cli-linux-amd64sandbox-cli-linux-arm64which sandbox-cli && sandbox-cli version
If already installed, check if it's up to date by running sandbox-cli status and skip to Step 4.
Download the latest release from GitHub:
# Get latest release URL
PLATFORM="darwin-arm64" # adjust based on Step 1
curl -sL "https://github.com/rhpds/sandbox/releases/latest/download/sandbox-cli-${PLATFORM}" -o /usr/local/bin/sandbox-cli
chmod +x /usr/local/bin/sandbox-cli
If /usr/local/bin requires sudo, suggest:
curl -sL "https://github.com/rhpds/sandbox/releases/latest/download/sandbox-cli-${PLATFORM}" -o ~/bin/sandbox-cli
chmod +x ~/bin/sandbox-cli
# Ensure ~/bin is in PATH
Verify installation:
sandbox-cli version
CRITICAL: The sandbox API is IP-restricted. The user MUST be on Red Hat VPN. Always verify VPN connectivity before any sandbox-cli operation.
Run this check:
host squid.redhat.com
If the DNS resolves (returns an IP address like 10.x.x.x), the user is on VPN. Proceed.
If it fails with NXDOMAIN, not found, or connection timed out, the user is NOT on VPN. Stop and tell them:
You are NOT connected to the Red Hat VPN. The sandbox API is IP-restricted and all commands will fail with EOF errors. Please connect to the Red Hat VPN before proceeding.
Do NOT proceed with login or any sandbox-cli commands until VPN is confirmed.
Ask the user for:
https://restricted-babylon-sandbox-api.apps.infra-us-east-1.infra.demo.redhat.com)Then run:
sandbox-cli login --server <SERVER_URL> --token <TOKEN>
Expected output on success:
Authenticating with <SERVER_URL>...
Using Red Hat VPN proxy (squid.redhat.com:3128)
Login successful. Access token saved to ~/.local/sandbox-cli/config.json
Token expires: <date>
If you get an EOF error, the VPN check in Step 4 may have given a false positive. Ask the user to verify their VPN connection and retry.
sandbox-cli status
This shows client version, server connection, proxy status, and authentication state.
| Error | Cause | Fix |
|---|---|---|
EOF error on login | Not on VPN | Connect to Red Hat VPN, verify with host squid.redhat.com |
authentication failed | Invalid or expired token | Get a new token from a sandbox admin |
command not found | Binary not in PATH | Check install location and PATH |
permission denied | Binary not executable | Run chmod +x /path/to/sandbox-cli |
~/.local/sandbox-cli/config.jsonsquid.redhat.com:3128)