Documentation
¶
Overview ¶
Package postgres provides a PostgreSQL implementation of the Bastion composite store using grove ORM with programmatic migrations.
Index ¶
- Variables
- type Store
- func (s *Store) Allow(ctx context.Context, key string, limit float64, burst int, _ time.Duration) (bool, error)
- func (s *Store) Close() error
- func (s *Store) Delete(ctx context.Context, key string) error
- func (s *Store) DeleteRoute(ctx context.Context, routeID string) error
- func (s *Store) DeleteState(ctx context.Context, targetID string) error
- func (s *Store) Get(ctx context.Context, key string) ([]byte, error)
- func (s *Store) GetHistory(ctx context.Context, targetID string, limit int) ([]bastion.HealthCheckResult, error)
- func (s *Store) GetLatestState(ctx context.Context, targetID string) (*bastion.HealthCheckResult, error)
- func (s *Store) GetRoute(ctx context.Context, routeID string) (*bastion.Route, error)
- func (s *Store) GetState(ctx context.Context, targetID string) (*bastion.CircuitBreakerSnapshot, error)
- func (s *Store) ListRoutes(ctx context.Context) ([]*bastion.Route, error)
- func (s *Store) ListStates(ctx context.Context) ([]*bastion.CircuitBreakerSnapshot, error)
- func (s *Store) Migrate(ctx context.Context) error
- func (s *Store) Ping(ctx context.Context) error
- func (s *Store) RecordCheck(ctx context.Context, result *bastion.HealthCheckResult) error
- func (s *Store) SaveRoute(ctx context.Context, route *bastion.Route) error
- func (s *Store) SaveState(ctx context.Context, snap *bastion.CircuitBreakerSnapshot) error
- func (s *Store) Set(ctx context.Context, key string, value []byte, ttl time.Duration) error
- func (s *Store) Write(ctx context.Context, event *bastion.AuditEvent) error
Constants ¶
This section is empty.
Variables ¶
View Source
var Migrations = func() *migrate.Group { g := migrate.NewGroup("bastion") g.MustRegister( &migrate.Migration{ Name: "create_routes", Version: "20240101000001", Comment: "Create bastion_routes table", Up: func(ctx context.Context, exec migrate.Executor) error { _, err := exec.Exec(ctx, ` CREATE TABLE IF NOT EXISTS bastion_routes ( id TEXT PRIMARY KEY, path TEXT NOT NULL, methods JSONB DEFAULT '[]', targets JSONB DEFAULT '[]', strip_prefix BOOLEAN DEFAULT FALSE, add_prefix TEXT DEFAULT '', rewrite_path TEXT DEFAULT '', headers JSONB DEFAULT '{}', protocol TEXT DEFAULT 'http', source TEXT DEFAULT 'manual', service_name TEXT DEFAULT '', priority INTEGER DEFAULT 0, version BIGINT DEFAULT 0, enabled BOOLEAN DEFAULT TRUE, retry JSONB, timeout JSONB, rate_limit JSONB, auth JSONB, circuit_breaker JSONB, cache JSONB, traffic_policy JSONB, transform JSONB, metadata JSONB DEFAULT '{}', created_at TIMESTAMPTZ NOT NULL DEFAULT CURRENT_TIMESTAMP, updated_at TIMESTAMPTZ NOT NULL DEFAULT CURRENT_TIMESTAMP ); CREATE INDEX IF NOT EXISTS idx_bastion_routes_path ON bastion_routes (path); CREATE INDEX IF NOT EXISTS idx_bastion_routes_source ON bastion_routes (source); `) return err }, Down: func(ctx context.Context, exec migrate.Executor) error { _, err := exec.Exec(ctx, `DROP TABLE IF EXISTS bastion_routes CASCADE`) return err }, }, &migrate.Migration{ Name: "create_circuit_breaker_states", Version: "20240101000002", Comment: "Create bastion_circuit_breaker_states table", Up: func(ctx context.Context, exec migrate.Executor) error { _, err := exec.Exec(ctx, ` CREATE TABLE IF NOT EXISTS bastion_circuit_breaker_states ( target_id TEXT PRIMARY KEY, state TEXT NOT NULL DEFAULT 'closed', failure_count INTEGER DEFAULT 0, success_count INTEGER DEFAULT 0, last_failure TIMESTAMPTZ, last_state_change TIMESTAMPTZ, updated_at TIMESTAMPTZ NOT NULL DEFAULT CURRENT_TIMESTAMP ); `) return err }, Down: func(ctx context.Context, exec migrate.Executor) error { _, err := exec.Exec(ctx, `DROP TABLE IF EXISTS bastion_circuit_breaker_states`) return err }, }, &migrate.Migration{ Name: "create_health_checks", Version: "20240101000003", Comment: "Create bastion_health_checks table", Up: func(ctx context.Context, exec migrate.Executor) error { _, err := exec.Exec(ctx, ` CREATE TABLE IF NOT EXISTS bastion_health_checks ( id BIGSERIAL PRIMARY KEY, target_id TEXT NOT NULL, target_url TEXT DEFAULT '', healthy BOOLEAN NOT NULL, latency_ns BIGINT DEFAULT 0, error TEXT DEFAULT '', checked_at TIMESTAMPTZ NOT NULL DEFAULT CURRENT_TIMESTAMP ); CREATE INDEX IF NOT EXISTS idx_bastion_health_target_time ON bastion_health_checks (target_id, checked_at DESC); `) return err }, Down: func(ctx context.Context, exec migrate.Executor) error { _, err := exec.Exec(ctx, `DROP TABLE IF EXISTS bastion_health_checks`) return err }, }, &migrate.Migration{ Name: "create_audit_events", Version: "20240101000004", Comment: "Create bastion_audit_events table", Up: func(ctx context.Context, exec migrate.Executor) error { _, err := exec.Exec(ctx, ` CREATE TABLE IF NOT EXISTS bastion_audit_events ( id BIGSERIAL PRIMARY KEY, action TEXT NOT NULL, actor TEXT DEFAULT '', resource TEXT DEFAULT '', detail JSONB DEFAULT '{}', result TEXT DEFAULT '', error TEXT DEFAULT '', created_at TIMESTAMPTZ NOT NULL DEFAULT CURRENT_TIMESTAMP ); CREATE INDEX IF NOT EXISTS idx_bastion_audit_time ON bastion_audit_events (created_at DESC); `) return err }, Down: func(ctx context.Context, exec migrate.Executor) error { _, err := exec.Exec(ctx, `DROP TABLE IF EXISTS bastion_audit_events`) return err }, }, &migrate.Migration{ Name: "create_cache_entries", Version: "20240101000005", Comment: "Create bastion_cache_entries table", Up: func(ctx context.Context, exec migrate.Executor) error { _, err := exec.Exec(ctx, ` CREATE TABLE IF NOT EXISTS bastion_cache_entries ( key TEXT PRIMARY KEY, value BYTEA NOT NULL, expires_at TIMESTAMPTZ NOT NULL ); CREATE INDEX IF NOT EXISTS idx_bastion_cache_expires ON bastion_cache_entries (expires_at); `) return err }, Down: func(ctx context.Context, exec migrate.Executor) error { _, err := exec.Exec(ctx, `DROP TABLE IF EXISTS bastion_cache_entries`) return err }, }, &migrate.Migration{ Name: "create_rate_limits", Version: "20240101000006", Comment: "Create bastion_rate_limits table", Up: func(ctx context.Context, exec migrate.Executor) error { _, err := exec.Exec(ctx, ` CREATE TABLE IF NOT EXISTS bastion_rate_limits ( key TEXT PRIMARY KEY, tokens DOUBLE PRECISION NOT NULL DEFAULT 0, last_time TIMESTAMPTZ NOT NULL DEFAULT CURRENT_TIMESTAMP ); `) return err }, Down: func(ctx context.Context, exec migrate.Executor) error { _, err := exec.Exec(ctx, `DROP TABLE IF EXISTS bastion_rate_limits`) return err }, }, ) return g }()
Migrations is the grove migration group for the Bastion postgres store.
Functions ¶
This section is empty.
Types ¶
type Store ¶
type Store struct {
// contains filtered or unexported fields
}
Store is a PostgreSQL implementation of the composite Bastion store.
func (*Store) GetHistory ¶
func (*Store) GetLatestState ¶
func (*Store) ListRoutes ¶
func (*Store) ListStates ¶
func (*Store) RecordCheck ¶
Click to show internal directories.
Click to hide internal directories.