Skip to main content

Service

Struct Service 

Source
pub struct Service { /* private fields */ }
Expand description

A source-aware typed Compose service.

Implementations§

Source§

impl Service

Source

pub const fn name(&self) -> &Located<String>

Returns the service name.

Source

pub const fn span(&self) -> SourceSpan

Returns the complete service definition span.

Source

pub const fn hostname(&self) -> Option<&Hostname>

Returns the explicitly authored raw-preserving service hostname.

Source

pub const fn container_name(&self) -> Option<&Located<String>>

Returns the explicitly authored runtime container name.

Source

pub const fn image(&self) -> Option<&Located<ImageReference>>

Returns the explicitly authored image reference.

Source

pub const fn platform(&self) -> Option<&Located<String>>

Returns the strict raw service platform string without OCI interpretation.

Source

pub const fn entrypoint(&self) -> Option<&Entrypoint>

Returns the entrypoint without normalizing its authored form.

Source

pub const fn command(&self) -> Option<&Command>

Returns the command without normalizing its authored form.

Source

pub const fn credential_spec(&self) -> Option<&CredentialSpec>

Returns the authored credential-spec mapping without resolving its references.

Source

pub const fn extends(&self) -> Option<&Extends>

Returns the authored raw extends directive without resolving its reference.

Source

pub const fn provider(&self) -> Option<&Provider>

Returns the authored provider configuration without provider execution or discovery.

Source

pub const fn post_start(&self) -> Option<&PostStartHooks>

Returns ordered post-start hooks without executing them or inferring lifecycle behavior.

Source

pub const fn pre_stop(&self) -> Option<&PreStopHooks>

Returns ordered pre-stop hooks without executing them or inferring lifecycle behavior.

Source

pub const fn pre_start(&self) -> Option<&PreStartHooks>

Returns ordered pre-start hooks without executing them or inferring lifecycle behavior.

Source

pub const fn blkio_config(&self) -> Option<&BlkioConfig>

Returns authored block-I/O configuration without controller or runtime interpretation.

Source

pub const fn cgroup(&self) -> Option<&CgroupNamespace>

Returns the authored cgroup namespace without controller or runtime interpretation.

Source

pub const fn cgroup_parent(&self) -> Option<&Located<String>>

Returns the authored raw cgroup parent string without path or runtime interpretation.

Source

pub const fn runtime(&self) -> Option<&Located<String>>

Returns the strict raw service runtime string without runtime interpretation.

Source

pub const fn pull_refresh_after(&self) -> Option<&Located<String>>

Returns the strict raw service pull-refresh interval without refresh interpretation.

Source

pub const fn attach(&self) -> Option<&Located<BooleanValue>>

Returns the authored attach choice without runtime interpretation.

Source

pub const fn init(&self) -> Option<&Located<BooleanValue>>

Returns whether Compose should run its platform-specific init process.

Source

pub const fn stdin_open(&self) -> Option<&Located<BooleanValue>>

Returns whether Compose should keep standard input open for the service.

Source

pub const fn tty(&self) -> Option<&Located<BooleanValue>>

Returns whether Compose should allocate a terminal for the service.

Source

pub const fn privileged(&self) -> Option<&Located<BooleanValue>>

Returns whether Compose should run the service with its privileged choice.

Source

pub const fn environment(&self) -> Option<&Environment>

Returns environment variables with list and mapping forms kept distinct.

Source

pub fn environment_files(&self) -> &[EnvironmentFile]

Returns service environment files in authored order with syntax retained.

Source

pub const fn labels(&self) -> Option<&Labels>

Returns service metadata labels with list and mapping forms kept distinct.

Source

pub const fn annotations(&self) -> Option<&Annotations>

Returns service annotations with list and mapping forms kept distinct.

Source

pub const fn extra_hosts(&self) -> Option<&ExtraHosts>

Returns additional host mappings with short and long forms retained.

Source

pub const fn user(&self) -> Option<&UserSpec>

Returns the raw-preserving container user/group value.

Source

pub const fn userns_mode(&self) -> Option<&UserNamespaceMode>

Returns the raw-preserving user-namespace mode.

Source

pub fn group_add(&self) -> &[Located<String>]

Returns supplementary groups in authored order without resolving names or IDs.

Source

pub const fn cap_add(&self) -> Option<&CapabilityAdd>

Returns the explicitly authored capability-add sequence, including an explicit empty one.

Source

pub const fn cap_drop(&self) -> Option<&CapabilityDrop>

Returns the explicitly authored capability-drop sequence, including an explicit empty one.

Source

pub const fn devices(&self) -> Option<&Devices>

