devrig 0.30.1

Local development orchestrator
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72

use anyhow::{Context, Result};
use bollard::models::{EndpointSettings, NetworkConnectRequest, NetworkCreateRequest};
use bollard::Docker;
use std::collections::HashMap;

/// Create a project-scoped bridge network if it doesn't already exist.
pub async fn ensure_network(
    docker: &Docker,
    network_name: &str,
    labels: HashMap<String, String>,
) -> Result<()> {
    match docker.inspect_network(network_name, None).await {
        Ok(_) => return Ok(()),
        Err(bollard::errors::Error::DockerResponseServerError {
            status_code: 404, ..
        }) => {}
        Err(e) => return Err(e).context("inspecting network"),
    }

    let config = NetworkCreateRequest {
        name: network_name.to_string(),
        driver: Some("bridge".to_string()),
        labels: Some(labels),
        ..Default::default()
    };
    docker
        .create_network(config)
        .await
        .context("creating Docker network")?;
    Ok(())
}

/// Remove a Docker network, ignoring 404 (already removed).
pub async fn remove_network(docker: &Docker, network_name: &str) -> Result<()> {
    match docker.remove_network(network_name).await {
        Ok(()) => Ok(()),
        Err(bollard::errors::Error::DockerResponseServerError {
            status_code: 404, ..
        }) => Ok(()),
        Err(e) => Err(e).context("removing Docker network"),
    }
}

/// Connect a container to a network with optional aliases.
pub async fn connect_container(
    docker: &Docker,
    network_name: &str,
    container_id: &str,
    aliases: Vec<String>,
) -> Result<()> {
    let config = NetworkConnectRequest {
        container: container_id.to_string(),
        endpoint_config: Some(EndpointSettings {
            aliases: Some(aliases),
            ..Default::default()
        }),
    };
    docker
        .connect_network(network_name, config)
        .await
        .context("connecting container to network")?;
    Ok(())
}

/// Build the standard set of devrig labels for a Docker resource.
pub fn resource_labels(slug: &str, service: &str) -> HashMap<String, String> {
    HashMap::from([
        ("devrig.project".to_string(), slug.to_string()),
        ("devrig.service".to_string(), service.to_string()),
        ("devrig.managed-by".to_string(), "devrig".to_string()),
    ])
}