Struct Container 

pub struct Container {

    pub id: String,
    pub links: Vec<ResourceRef>,
    pub ports: Vec<ContainerPort>,
    pub cluster: Option<String>,
    pub code: ContainerCode,
    pub cpu: ResourceSpec,
    pub memory: ResourceSpec,
    pub gpu: Option<ContainerGpuSpec>,
    pub ephemeral_storage: Option<String>,
    pub persistent_storage: Option<PersistentStorage>,
    pub replicas: Option<u32>,
    pub autoscaling: Option<ContainerAutoscaling>,
    pub stateful: bool,
    pub environment: HashMap<String, String>,
    pub pool: Option<String>,
    pub permissions: String,
    pub health_check: Option<HealthCheck>,
    pub command: Option<Vec<String>>,
}

Container resource for running long-running container workloads.

A Container defines a deployable unit that runs on a ContainerCluster. Horizon handles scheduling replicas across machines, autoscaling based on various metrics, and service discovery.

Example

use alien_core::{Container, ContainerCode, ResourceSpec, ContainerAutoscaling, ContainerPort, ExposeProtocol};

let container = Container::new("api".to_string())
    .cluster("compute".to_string())
    .code(ContainerCode::Image {
        image: "myapp:latest".to_string(),
    })
    .cpu(ResourceSpec { min: "0.5".to_string(), desired: "1".to_string() })
    .memory(ResourceSpec { min: "512Mi".to_string(), desired: "1Gi".to_string() })
    .port(8080)
    .expose_port(8080, ExposeProtocol::Http)
    .autoscaling(ContainerAutoscaling {
        min: 2,
        desired: 3,
        max: 10,
        target_cpu_percent: Some(70.0),
        target_memory_percent: None,
        target_http_in_flight_per_replica: Some(100),
        max_http_p95_latency_ms: None,
    })
    .permissions("container-execution".to_string())
    .build();

Fields

id: String

Unique identifier for the container. Must be DNS-compatible: lowercase alphanumeric with hyphens.

links: Vec<ResourceRef>

Resource links (dependencies)

ports: Vec<ContainerPort>

Container ports to expose (at least one required)

cluster: Option<String>

ContainerCluster resource ID that this container runs on. If None, will be auto-assigned by ContainerClusterMutation at deployment time.

code: ContainerCode

Container code (image or source)

cpu: ResourceSpec

CPU resource requirements

memory: ResourceSpec

Memory resource requirements (must use Ki/Mi/Gi/Ti suffix)

gpu: Option<ContainerGpuSpec>

GPU requirements (optional)

ephemeral_storage: Option<String>

Ephemeral storage requirement (e.g., “10Gi”)

persistent_storage: Option<PersistentStorage>

Persistent storage configuration (only for stateful containers)

replicas: Option<u32>

Fixed replica count (for stateful containers or stateless without autoscaling)

autoscaling: Option<ContainerAutoscaling>

Autoscaling configuration (only for stateless containers)

stateful: bool

Whether container is stateful (gets stable ordinals, optional persistent volumes)

environment: HashMap<String, String>

Environment variables

pool: Option<String>

Capacity group to run on (must exist in the cluster) If not specified, containers are scheduled to any available group.

permissions: String

Permission profile name

health_check: Option<HealthCheck>

Health check configuration

command: Option<Vec<String>>

Command to override image default

Implementations

impl Container

pub fn new(id: String) -> ContainerBuilder

Create an instance of Container using the builder syntax

impl Container

pub const RESOURCE_TYPE: ResourceType

The resource type identifier for Container

pub fn id(&self) -> &str

Returns the container’s unique identifier.

pub fn get_permissions(&self) -> &str

Returns the permission profile name for this container.

pub fn is_stateless(&self) -> bool

Returns true if this container is stateless (not stateful).

Trait Implementations

impl Clone for Container

fn clone(&self) -> Container

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Container

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Container

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Container

fn eq(&self, other: &Container) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl ResourceDefinition for Container

fn resource_type() -> ResourceType

Returns the static type identifier for this resource type (e.g., “Function”, “Storage”)

fn get_resource_type(&self) -> ResourceType

Returns the resource type for this instance (calls the static method)

fn id(&self) -> &str

Returns the unique identifier for this specific resource instance

fn get_dependencies(&self) -> Vec<ResourceRef>

Returns the list of other resources this resource depends on

fn get_permissions(&self) -> Option<&str>

Returns the permission profile name for this resource, if it has one.

fn validate_update(&self, new_config: &dyn ResourceDefinition) -> Result<()>

Validates if an update from the current configuration to a new configuration is allowed

fn as_any(&self) -> &dyn Any

Provides access to the underlying concrete type for downcasting

fn as_any_mut(&mut self) -> &mut dyn Any

Provides mutable access to the underlying concrete type for downcasting

fn box_clone(&self) -> Box<dyn ResourceDefinition>

Creates a boxed clone of this resource definition

fn resource_eq(&self, other: &dyn ResourceDefinition) -> bool

For equality comparison between resource definitions

impl Serialize for Container

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Container