Struct Stack 

pub struct Stack {
    pub id: String,
    pub resources: IndexMap<String, ResourceEntry>,
    pub permissions: PermissionsConfig,
    pub supported_platforms: Option<Vec<Platform>>,
    pub inputs: Vec<StackInputDefinition>,
}

A bag of resources, unaware of any cloud.

Fields

id: String

Unique identifier for the stack

resources: IndexMap<String, ResourceEntry>

Map of resource IDs to their configurations and lifecycle settings

permissions: PermissionsConfig

Combined permissions configuration containing both profiles and management

supported_platforms: Option<Vec<Platform>>

Which platforms this stack supports. When None, all platforms are supported.

inputs: Vec<StackInputDefinition>

Input definitions required before setup or deployment can proceed.

Implementations

impl Stack

pub fn new(id: String) -> StackBuilder

Create an instance of Stack using the builder syntax

impl Stack

pub fn frozen_resources_digest(&self) -> String

Returns a deterministic digest of the complete Frozen resource set. Resource and object-key ordering do not affect the digest.

pub fn resources(&self) -> impl Iterator<Item = (&String, &ResourceEntry)>

Returns an iterator over the resources in the stack, including their lifecycle state.

pub fn resources_mut( &mut self, ) -> impl Iterator<Item = (&String, &mut ResourceEntry)>

Returns a mutable iterator over the resources in the stack, including their lifecycle state.

pub fn id(&self) -> &str

pub fn current() -> StackRef

Create a reference to the current stack

pub fn permissions(&self) -> &PermissionsConfig

Returns the permissions configuration for the stack.

pub fn permission_profiles(&self) -> &IndexMap<String, PermissionProfile>

Returns the permission profiles for the stack.

pub fn management(&self) -> &ManagementPermissions

Returns the management permissions configuration for the stack.

pub fn supported_platforms(&self) -> Option<&[Platform]>

Returns the supported platforms, or None if all platforms are supported.

pub fn inputs(&self) -> &[StackInputDefinition]

Returns stack input definitions.

pub fn supports_platform(&self, platform: &Platform) -> bool

Returns true if the given platform is supported by this stack. When supported_platforms is None, all platforms are supported.

impl Stack

pub fn command_targets(&self) -> Vec<CommandTarget>

Returns the ordered list of command-capable targets in this stack: Worker, Container, and Daemon resources with commands_enabled set, in stack declaration order.

Declaration order is the order resources were added to the stack (via StackBuilder::add/add_with_dependencies/add_with_remote_access). resources is an IndexMap, which preserves insertion order, so iterating it directly yields declaration order without any extra bookkeeping.

pub fn worker_command_push_env_vars( &self, commands_token: Option<&str>, ) -> Result<Vec<EnvironmentVariable>>

Returns the authentication token used by the manager/operator to push commands to each command-enabled Local/Kubernetes Worker runtime. Cloud-native Worker transports authenticate through their platform and do not use this helper.

pub fn receiver_command_env_vars( &self, commands_url: &str, commands_token: Option<&str>, ) -> Result<Vec<EnvironmentVariable>>

Returns the command receiver environment variables for each command-enabled Container and Daemon in this stack, scoped via target_resources so every var reaches only its own resource.

Workers receive platform pushes; Containers and Daemons run the pull receiver, which reads this fixed environment contract:

• ALIEN_COMMANDS_URL (Plain) — base receiver URL
• ALIEN_COMMANDS_TOKEN (Secret, only if a token is present)
• ALIEN_COMMANDS_TARGET_RESOURCE_ID (Plain) — this resource’s id
• ALIEN_COMMANDS_TARGET_RESOURCE_TYPE (Plain) — container/daemon

ALIEN_DEPLOYMENT_ID is intentionally NOT emitted here: the manager and operator already inject it deployment-wide (target_resources: None), so it reaches every Container/Daemon via that path — re-scoping it per resource would be redundant. This mirrors the worker helper, which also relies on the deployment-wide ALIEN_DEPLOYMENT_ID.

Workers are excluded here, and a commands-disabled Container/Daemon is never a command_targets() entry, so it receives nothing — the receiver fail-fasts on a partial config, so a deployment-wide flag would crash it at startup.

Trait Implementations

impl Clone for Stack

fn clone(&self) -> Stack

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Stack

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Stack

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Stack

impl From<&Stack> for StackRef

fn from(stack: &Stack) -> Self

Converts to this type from the input type.

impl PartialEq for Stack

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Stack

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 Stack