alien-core 3.3.72

Deploy software into your customers' cloud accounts and keep it fully managed
Documentation
//! Release metadata for deployment version tracking.

use crate::Stack;
use serde::{Deserialize, Serialize};

/// A signed statement as it is stored and forwarded: the exact bytes that were
/// signed and the signatures over them. Carriers pass it through unchanged;
/// only enforcers verify it (see `alien-signing`).
pub use alien_signing::SignedStatement;

/// Release metadata
///
/// Identifies a specific release version and includes the stack definition.
/// The deployment engine uses this to track which release is currently deployed
/// and which is the target.
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
#[cfg_attr(feature = "openapi", derive(utoipa::ToSchema))]
#[serde(rename_all = "camelCase")]
pub struct ReleaseInfo {
    /// Release ID (e.g., rel_xyz). `None` for an observe deployment, which has no
    /// Alien-assigned release — the platform resolves a release from `version`.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub release_id: Option<String>,
    /// Version string (e.g., 2.1.0)
    #[serde(skip_serializing_if = "Option::is_none")]
    pub version: Option<String>,
    /// Short description of the release
    #[serde(skip_serializing_if = "Option::is_none")]
    pub description: Option<String>,
    /// Stack definition for this release
    pub stack: Stack,
    /// The developer's signed `release/v2` statement for this platform, when
    /// the release was signed. A protected deployment deploys only the stack
    /// inside it and ignores `stack`.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub signed: Option<SignedStatement>,
    /// The project's signer list chain, oldest first, carried with a signed
    /// release so the deployment can verify it.
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub signer_lists: Vec<SignedStatement>,
}