Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

Unified migration CLI

オープン
#675 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
25/100
issue の種類
機能追加
明瞭さ
おおむね明確
活発さ
停滞
技術スタック
go, kubernetes, redis, sql
領域
cli, databases

調査の方向性

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.

索引モデルが issue の本文から書いたものです。

説明

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
主要言語
Go
スター
1.1k
フォーク
70
平均マージ
1日 18時間
マージ済み PR(30日)
56

環境構築

このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

hookdeck/outpost のほかの issue

hookdeck/outpost の issue をすべて見る

似ている issue

Go の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。