cd7c2c4383
ci/woodpecker/tag/docker Pipeline was successful
## Why The mirrorlist (PR #121) always load-balances round-robin. Round-robin is oblivious to how busy each mirror is, so a slow or saturated mirror keeps getting its fair share of new requests. This adds an opt-in **least-connections** strategy that favors the mirror currently handling the fewest in-flight requests, steering new work toward idle mirrors. Round-robin stays the default, so existing remotes are unchanged. ## How - **Model**: `models.Remote` gains `mirror_strategy` (`round_robin` default/empty, or `least_conn`). `ValidateMirrorStrategy` checks the enum and requires a non-empty mirrorlist for `least_conn`. Empty behaves as `round_robin` for back-compat. - **DB**: additive `mirror_strategy TEXT NOT NULL DEFAULT 'round_robin'` column (CREATE TABLE + `ADD COLUMN IF NOT EXISTS`), wired through remoteCols/scanRemote/CreateRemote/UpdateRemote; empty normalized to `round_robin` on write. - **Engine**: a per-remote, per-pool-URL atomic in-flight gauge is incremented around each upstream call (head/fetch/checkUpstream). For a `least_conn` remote the attempt order starts with the least-loaded pool URL (ties broken by the existing round-robin rotation). Round-robin path and failover order are unchanged; single-URL pools are a no-op. - **Tests**: unit tests for least-loaded selection, round-robin default, gauge inc/dec, single-URL no-op, and validation; DB round-trip covers the new column; docker e2e adds a `least_conn` distribution test plus a real `dnf` install through a `least_conn` remote. Back-compat: unset/empty `mirror_strategy` is `round_robin`, so all existing remotes keep their current behavior. Reviewed-on: #122 Co-authored-by: unkin-agent <unkin-agent@unkin.net> Co-committed-by: unkin-agent <unkin-agent@unkin.net>
123 lines
4.5 KiB
Go
123 lines
4.5 KiB
Go
package database
|
|
|
|
import (
|
|
"context"
|
|
|
|
"git.unkin.net/unkin/artifactapi/pkg/models"
|
|
)
|
|
|
|
const remoteCols = `name, package_type, repo_type, base_url, mirrorlist, mirror_strategy, description, username, password,
|
|
immutable_ttl, mutable_ttl, check_mutable,
|
|
patterns, blocklist, mutable_patterns, immutable_patterns,
|
|
ban_tags_enabled, ban_tags,
|
|
quarantine_enabled, quarantine_days, stale_on_error,
|
|
releases_remote, managed_by,
|
|
upstream_dial_timeout, upstream_tls_timeout, upstream_response_header_timeout,
|
|
created_at, updated_at`
|
|
|
|
// normalizeMirrorStrategy maps an empty strategy to the round_robin default so
|
|
// the NOT NULL mirror_strategy column always stores a canonical value.
|
|
func normalizeMirrorStrategy(s string) string {
|
|
if s == "" {
|
|
return models.MirrorStrategyRoundRobin
|
|
}
|
|
return s
|
|
}
|
|
|
|
func scanRemote(scanner interface{ Scan(...any) error }, r *models.Remote) error {
|
|
return scanner.Scan(
|
|
&r.Name, &r.PackageType, &r.RepoType, &r.BaseURL, &r.Mirrorlist, &r.MirrorStrategy, &r.Description, &r.Username, &r.Password,
|
|
&r.ImmutableTTL, &r.MutableTTL, &r.CheckMutable,
|
|
&r.Patterns, &r.Blocklist, &r.MutablePatterns, &r.ImmutablePatterns,
|
|
&r.BanTagsEnabled, &r.BanTags,
|
|
&r.QuarantineEnabled, &r.QuarantineDays, &r.StaleOnError,
|
|
&r.ReleasesRemote, &r.ManagedBy,
|
|
&r.UpstreamDialTimeout, &r.UpstreamTLSTimeout, &r.UpstreamResponseHeaderTimeout,
|
|
&r.CreatedAt, &r.UpdatedAt,
|
|
)
|
|
}
|
|
|
|
func (db *DB) GetRemote(ctx context.Context, name string) (*models.Remote, error) {
|
|
row := db.Pool.QueryRow(ctx, `SELECT `+remoteCols+` FROM remotes WHERE name = $1`, name)
|
|
var r models.Remote
|
|
if err := scanRemote(row, &r); err != nil {
|
|
return nil, err
|
|
}
|
|
return &r, nil
|
|
}
|
|
|
|
func (db *DB) ListRemotes(ctx context.Context) ([]models.Remote, error) {
|
|
rows, err := db.Pool.Query(ctx, `SELECT `+remoteCols+` FROM remotes ORDER BY name`)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
defer rows.Close()
|
|
|
|
var remotes []models.Remote
|
|
for rows.Next() {
|
|
var r models.Remote
|
|
if err := scanRemote(rows, &r); err != nil {
|
|
return nil, err
|
|
}
|
|
remotes = append(remotes, r)
|
|
}
|
|
return remotes, rows.Err()
|
|
}
|
|
|
|
func (db *DB) CreateRemote(ctx context.Context, r *models.Remote) error {
|
|
_, err := db.Pool.Exec(ctx, `
|
|
INSERT INTO remotes (
|
|
name, package_type, repo_type, base_url, mirrorlist, description, username, password,
|
|
immutable_ttl, mutable_ttl, check_mutable,
|
|
patterns, blocklist, mutable_patterns, immutable_patterns,
|
|
ban_tags_enabled, ban_tags,
|
|
quarantine_enabled, quarantine_days, stale_on_error,
|
|
releases_remote, managed_by,
|
|
upstream_dial_timeout, upstream_tls_timeout, upstream_response_header_timeout,
|
|
mirror_strategy
|
|
) VALUES ($1,$2,$3,$4,$5,$6,$7,$8,$9,$10,$11,$12,$13,$14,$15,$16,$17,$18,$19,$20,$21,$22,$23,$24,$25,$26)
|
|
`,
|
|
r.Name, r.PackageType, r.RepoType, r.BaseURL, r.Mirrorlist, r.Description, r.Username, r.Password,
|
|
r.ImmutableTTL, r.MutableTTL, r.CheckMutable,
|
|
r.Patterns, r.Blocklist, r.MutablePatterns, r.ImmutablePatterns,
|
|
r.BanTagsEnabled, r.BanTags,
|
|
r.QuarantineEnabled, r.QuarantineDays, r.StaleOnError,
|
|
r.ReleasesRemote, r.ManagedBy,
|
|
r.UpstreamDialTimeout, r.UpstreamTLSTimeout, r.UpstreamResponseHeaderTimeout,
|
|
normalizeMirrorStrategy(r.MirrorStrategy),
|
|
)
|
|
return err
|
|
}
|
|
|
|
func (db *DB) UpdateRemote(ctx context.Context, r *models.Remote) error {
|
|
_, err := db.Pool.Exec(ctx, `
|
|
UPDATE remotes SET
|
|
package_type=$2, repo_type=$3, base_url=$4, mirrorlist=$25, description=$5, username=$6, password=$7,
|
|
immutable_ttl=$8, mutable_ttl=$9, check_mutable=$10,
|
|
patterns=$11, blocklist=$12, mutable_patterns=$13, immutable_patterns=$14,
|
|
ban_tags_enabled=$15, ban_tags=$16,
|
|
quarantine_enabled=$17, quarantine_days=$18, stale_on_error=$19,
|
|
releases_remote=$20, managed_by=$21,
|
|
upstream_dial_timeout=$22, upstream_tls_timeout=$23, upstream_response_header_timeout=$24,
|
|
mirror_strategy=$26,
|
|
updated_at=NOW()
|
|
WHERE name=$1
|
|
`,
|
|
r.Name, r.PackageType, r.RepoType, r.BaseURL, r.Description, r.Username, r.Password,
|
|
r.ImmutableTTL, r.MutableTTL, r.CheckMutable,
|
|
r.Patterns, r.Blocklist, r.MutablePatterns, r.ImmutablePatterns,
|
|
r.BanTagsEnabled, r.BanTags,
|
|
r.QuarantineEnabled, r.QuarantineDays, r.StaleOnError,
|
|
r.ReleasesRemote, r.ManagedBy,
|
|
r.UpstreamDialTimeout, r.UpstreamTLSTimeout, r.UpstreamResponseHeaderTimeout,
|
|
r.Mirrorlist,
|
|
normalizeMirrorStrategy(r.MirrorStrategy),
|
|
)
|
|
return err
|
|
}
|
|
|
|
func (db *DB) DeleteRemote(ctx context.Context, name string) error {
|
|
_, err := db.Pool.Exec(ctx, `DELETE FROM remotes WHERE name = $1`, name)
|
|
return err
|
|
}
|