1CH-PULL2DIR(1)                   Charliecloud                   CH-PULL2DIR(1)
2
3
4

NAME

6       ch-pull2dir - Pull image from a Docker Hub and unpack into directory
7

SYNOPSIS

9          $ ch-pull2dir IMAGE[:TAG] DIR
10

DESCRIPTION

12       Pull Docker image named IMAGE[:TAG] from Docker Hub and extract it into
13       a subdirectory of DIR. A temporary tarball is stored in DIR.
14
15       Sudo privileges are required to run the docker pull command.
16
17       This runs the following command sequence: ch-pull2tar, ch-tar2dir.  See
18       warning in the documentation for ch-tar2dir.
19
20       Additional arguments:
21
22          --help print help and exit
23
24          --version
25                 print version and exit
26

EXAMPLES

28          $ ch-pull2dir alpine /var/tmp
29          Using default tag: latest
30          latest: Pulling from library/alpine
31          Digest: sha256:621c2f39f8133acb8e64023a94dbdf0d5ca81896102b9e57c0dc184cadaf5528
32          Status: Image is up to date for alpine:latest
33          -rw-r--r--. 1 charlie charlie 2.1M Oct  5 19:52 /var/tmp/alpine.tar.gz
34          creating new image /var/tmp/alpine
35          /var/tmp/alpine unpacked ok
36          removed '/var/tmp/alpine.tar.gz'
37
38       Same as above, except optional TAG is specified:
39
40          $ ch-pull2dir alpine:3.6 /var/tmp
41          3.6: Pulling from library/alpine
42          Digest: sha256:cc24af836d1377e092ecb4e8f0a4324c3b1aa2b5295c2239edcc7bbc86a9cbc6
43          Status: Image is up to date for alpine:3.6
44          -rw-r--r--. 1 charlie charlie 2.1M Oct  5 19:54 /var/tmp/alpine:3.6.tar.gz
45          creating new image /var/tmp/alpine:3.6
46          /var/tmp/alpine:3.6 unpacked ok
47          removed '/var/tmp/alpine:3.6.tar.gz'
48

REPORTING BUGS

50       If  Charliecloud  was  obtained  from your Linux distribution, use your
51       distribution’s bug reporting procedures.
52
53       Otherwise, report bugs to: <https://github.com/hpc/charliecloud/issues>
54

SEE ALSO

56       charliecloud(7)
57
58       Full documentation at: <https://hpc.github.io/charliecloud>
59

61       2014–2021, Triad National Security, LLC
62
63
64
65
660.25                         2021-09-20 00:00 UTC               CH-PULL2DIR(1)
Impressum