Sign in
LinkMablnet

Force a channel's current version — rollback / pin (operator)

Republishes an already-stored version as the channel's current — the rollback / pinning primitive. By default the forced version inherits a staged rollout; pass a single-stage rollout_schedule of [{percent: 100, since_ms: 0}] for an immediate fleet-wide swap. Operator-only. See design doc § Operator commands.

put/link/mablnet/artifacts/{artifact}/channels/{channel}/current

Path parameters

artifactstring required

Release artifact the channel belongs to: mablnet-host (the worker binary) or link-agent (the Java Link Agent bundle). Channels are namespaced per artifact, so stable for one artifact is unrelated to stable for another.

channelstring required

Channel whose current version is being forced.

Request body

versionstring required

The already-stored release version to make current on this channel.

Response

Updated rollout state for the channel.

idstring

Datastore key for this entity — <artifact>/<channel> (one entity per artifact + channel). Server-set.

artifactstring required

Release artifact this state governs (mablnet-host, link-agent).

channelstring required

Release channel this state governs, within artifact.

current_versionstring required

The version being rolled out to (Hosts inside the rolled-out percentage receive this).

fallback_versionstring

What Hosts not yet inside the rollout receive. Unset once a rollout reaches 100% and the current version is fully rolled out.

force_percentinteger

When set, overrides the time-based schedule with an explicit rolled-out percentage (operator force-advance). Cleared by resuming the schedule.

published_atstring date-time

When the current rollout started; the schedule's since_ms offsets are relative to this.

pausedboolean required

When true, the manifest endpoint stops advancing the rollout — Hosts stay on whichever version they have.

Changes

Changed in 1 of the 32 revisions of this API.1