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
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
|
//! @file docker.h
#ifndef STASIS_DOCKER_H
#define STASIS_DOCKER_H
#include "core.h"
//! Flag to squelch output from docker_exec()
#define STASIS_DOCKER_QUIET 1 << 1
//! Flag for older style docker build
#define STASIS_DOCKER_BUILD 1 << 1
//! Flag for docker buildx
#define STASIS_DOCKER_BUILD_X 1 << 2
//! Compress "docker save"ed images with a compression program
#define STASIS_DOCKER_IMAGE_COMPRESSION "zstd"
struct DockerCapabilities {
int podman; //!< Is "docker" really podman?
int build; //!< Is a build plugin available?
int available; //!< Is a "docker" program available?
int usable; //!< Is docker in a usable state for the current user?
};
/**
* Determine the state of docker on the system
*
* ```c
* struct DockerCapabilities docker_is;
* if (!docker_capable(&docker_is)) {
* fprintf(stderr, "%s is %savailable, and %susable\n",
* docker_is.podman ? "Podman" : "Docker",
* docker_is.available ? "" : "not ",
* docker_is.usable ? "" : "not ");
* exit(1);
* }
* ```
*
* @param result DockerCapabilities struct
* @return 1 on success, 0 on error
*/
int docker_capable(struct DockerCapabilities *result);
/**
* Execute a docker command
*
* Use the `STASIS_DOCKER_QUIET` flag to suppress all output from stdout and stderr.
*
* ```c
* if (docker_exec("run --rm -t ubuntu:latest /bin/bash -c 'echo Hello world'", 0)) {
* fprintf(stderr, "Docker hello world failed\n");
* exit(1);
* }
* ```
*
* @param args arguments to pass to docker
* @param flags
* @return exit code from "docker"
*/
int docker_exec(const char *args, unsigned flags);
/**
* Build a docker image
*
* ```c
* struct DockerCapabilities docker_is;
* docker_capable(&docker_is);
*
* if (docker_is.usable) {
* printf("Building docker image\n");
* if (docker_build("path/to/Dockerfile/dir")) {
* fprintf("Docker build failed\n");
* exit(1);
* }
* } else {
* fprintf(stderr, "No usable docker installation available\n");
* }
* ```
*
* @param dirpath
* @param args
* @param engine
* @return
*/
int docker_build(const char *dirpath, const char *args, int engine);
int docker_script(const char *image, char *data, unsigned flags);
int docker_save(const char *image, const char *destdir, const char *compression_program);
void docker_sanitize_tag(char *str);
int docker_validate_compression_program(char *prog);
#endif //STASIS_DOCKER_H
|
