summaryrefslogtreecommitdiffstats
path: root/share/man/container-create-curl.1.rst
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@open-infrastructure.net>2021-07-25 07:54:36 +0000
committerDaniel Baumann <daniel.baumann@open-infrastructure.net>2021-07-26 03:46:53 +0000
commitb5b74b561d10b8c627bcf49b0234d1fb22b9c09f (patch)
tree4cb9b334ea77f56a7ffe0a29416d687ef191fc7b /share/man/container-create-curl.1.rst
parentRenaming container create command to container build. (diff)
downloadcompute-tools-b5b74b561d10b8c627bcf49b0234d1fb22b9c09f.tar.xz
compute-tools-b5b74b561d10b8c627bcf49b0234d1fb22b9c09f.zip
Making previous container curl create script a container get script.
Signed-off-by: Daniel Baumann <daniel.baumann@open-infrastructure.net>
Diffstat (limited to 'share/man/container-create-curl.1.rst')
-rw-r--r--share/man/container-create-curl.1.rst148
1 files changed, 0 insertions, 148 deletions
diff --git a/share/man/container-create-curl.1.rst b/share/man/container-create-curl.1.rst
deleted file mode 100644
index ccf5f3c..0000000
--- a/share/man/container-create-curl.1.rst
+++ /dev/null
@@ -1,148 +0,0 @@
-.. Open Infrastructure: compute-tools
-
-.. Copyright (C) 2014-2021 Daniel Baumann <daniel.baumann@open-infrastructure.net>
-..
-.. SPDX-License-Identifier: GPL-3.0+
-..
-.. This program is free software: you can redistribute it and/or modify
-.. it under the terms of the GNU General Public License as published by
-.. the Free Software Foundation, either version 3 of the License, or
-.. (at your option) any later version.
-..
-.. This program is distributed in the hope that it will be useful,
-.. but WITHOUT ANY WARRANTY; without even the implied warranty of
-.. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-.. GNU General Public License for more details.
-..
-.. You should have received a copy of the GNU General Public License
-.. along with this program. If not, see <https://www.gnu.org/licenses/>.
-
-=====================
-container-create-curl
-=====================
-
--------------------------------------------------------------------------
-Create a Debian based container by downloading a tarball over the network
--------------------------------------------------------------------------
-
-:manual section: 1
-:manual group: Open Infrastructure
-
-Synopsis
-========
-
-| **container create -s curl** ['OPTIONS']
-
-Description
-===========
-
-The curl container creation 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 downloaded tarball after successful container creation.
-
--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-bullseye-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
-========
-
-Create a Debian 11 (bullseye) based container with same architecture as the host
-system:
-
- sudo container create -s curl -n bullseye.example.net
-
-Create a Debian 11 (bullseye) based container with different architecture as the
-host system:
-
- sudo container create -s curl -n bullseye-i386.example.net -- --system debian-bullseye-current_i386.system.tar.xz
-
-Files
-=====
-
-The following files are used:
-
-/etc/compute-tools/config:
- Container configuration files.
-
-/usr/share/compute-tools/scripts:
- Container creation 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.