Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Unified migration CLI

Aperta
  • Qualcosa non va?
#675 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
5/5
Tempo stimato
Più di una settimana
Idoneità per principianti
25/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Ferma
Stack tecnologico
go, kubernetes, redis, sql
Ambito
cli, databases

Direzione di ricerca

Start by reading the existing migratesql commands and the outpost-migrate-redis CLI to understand their entry points and migration workflows. Then map how startup currently triggers SQL migrations and how Redis migrations are planned and applied. Done means one outpost migrate interface can list, plan, apply, and verify both migration types, with startup behavior matching the stated explicit-control goal.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

enhancement

Current State

Two Separate Migration Systems

SQL Migrations

  • Runs automatically at application startup
  • Uses golang-migrate
  • Commands: migratesql up, migratesql down, migratesql force
  • No plan/preview capability
  • No manual control - just happens on boot

Redis Migrations

  • Separate binary: outpost-migrate-redis
  • Must be run manually before deployment
  • Requires maintenance window
  • Commands: list, plan, apply, verify, cleanup, unlock
  • Full plan/preview capability

The Problem: Two Different Experiences

Different Mental Models
Aspect SQL Redis
When to run "It just happens" "I need to run this manually"
Visibility Hidden in startup logs Explicit CLI output
Planning Can't preview changes plan shows exactly what will change
Verification Hope it worked verify confirms success
Recovery Dig through logs, use force Clear unlock command
Different Commands
# SQL - minimal interface
migratesql up
migratesql down 1
migratesql force 3

# Redis - full interface  
outpost-migrate-redis list
outpost-migrate-redis plan
outpost-migrate-redis apply --yes
outpost-migrate-redis verify
outpost-migrate-redis cleanup
outpost-migrate-redis unlock
Different Deployment Workflows

SQL: No action needed - migrations run on app startup

# Just deploy, migrations happen automatically
kubectl apply -f deployment.yaml

Redis: Requires explicit step before deployment

# 1. Run migration job (maintenance window)
kubectl apply -f migration-job.yaml
kubectl wait --for=condition=complete job/outpost-migrate-redis

# 2. Then deploy
kubectl apply -f deployment.yaml
Cognitive Overhead

Users must understand:

  1. There are two migration systems
  2. They work differently
  3. They have different commands
  4. They require different operational procedures
  5. One is automatic, one is manual

End Goal

Unified experience:

outpost migrate list      # Shows ALL migrations (SQL + Redis)
outpost migrate plan      # Shows what WILL change
outpost migrate apply     # Applies ALL pending migrations
outpost migrate verify    # Verifies success

Explicit control:

  • No auto-run at startup
  • Application refuses to start if migrations are pending
  • User explicitly runs outpost migrate apply before deployment

Single workflow:

# 1. Run migrations (same command regardless of what's pending)
outpost migrate apply --yes

# 2. Deploy application
outpost serve
Lingua principale
Go
Stelle
1.1k
Fork
70
Merge medio
1g 18h
PR unite (30g)
56

Preparare l'ambiente

Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di hookdeck/outpost

Tutte le issue di hookdeck/outpost

Issue simili

Altre issue su Go

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.