Nex Deploy Script Pattern

Professional Deployment Management for Debian and Raspberry Pi

Ship code with confidence to your home server or production VPS. This skill generates a staged, production-grade deployment package designed for complex applications that require more than a simple file copy. It automates the "Phase" approach used by professional DevOps engineers to ensure every deployment is safe, verified, and reversible.

What it does

The skill produces a structured deployment directory containing deploy.sh and rollback.sh scripts customized for your specific stack. It handles the heavy lifting of sequential operations:

• Phase 0 (Atomic Backup): Creates a timestamped full backup of your project directory before any changes.
• Phase 1 (Database Migrations): Runs SQL migrations against your database container.
• Phase 2 (Build & Rebuild): Manages Docker Compose builds or frontend npm compilation.
• Phase 3 (Service Restart): Safely restarts Docker services or Systemd units.
• Phase 4 (Health & Smoke Tests): Polls health endpoints and verifies specific URLs before declaring victory.

Why developer's use it

While a simple docker compose up might work for demos, this skill provides a safety net. If a migration fails or a build errors out, the script aborts immediately thanks to set -euo pipefail, leaving your live environment untouched. It eliminates the "it worked in dev but broke on the Pi" anxiety by adding automated verification and a ready-to-fire rollback command.

Supported Environments

Works on any Debian-based system (Ubuntu, Raspberry Pi OS). Supports Docker Compose stacks and traditional Systemd service architectures.

Built by Nex AI. More skills and info at nex-ai.be and slopsome.com.