Struct Container 

pub struct Container {

    pub id: String,
    pub links: Vec<ResourceRef>,
    pub ports: Vec<ContainerPort>,
    pub public_endpoints: Vec<PublicEndpoint>,
    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>>,
    pub commands_enabled: bool,
    pub stop_grace_period_seconds: Option<u32>,
}

Container resource for running long-running container workloads.

A Container defines a deployable unit that runs on a ComputeCluster. The managed container backend handles scheduling replicas across machines, autoscaling based on various metrics, and service discovery.

Example

use alien_core::{Container, ContainerCode, ResourceSpec, ContainerAutoscaling, PublicEndpoint, 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)
    .public_endpoint(PublicEndpoint {
        name: "api".to_string(),
        port: 8080,
        protocol: ExposeProtocol::Http,
        host_label: None,
        wildcard_subdomains: false,
    })
    .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>

Internal container ports (at least one required).

public_endpoints: Vec<PublicEndpoint>

Public endpoints exposed by the container.

cluster: Option<String>

ComputeCluster resource ID that this container runs on. If None, will be auto-assigned by ComputeClusterMutation 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

commands_enabled: bool

Whether the container can receive remote commands via the Commands protocol. When enabled, an app-owned command receiver can lease pending commands for this Container and execute registered handlers.

stop_grace_period_seconds: Option<u32>

Grace period in seconds for stopping replicas during updates, drains, and deletes.

When omitted, the runtime backend applies its default. Valid values are 1 second through 24 hours.

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

Equality operator ==.

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

Inequality operator !=.

impl ResourceDefinition for Container

fn get_resource_type(&self) -> ResourceType

Returns the resource type for this instance

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

fn to_json_value(&self) -> Result<Value>

Serialize this resource to a JSON value (without the “type” tag - that’s added by Resource)

impl ResourceLinks for Container

fn links(&self) -> &[ResourceRef]

The links this definition owns, excluding triggers and ordering edges.

fn links_mut(&mut self) -> &mut Vec<ResourceRef>

Mutable access, for dropping links to resources leaving the stack.

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