oracular (1) container-get-curl.1.gz

Provided by: open-infrastructure-compute-tools_20221223-6_all bug

NAME
       container-get-curl - Download a Debian based container by downloading a tarball over the network


SYNOPSIS
       container get -s curl ['OPTIONS']


DESCRIPTION
       The curl container download script uses curl(1) to download a tarball over the network to create a Debian
       based container.

       Depending on the tarball this script otherwise creates a pure Debian system with three modificiations:

          • hostname is set (container name) in /etc/hostname

          • systemd machine-id is generated in /etc/machine-id

          • root password is set (user specified or 16 random characters)

   Container images
       compute-tools will download tarballs from a server expecting that the images  are  tarballs  with  either
       gzip,  lzip,  xz,  or  no  compression.  See  container-images.sh as an example on how to create your own
       container images.


OPTIONS
       The following script options are available:

       -n, --name='NAME':
              Specify container name.

       -a, --architecture='ARCHITECTURE':
              Specify container architecture.

       --clean:
              Remove container tarball after successful download.

       -p, --root-password='PASSWORD':
              Specify the root password, defaults to a random 16 character password.

       --server='SERVER':
              Specify     the     image     server     to      download      from,      defaults      to      '‐
              https://get.open-infrastructure.net/system/container/debian'.

       --setup='SETUP':
              Specify  the  setup image name to download, defaults to the value specified through --system using
              the setup.tar.${COMPRESSION} suffix (where ${COMPRESSION} is either lz, xz,  or  gz  depending  on
              compressor availability on the host system).

       --system='SYSTEM':
              Specify       the       system       image       name      to      download,      defaults      to
              debian-bookworm-current_${ARCHITECTURE}.system.tar.${COMPRESSION} (where  ${ARCHITECTURE}  is  the
              host  systems  architecture  and  ${COMPRESSION}  either  lz,  xz,  or  gz depending on compressor
              availability on the host system).


EXAMPLES
       Download a Debian 12 (bookworm) based container with same architecture as the host system:
          sudo container get -s curl -n bookworm.example.net

       Download a Debian 12 (bookworm) based container with different architecture as the host system:
          sudo     container     get     -s     curl     -n      bookworm-i386.example.net      --      --system
          debian-bookworm-current_i386.system.tar.xz


FILES
       The following files are used:

       /etc/compute-tools/config:
              Container configuration files.

       /usr/share/compute-tools/get-scripts:
              Container download scripts.

       /usr/share/doc/compute-tools:
              Container documentation.

       /var/lib/machines:
              Container directory.

       /var/cache/container:
              Container cache directory.


SEE ALSO
       compute-tools(7),
       container(1).


HOMEPAGE
       More  information about compute-tools and the Open Infrastructure project can be found on the homepage (‐
       https://open-infrastructure.net).


CONTACT
       Bug reports, feature requests, help, patches, support  and  everything  else  are  welcome  on  the  Open
       Infrastructure Software Mailing List <software@lists.open-infrastructure.net>.

       Debian specific bugs can also be reported in the Debian Bug Tracking System (https://bugs.debian.org).


AUTHORS
       compute-tools were written by Daniel Baumann <daniel.baumann@open-infrastructure.net> and others.