UpdateCommand

Struct UpdateCommand 

Source
pub struct UpdateCommand {
    pub executor: CommandExecutor,
    /* private fields */
}
Expand description

Docker update command builder

Update configuration of one or more containers.

§Example

use docker_wrapper::UpdateCommand;

// Update memory limit
let result = UpdateCommand::new("my-container")
    .memory("512m")
    .run()
    .await?;

if result.success() {
    println!("Container updated successfully");
}

Fields§

§executor: CommandExecutor

Command executor

Implementations§

Source§

impl UpdateCommand

Source

pub fn new(container: impl Into<String>) -> Self

Create a new update command for a single container

§Example
use docker_wrapper::UpdateCommand;

let cmd = UpdateCommand::new("my-container");
Source

pub fn new_multiple(containers: Vec<impl Into<String>>) -> Self

Create a new update command for multiple containers

§Example
use docker_wrapper::UpdateCommand;

let cmd = UpdateCommand::new_multiple(vec!["web", "db", "cache"]);
Source

pub fn container(self, container: impl Into<String>) -> Self

Add another container to update

Source

pub fn memory(self, memory: impl Into<String>) -> Self

Set memory limit

§Example
use docker_wrapper::UpdateCommand;

let cmd = UpdateCommand::new("my-container")
    .memory("512m");
Source

pub fn memory_reservation(self, memory_reservation: impl Into<String>) -> Self

Set memory reservation (soft limit)

§Example
use docker_wrapper::UpdateCommand;

let cmd = UpdateCommand::new("my-container")
    .memory_reservation("256m");
Source

pub fn memory_swap(self, memory_swap: impl Into<String>) -> Self

Set memory swap limit

§Example
use docker_wrapper::UpdateCommand;

let cmd = UpdateCommand::new("my-container")
    .memory_swap("1g");
Source

pub fn cpu_shares(self, cpu_shares: u64) -> Self

Set CPU shares (relative weight)

§Example
use docker_wrapper::UpdateCommand;

let cmd = UpdateCommand::new("my-container")
    .cpu_shares(512);
Source

pub fn cpu_period(self, cpu_period: u64) -> Self

Set CPU period

§Example
use docker_wrapper::UpdateCommand;

let cmd = UpdateCommand::new("my-container")
    .cpu_period(100_000);
Source

pub fn cpu_quota(self, cpu_quota: i64) -> Self

Set CPU quota

§Example
use docker_wrapper::UpdateCommand;

let cmd = UpdateCommand::new("my-container")
    .cpu_quota(50000);
Source

pub fn cpus(self, cpus: impl Into<String>) -> Self

Set number of CPUs

§Example
use docker_wrapper::UpdateCommand;

let cmd = UpdateCommand::new("my-container")
    .cpus("1.5");
Source

pub fn cpuset_cpus(self, cpuset_cpus: impl Into<String>) -> Self

Set CPU set

§Example
use docker_wrapper::UpdateCommand;

let cmd = UpdateCommand::new("my-container")
    .cpuset_cpus("0,1");
Source

pub fn cpuset_mems(self, cpuset_mems: impl Into<String>) -> Self

Set memory nodes

§Example
use docker_wrapper::UpdateCommand;

let cmd = UpdateCommand::new("my-container")
    .cpuset_mems("0");
Source

pub fn blkio_weight(self, blkio_weight: u16) -> Self

Set block IO weight

§Example
use docker_wrapper::UpdateCommand;

let cmd = UpdateCommand::new("my-container")
    .blkio_weight(500);
Source

pub fn kernel_memory(self, kernel_memory: impl Into<String>) -> Self

Set kernel memory limit

§Example
use docker_wrapper::UpdateCommand;

let cmd = UpdateCommand::new("my-container")
    .kernel_memory("128m");
Source

pub fn restart(self, restart: impl Into<String>) -> Self

Set restart policy

§Example
use docker_wrapper::UpdateCommand;

let cmd = UpdateCommand::new("my-container")
    .restart("unless-stopped");
Source

pub fn pids_limit(self, pids_limit: i64) -> Self

Set PID limit

§Example
use docker_wrapper::UpdateCommand;

let cmd = UpdateCommand::new("my-container")
    .pids_limit(100);
Source

pub async fn run(&self) -> Result<UpdateResult>

Execute the update command

§Errors

Returns an error if:

  • The Docker daemon is not running
  • Any of the specified containers don’t exist
  • Invalid resource limits are specified
§Example
use docker_wrapper::UpdateCommand;

let result = UpdateCommand::new("my-container")
    .memory("1g")
    .cpu_shares(512)
    .run()
    .await?;

if result.success() {
    println!("Updated containers: {:?}", result.containers());
}

Trait Implementations§

Source§

impl Clone for UpdateCommand

Source§

fn clone(&self) -> UpdateCommand

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for UpdateCommand

Source§

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

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

impl DockerCommand for UpdateCommand

Source§

type Output = CommandOutput

The output type this command produces
Source§

fn build_command_args(&self) -> Vec<String>

Build the complete command arguments including subcommands
Source§

fn get_executor(&self) -> &CommandExecutor

Get the command executor for extensibility
Source§

fn get_executor_mut(&mut self) -> &mut CommandExecutor

Get mutable command executor for extensibility
Source§

fn execute<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Self::Output>> + Send + 'async_trait>>
where Self: 'async_trait, 'life0: 'async_trait,

Execute the command and return the typed output
Source§

fn execute_command<'life0, 'async_trait>( &'life0 self, command_args: Vec<String>, ) -> Pin<Box<dyn Future<Output = Result<CommandOutput>> + Send + 'async_trait>>
where Self: Sync + 'async_trait, 'life0: 'async_trait,

Helper method to execute the command with proper error handling
Source§

fn arg<S: AsRef<OsStr>>(&mut self, arg: S) -> &mut Self

Add a raw argument to the command (escape hatch)
Source§

fn args<I, S>(&mut self, args: I) -> &mut Self
where I: IntoIterator<Item = S>, S: AsRef<OsStr>,

Add multiple raw arguments to the command (escape hatch)
Source§

fn flag(&mut self, flag: &str) -> &mut Self

Add a flag option (e.g., –detach, –rm)
Source§

fn option(&mut self, key: &str, value: &str) -> &mut Self

Add a key-value option (e.g., –name value, –env key=value)

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<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
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> PolicyExt for T
where T: ?Sized,

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
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.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

impl<T> ErasedDestructor for T
where T: 'static,