Struct DockerManager

pub struct DockerManager {
    pub docker: Arc<Docker>,
    pub docker_default_config: Config<String>,
    pub docker_credentials: DockerCredentials,
}

DockerManager provides utilities for managing a set of docker containers. It includes functions for creating, starting, stopping, and removing containers, as well as querying their status and retrieving their logs.

Examples

use switchboard_container_utils::manager::{ContainerManager, DockerManager};
use bollard::Docker;

let manager = Arc::new(DockerManager::new(
    Arc::new(Docker::connect_with_unix_defaults().unwrap()),
    Some(Config {
        ..get_default_docker_config()
    }),
));

Fields

docker: Arc<Docker>

docker_default_config: Config<String>

docker_credentials: DockerCredentials

Implementations

impl DockerManager

pub fn new( docker: Arc<Docker>, default_docker_config: Option<Config<String>>, ) -> Self

Examples found in repository

examples/simple.rs (lines 8-13)

async fn main() {
    let container_manager = DockerManager::new(
        Arc::new(Docker::connect_with_unix_defaults().unwrap()),
        Some(Config {
            ..get_default_docker_config()
        }),
    );

    container_manager
        .load_image_from_archive("../../apps/function-manager/files/qvn.tar", false)
        .await
        .unwrap();
}

Trait Implementations

impl Clone for DockerManager

fn clone(&self) -> DockerManager

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl ContainerManager for DockerManager

fn docker(&self) -> &Arc<Docker>

fn docker_credentials(&self) -> &DockerCredentials

fn docker_default_config(&self) -> &Config<String>

fn get_version<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = ContainerResult<Version>> + Send + 'async_trait>>

where Self: Sync + 'async_trait, 'life0: 'async_trait,

Asynchronously gets the version of Docker being used by the manager.

fn get_container_config( &self, image_name: &str, env: Option<Vec<String>>, overrides: DockerContainerOverrides, ) -> Config<String>

fn get_image_size<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, image: &'life1 str, tag: Option<&'life2 str>, ) -> Pin<Box<dyn Future<Output = ContainerResult<u64>> + Send + 'async_trait>>

where Self: Sync + 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

fn load_image_from_archive<'life0, 'life1, 'async_trait>( &'life0 self, filepath: &'life1 str, quiet: bool, ) -> Pin<Box<dyn Future<Output = ContainerResult<()>> + Send + 'async_trait>>

where Self: Sync + 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

fn fetch_image<'life0, 'life1, 'async_trait>( &'life0 self, image_name: &'life1 str, ) -> Pin<Box<dyn Future<Output = ContainerResult<bool>> + Send + 'async_trait>>

where Self: Sync + 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

fn inspect_image<'life0, 'life1, 'async_trait>( &'life0 self, image_name: &'life1 str, ) -> Pin<Box<dyn Future<Output = ContainerResult<ImageInspect>> + Send + 'async_trait>>

where Self: Sync + 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

fn create_docker_container<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, key: &'life1 str, image_name: &'life2 str, env: Option<Vec<String>>, overrides: Option<DockerContainerOverrides>, ) -> Pin<Box<dyn Future<Output = ContainerResult<DockerContainer>> + Send + 'async_trait>>

where Self: Sync + 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

fn prune_container<'life0, 'async_trait>( &'life0 self, id: String, ) -> Pin<Box<dyn Future<Output = ContainerResult<String>> + Send + 'async_trait>>

where Self: Sync + 'async_trait, 'life0: 'async_trait,

fn prune_containers<'life0, 'life1, 'async_trait>( &'life0 self, until: &'life1 str, ) -> Pin<Box<dyn Future<Output = ()> + Send + 'async_trait>>

where Self: Sync + 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

fn prune_images<'life0, 'life1, 'async_trait>( &'life0 self, until: &'life1 str, ) -> Pin<Box<dyn Future<Output = ()> + Send + 'async_trait>>

where Self: Sync + 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

fn get_active_containers<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = ContainerResult<Vec<ContainerSummary>>> + Send + 'async_trait>>

where Self: Sync + 'async_trait, 'life0: 'async_trait,

Asynchronously retrieves a vector of active container summaries.

impl Debug for DockerManager

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

Formats the value using the given formatter.