Struct Deployments 

pub struct Deployments { /* private fields */ }

Handle to the deployments system, wrapping a DatabaseConnection.

All methods bind caller-supplied strings as Value::* parameters — no string interpolation (T-186-04).

Implementations

impl Deployments

pub fn new(db: DatabaseConnection) -> Self

Create a new Deployments handle backed by db.

pub async fn create( &self, owner_key: &str, source_ref: Option<&str>, ) -> Result<Deployment, Error>

Insert a new deployment row with status building.

Returns the complete Deployment row including its assigned id.

pub async fn mark_ready( &self, id: i64, artifact_location: &str, byte_size: i64, ) -> Result<(), Error>

Transition a building deployment to ready, recording the artifact location and byte size.

Returns Err when the row does not exist or is already in a terminal state (ready or failed).

pub async fn mark_failed(&self, id: i64, error: &str) -> Result<(), Error>

Transition a building deployment to failed.

The error message is emitted as a tracing warning (no error column in the schema). Returns Err when the row does not exist or is already terminal.

pub async fn get(&self, id: i64) -> Result<Deployment, Error>

Fetch a deployment by its primary key.

pub async fn list(&self, owner_key: &str) -> Result<Vec<Deployment>, Error>

List all deployments for owner_key, newest first.

pub async fn active(&self, owner_key: &str) -> Result<Option<Deployment>, Error>

Return the currently-active deployment for owner_key, or None when no pointer row exists yet.

pub async fn promote( &self, owner_key: &str, deployment_id: i64, ) -> Result<Option<i64>, Error>

Atomically promote deployment_id to be the active deployment for owner_key.

Guards:

• Error::NotReady when the deployment status is not ready.
• Error::ArtifactDeleted when artifact_deleted_at is set.

Returns the previously-active deployment id, or None when this is the first promotion.

pub async fn rollback(&self, owner_key: &str) -> Result<Option<i64>, Error>

Roll back to the previous deployment.

Returns Err(Error::NoPreviousDeployment) when the pointer row has no previous_deployment_id.

Trait Implementations

impl Clone for Deployments

fn clone(&self) -> Deployments

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.