Struct opencontainers::distribution::Registry

pub struct Registry {
    pub url: String,
    // some fields omitted
}

Represents a Registry implementing the OpenContainer Distribution Spec

Fields

url: String

Methods

impl Registry

pub fn new(url: &str) -> Self

Create a new registry interface given the URL to a registry.

Note: The URL should not contain a trailing slash.

Example

let registry = Registry::new("https://registry-1.docker.io");

Panics

This function can panic if the backing ClientBuilder cannot be initialized. This can happen if the native TLS backend cannot be initialized.

pub fn get(
    &self,
    url: &str,
    headers: Option<&HeaderMap>
) -> Result<Response, RegistryError>

Perform a GET request on the Registry, handling authentication.

Authentication

Authentication is handled transiently according to the Docker Registry Token Authentication Specification

Example

let endpoint = format!("{}/v2/", registry.url);
let response = registry.get(endpoint.as_str(), None)
    .expect("Could not perform API Version Check");
assert!(response.status().is_success());

pub fn image(&self, name: &str, reference: &str) -> Result<Image, RegistryError>

Create an image handle for a given image

Example

let manifest = registry.image("library/hello-world", "latest")
    .expect("Could not get image");

Trait Implementations

impl Debug for Registry

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

Formats the value using the given formatter.