lxd 0.1.10

A Rust library for controlling LXD
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

use std::io;

use super::{lxc, Container};

/// An LXD ephemeral snapshot
pub struct Snapshot<'a> {
    _container: &'a Container,
    name: String
}

impl<'a> Snapshot<'a> {
    /// Create a snapshot of a container
    ///
    /// # Arguments
    ///
    /// * `name` - name of the new snapshot
    ///
    /// # Return
    ///
    /// A new snapshot on success
    ///
    /// # Errors
    ///
    /// Errors that are encountered while creating snapshot will be returned
    /// ```
    pub fn new(container: &'a Container, name: &str) -> io::Result<Snapshot<'a>> {
        lxc(&["snapshot", container.name(), name])?;

        let full_name = format!("{}/{}", container.name(), name);
        Ok(Snapshot {
            _container: container,
            name: full_name
        })
    }

    /// Publish snapshot as an image
    ///
    /// # Arguments
    ///
    /// * `alias` - alias of the new image
    ///
    /// # Return
    ///
    /// An empty tuple on success
    ///
    /// # Errors
    ///
    /// Errors that are encountered while publishing will be returned
    ///
    /// # Example
    ///
    /// ```
    /// use lxd::{Container, Location, Snapshot};
    ///
    /// let container = Container::new(Location::Local, "test-snapshot-publish", "ubuntu:16.04").unwrap();
    /// let snapshot = Snapshot::new(&container, "test-snapshot-publish").unwrap();
    /// snapshot.publish("test-publish").unwrap();
    /// ```
    pub fn publish(&self, alias: &str) -> io::Result<()> {
        lxc(&["publish", &self.name, "--alias", alias])
    }
}

impl<'a> Drop for Snapshot<'a> {
    fn drop(&mut self) {
        let _ = lxc(&["delete", &self.name]);
    }
}