isoloom-compose 1.0.1

The Docker Compose backend of Isoloom (docker, hosted).
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

//! The keys a service's hardware is written with: its devices (long form) and the GPUs it
//! reserves.

use indexmap::IndexMap;
use serde::Serialize;

/// One of the host's devices, at a path inside the container (`devices`, long form).
#[derive(Debug, Clone, PartialEq, Eq, Serialize)]
pub(crate) struct ServiceDevice {
    /// The device's path on the host.
    pub(crate) source: String,
    /// Its path inside the container.
    pub(crate) target: String,
    /// What the container may do with it (`r`, `w`, `m`).
    pub(crate) permissions: String,
}

/// `deploy.resources.reservations`.
#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize)]
pub(crate) struct Reservations {
    /// Devices the container is given (its GPUs).
    pub(crate) devices: Vec<DeviceRequest>,
}

/// A device request: GPUs by count or by id, from a driver, with capabilities.
#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize)]
pub(crate) struct DeviceRequest {
    /// What the devices are for (`gpu` first, then the runtime's capabilities).
    pub(crate) capabilities: Vec<String>,
    /// The driver that provides them (`nvidia`).
    pub(crate) driver: String,
    /// How many: a number, or `all`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub(crate) count: Option<serde_yaml_ng::Value>,
    /// Which ones, by the host's ids.
    #[serde(skip_serializing_if = "Vec::is_empty")]
    pub(crate) device_ids: Vec<String>,
    /// The driver's own options.
    #[serde(skip_serializing_if = "IndexMap::is_empty")]
    pub(crate) options: IndexMap<String, String>,
}