Returns the explicitly authored ordered device sequence, including an explicit empty one.

Source

pub const fn dns(&self) -> Option<&Dns>

Returns raw service DNS servers with scalar and ordered-list forms retained.

Source

pub const fn dns_options(&self) -> Option<&DnsOptions>

Returns the explicitly authored ordered DNS resolver-option sequence.

Returns raw DNS search domains with scalar and ordered-list forms retained.

Source

pub const fn expose(&self) -> Option<&Expose>

Returns the explicitly authored ordered exposed-port sequence.

Source

pub const fn security_options(&self) -> Option<&SecurityOptions>

Returns the explicitly authored ordered raw service security options.

Source

pub const fn working_dir(&self) -> Option<&Located<String>>

Returns the container working-directory override.

Source

pub const fn read_only(&self) -> Option<&Located<BooleanValue>>

Returns the explicit read-only root-filesystem choice.

Source

pub const fn pids_limit(&self) -> Option<&PidsLimit>

Returns the raw-preserving service PID limit.

Source

pub const fn cpu_count(&self) -> Option<&Located<CpuCount>>

Returns the authored CPU-count scalar without quota or runtime interpretation.

Source

pub const fn cpu_percent(&self) -> Option<&Located<CpuPercent>>

Returns the authored CPU-percentage scalar without CPU or runtime interpretation.

Source

pub const fn cpu_period(&self) -> Option<&Located<CpuPeriod>>

Returns the authored CPU-period scalar without CPU or runtime interpretation.

Source

pub const fn cpu_quota(&self) -> Option<&Located<CpuQuota>>

Returns the authored CPU-quota scalar without CPU or runtime interpretation.

Source

pub const fn cpu_rt_period(&self) -> Option<&Located<CpuRtPeriod>>

Returns the authored real-time CPU-period scalar without CPU or runtime interpretation.

Source

pub const fn shm_size(&self) -> Option<&ShmSize>

Returns the raw-preserving service shared-memory size.

Source

pub const fn mem_limit(&self) -> Option<&MemLimit>

Returns the raw-preserving service memory limit.

Source

pub const fn tmpfs(&self) -> Option<&Tmpfs>

Returns service-level temporary filesystems with scalar and list forms retained.

Source

pub const fn sysctls(&self) -> Option<&Sysctls>

Returns service sysctls with mapping/list form and scalar spelling retained.

Source

pub const fn logging(&self) -> Option<&Logging>

Returns service logging configuration with an uninterpreted driver and ordered options.

Source

pub const fn pull_policy(&self) -> Option<&PullPolicy>

Returns the raw-preserving service image pull policy.

Source

pub const fn restart(&self) -> Option<&RestartPolicy>

Returns the service-level container restart policy.

Source

pub const fn stop_signal(&self) -> Option<&Located<String>>

Returns the explicitly authored signal used to stop the service.

Source

pub const fn stop_grace_period(&self) -> Option<&Located<StopGracePeriod>>

Returns the raw-preserving service stop grace period.

Source

pub const fn ulimits(&self) -> Option<&Ulimits>

Returns explicitly authored service resource limits.

Source

pub const fn depends_on(&self) -> Option<&DependsOn>

Returns service dependencies with short and long forms retained.

Source

pub const fn healthcheck(&self) -> Option<&Healthcheck>

Returns the service health-check definition.

Source

pub const fn build(&self) -> Option<&Build>

Returns the build declaration with short and long forms retained.

Source

pub const fn deploy(&self) -> Option<&DeployDefinition>

Returns independently classified deploy subfields.

Source

pub fn ports(&self) -> &[Port]

Returns published ports in authored order.

Source

pub fn volumes(&self) -> &[VolumeMount]

Returns service-volume mounts in authored order.

Source

pub const fn networks(&self) -> Option<&ServiceNetworks>

Returns service network attachments with short and long forms kept distinct.

Source

pub fn profiles(&self) -> &[Located<String>]

Returns explicitly authored profile names.

Source

pub fn configs(&self) -> &[ConfigGrant]

Returns service config grants in authored order.

Source

pub fn secrets(&self) -> &[SecretGrant]

Returns service secret grants in authored order.

Source

pub fn extension_fields(&self) -> &[FieldReference]

Returns retained service x- extension fields.

Source

pub fn unknown_fields(&self) -> &[FieldReference]

Returns service fields not yet represented by the typed subset.

Trait Implementations§

Source§

impl Clone for Service

Source§

fn clone(&self) -> Service

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for Service

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Eq for Service

Source§

impl PartialEq for Service

Source§

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

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

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

Inequality operator !=. Read more
Source§

impl StructuralPartialEq for Service

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.