NAME

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

SYNOPSIS

          $ ch-pull2dir IMAGE[:TAG] DIR

DESCRIPTION

       WARNING:
          This  script  is  deprecated  in  favor  of  ch-convert. It will be removed in the next
          release.

       Pull Docker image named IMAGE[:TAG] from Docker Hub and extract it into a subdirectory  of
       DIR. A temporary tarball is stored in DIR.

       Sudo privileges are required to run the docker pull command.

       This  runs  the  following  command  sequence: ch-pull2tar, ch-tar2dir. See warning in the
       documentation for ch-tar2dir.

       Additional arguments:

          --help print help and exit

          --version
                 print version and exit

EXAMPLES

          $ ch-pull2dir alpine /var/tmp
          Using default tag: latest
          latest: Pulling from library/alpine
          Digest: sha256:621c2f39f8133acb8e64023a94dbdf0d5ca81896102b9e57c0dc184cadaf5528
          Status: Image is up to date for alpine:latest
          -rw-r--r--. 1 charlie charlie 2.1M Oct  5 19:52 /var/tmp/alpine.tar.gz
          creating new image /var/tmp/alpine
          /var/tmp/alpine unpacked ok
          removed '/var/tmp/alpine.tar.gz'

       Same as above, except optional TAG is specified:

          $ ch-pull2dir alpine:3.6 /var/tmp
          3.6: Pulling from library/alpine
          Digest: sha256:cc24af836d1377e092ecb4e8f0a4324c3b1aa2b5295c2239edcc7bbc86a9cbc6
          Status: Image is up to date for alpine:3.6
          -rw-r--r--. 1 charlie charlie 2.1M Oct  5 19:54 /var/tmp/alpine:3.6.tar.gz
          creating new image /var/tmp/alpine:3.6
          /var/tmp/alpine:3.6 unpacked ok
          removed '/var/tmp/alpine:3.6.tar.gz'

REPORTING BUGS

       If Charliecloud was obtained from your Linux distribution,  use  your  distribution’s  bug
       reporting procedures.

       Otherwise, report bugs to: https://github.com/hpc/charliecloud/issues

SEE ALSO

       charliecloud(7)

       Full documentation at: <https://hpc.github.io/charliecloud>

COPYRIGHT

       2014–2021, Triad National Security, LLC