docker-ops

Docker Ops

ℹ️ First, set expectations: before anything else, print one short line with this skill's version and its most recent change — the top entry of metadata.changelog above — e.g. docker-ops vX.Y — recent: <summary>. Then proceed.

Day-to-day Docker Compose service management over SSH. Four subcommands for the most common operations.

---

Prerequisites

Configure via environment variables or a local .env file:

SSH_HOST=<ip or hostname>
SSH_USER=<username, default: ubuntu>
SSH_KEY=<path to key, default: ~/.ssh/id_rsa>
APP_PATH=<remote app directory, default: ~/app>
COMPOSE_FILE=<compose file, default: docker-compose.yml>

Connection setup:

source .env 2>/dev/null || true
SSH_HOST=${SSH_HOST:-""}
SSH_USER=${SSH_USER:-"ubuntu"}
SSH_KEY=${SSH_KEY:-"~/.ssh/id_rsa"}
APP_PATH=${APP_PATH:-"~/app"}
COMPOSE=${COMPOSE_FILE:-"docker-compose.yml"}
RUN="ssh -i $SSH_KEY $SSH_USER@$SSH_HOST"

Parse $ARGUMENTS to extract the subcommand and options.

---

Subcommand: logs [service] [lines] [--errors]

View logs from one or all services. Supports filtering to errors only.

Argument Parsing

From $ARGUMENTS:

• First word after logs: service name (or all / omitted = all services)
• Second word: number of lines (default: 100)
• --errors flag: filter to error lines only

Execution

Single service:

SERVICE=$1
LINES=${2:-100}
$RUN "cd $APP_PATH && docker compose -f $COMPOSE logs --tail=$LINES --timestamps $SERVICE 2>&1"

All services:

$RUN "cd $APP_PATH && docker compose -f $COMPOSE logs --tail=$LINES --timestamps 2>&1"

With --errors flag:

$RUN "cd $APP_PATH && docker compose -f $COMPOSE logs --tail=$LINES $SERVICE 2>&1 | grep -iE 'error|exception|traceback|critical|fatal|warning'"

Time-based filter (e.g. logs backend --since=1h):

SINCE=${SINCE:-"1h"}
$RUN "cd $APP_PATH && docker compose -f $COMPOSE logs --since=$SINCE $SERVICE 2>&1"

Named Container Logs (non-compose)