Table of Contents

Class OrchestratorOptions

Namespace
Bielu.Microservices.Orchestrator.Configuration
Assembly
Bielu.Microservices.Orchestrator.dll

Configuration options for the microservices orchestrator.

public class OrchestratorOptions
Inheritance
OrchestratorOptions
Inherited Members

Properties

DefaultNetworkName

Optional name of a default container network that the orchestrator will auto-create (if missing) and attach every created container to when the caller does not specify any networks. This mirrors .NET Aspire's DCP behavior, which provisions a single shared aspire-session-network-{id} per session and joins all container resources to it so they can resolve each other by name.

When null, a session-scoped name is generated automatically as bielu-session-network-{OrchestratorId:N}. Set to an empty string to disable the default-network behavior entirely (containers will then land on the runtime's default network as before).

public string? DefaultNetworkName { get; set; }

Property Value

string

DefaultProvider

The default provider to use when multiple are registered.

public string? DefaultProvider { get; set; }

Property Value

string

ManagedContainersOnly

When true, the orchestrator only lists and manages containers that it created (identified by the ManagedBy label). When false, all containers on the host are visible.

public bool ManagedContainersOnly { get; set; }

Property Value

bool

OrchestratorId

Stable identifier of this orchestrator instance, persisted with every ManagedInstance so that, after a restart, the orchestrator can identify which records it owns. Defaults to a process-stable GUID; for multi-host deployments this should be configured explicitly (e.g. from machine identity or configuration) so it survives restarts.

public Guid OrchestratorId { get; set; }

Property Value

Guid

UseDefaultNetwork

When true (default), the orchestrator will, for every created container, automatically attach it to DefaultNetworkName (creating the network if it does not yet exist) when the caller did not explicitly request any networks. This matches Aspire/DCP semantics so containers created through the orchestrator can discover each other via DNS by their Name.

public bool UseDefaultNetwork { get; set; }

Property Value

bool

Methods

ResolveDefaultNetworkName()

Resolves the effective default network name for this orchestrator instance: DefaultNetworkName if set, otherwise a stable session-scoped name derived from OrchestratorId. Returns null when the user has explicitly disabled the default network by setting DefaultNetworkName to an empty string.

public string? ResolveDefaultNetworkName()

Returns

string