Struct Docker 

pub struct Docker { /* private fields */ }

The local Docker Engine.

Implementations

impl Docker

pub fn connect() -> Result<Docker, Error>

Connects to the Docker Engine at DOCKER_HOST, or its local socket. Only unix:// hosts are supported.

pub async fn info(&self) -> Result<SystemInfo, Error>

The Engine’s system information.

pub async fn image_labels( &self, image: &str, ) -> Result<Option<HashMap<String, String>>, Error>

An image’s labels; None when Docker does not have it.

pub async fn registry_platforms( &self, image: &str, ) -> Result<Vec<String>, Error>

Asks the image’s registry for its manifest, without pulling it, and returns the platforms it is built for, such as linux/amd64. An error means pull could not get it.

Trait Implementations

impl Debug for Docker

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

Formats the value using the given formatter.

impl DockerApi for Docker

async fn start( &self, spec: &RunnerSpec, isolation: &dyn Isolation, ) -> Result<String, Error>

Creates and starts a runner container; returns its ID.

async fn inspect(&self, container: &str) -> Result<RunnerState, Error>

A container’s state and isolation.

async fn remove(&self, container: &str) -> Result<(), Error>

Removes a runner container, stopping it first if it runs.

async fn run( &self, name: &str, body: ContainerCreateBody, ) -> Result<String, Error>

Creates and starts a container that is not a runner, such as the mirror; returns its ID.

async fn list(&self, label: &str) -> Result<Vec<Container>, Error>

Every container, running or not, that has the label.

async fn wait(&self, container: &str) -> Result<i64, Error>

Waits for a container to exit; returns its exit code.

async fn logs(&self, container: &str) -> Result<String, Error>

A container’s output so far, stdout and stderr interleaved.

async fn logs_since(&self, container: &str, since: u64) -> Result<String, Error>

A container’s output since since (seconds since the epoch), each line prefixed with Docker’s RFC 3339 timestamp and a space.

async fn exec( &self, container: &str, command: Vec<String>, ) -> Result<Output, Error>

Runs a command as root in a running container; its stdout streams until it exits or the container stops. Its stderr is dropped.

async fn image_present(&self, image: &str) -> Result<bool, Error>

Whether Docker has an image.

async fn pull(&self, image: &str) -> Result<(), Error>

Pulls an image, logging its progress every few seconds.

async fn ensure_network(&self, name: &str) -> Result<(), Error>

Creates a bridge network unless it exists.

async fn ensure_volume(&self, name: &str) -> Result<(), Error>

Creates a volume unless it exists.

async fn remove_volume(&self, name: &str) -> Result<(), Error>

Removes a volume; a volume that does not exist is not an error.

async fn volume_sizes(&self) -> Result<BTreeMap<String, u64>, Error>

The disk size of every volume Docker knows, by name. Slow: Docker measures each volume.