ConfigReference
Differences between revisions 6 and 60 (spanning 54 versions)
|
Size: 6562
Comment:
|
← Revision 60 as of 2020-06-11 04:20:26 ⇥
Size: 71
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 1: | Line 1: |
| ||<#FF5555> '''This document is entirely a description of something that does not yet exist''' || = Automated Server Installs Config File Reference = ||<#FF5555> '''This document is entirely a description of something that does not yet exist''' || <<TableOfContents()>> = Overall format = The autoinstall file is YAML. At top level it must be a mapping containing the keys described in this document. Unrecognized keys are ignored. = Schema = A schema for the config file should be written down at some point. = Top-level keys = == version == '''type:''' integer <<BR>> '''default:''' no default A future-proofing config file version field. Currently this must be "1". == early_commands == '''type:''' list <<BR>> '''default:''' no commands A list of shell commands to invoke as soon as the installer starts, in particular before probing for block and network devices. == locale == '''type:''' string <<BR>> '''default:''' en_US.UTF-8 The locale to configure for the installer. == keyboard == '''type:''' mapping, see below <<BR>> '''default:''' US English keyboard The layout of any attached keyboard. Often systems being automatically installed will not have a keyboard at all in which case the value used here does not matter. == network == '''type:''' netplan-format mapping, see below <<BR>> '''default:''' DHCP on interfaces named eth* or en* [[https://netplan.io/reference|netplan]] formatted network configuration. This will be applied during installation as well as in the installed system. The default is to interpret the config for the install media, which runs DHCPv4 on any interface with a name matching "eth*" or "en*" but then disables any interface that does not receive an address. == proxy == '''type:''' URL <<BR>> '''default:''' no proxy The proxy to configure both during installation and for apt and for snapd in the target system. == mirror == '''type:''' URL <<BR>> '''default:''' http://archive.ubuntu.com/ubuntu or http://ports.ubuntu.com/ubuntu-ports depending on architecture The archive mirror to use. == filesystem == '''type:''' mapping, see below <<BR>> '''default:''' use "lvm" layout in a single disk system, no default in a multiple disk system Filesystem configuration is a complex topic and the description of the desired configuration in the autoinstall file can necessarily also be complex. The installer supports "layouts", simple ways of expressing common configurations. === Supported layouts === The two supported layouts at the time of writing are "lvm" and "disk". Each supports a match spec (see below) to define which disk they apply to (if omitted, a disk is chosen arbitrarily). {{{ filesystem: layout: name: lvm match: serial: CT* filesystem: layout: name: disk }}} Supplying no filesystem config is equivalent to choosing the lvm layout with no disk match spec. === action-based config === For full flexibility, the installer allows filesystem configuration to be done using a syntax which is a superset of that supported by curtin, described at https://curtin.readthedocs.io/en/latest/topics/storage.html. The extensions to the curtin syntax are mostly around disk selection. Curtin supported identifying disks by serial (e.g. `Crucial_CT512MX100SSD1_14250C57FECE`) or by path (e.g. `/dev/sdc`) and the server installer supports this as well. The installer additionally supports a ''match spec'' on a disk action that supports more flexible matching. The actions in the filesystem config are processed in the order they are in the autoinstall file. Any disk action is assigned a matching disk -- chosen arbitrarily from the set of unassigned disks if there is more than one, and causing the installation to fail if there is no unassigned matching disk. A match spec supports the following keys: * `model: foo`: matches a disk where ID_VENDOR=foo in udev, supporting globbing * `serial: foo`: matches a disk where ID_SERIAL=foo in udev, supporting globbing (the globbing support distinguishes this from specifying serial: foo directly in the disk action) * `ssd: yes|no`: matches a disk that is or is not an SSD (vs a rotating drive) * `size: largest`: take the largest disk rather than an arbitrary one if there are multiple matches * Anything else? So for example, to match an arbitrary disk it is simply: {{{ - type: disk id: disk0 }}} To match the largest ssd: {{{ - type: disk id: big-fast-disk match: ssd: yes size: largest }}} To match a Seagate drive: {{{ - type: disk id: data-disk match: model: Seagate }}} ``autoinstall-editor`` supports creating and editing configs with arbitrary disk match specs. Another extension to curtin syntax is how the size of partitions or LVM logical volumes are specified. Curtin just takes a size for this, but the server installer allows sizes to be specified as percentages of the containing device, or using min/priority/max as in d-i: (XXX I don't actually understand how min/priority/max works in d-i). {{{ - type: partition id: data-partition device: data-disk size: 75% - type: partition id: boot-partition device: boot-disk size: min: 512M priority: 600M max: 2G }}} == identity == '''type:''' mapping, see below <<BR>> '''default:''' no default Configure the initial user for the system. A mapping that can contain keys: === realname === === username === === hostname === === password === == ssh == '''type:''' mapping, see below <<BR>> '''default:''' do not install openssh-server Configure ssh for the installed system. A mapping that can contain keys: === install_server === === authorized_keys === === allow_pw === == snaps == '''type:''' list <<BR>> '''default:''' install no extra snaps Snaps to install, in the format "$snap_name/$channel". == debconf_selections == '''type:''' string <<BR>> '''default:''' no config The installer will update the target with debconf set-selection values. Users will need to be familiar with the package debconf options. == packages == '''type:''' list <<BR>> '''default:''' no packages A list of packages to install into the target system. == late_commands == '''type:''' list <<BR>> '''default:''' no commands Shell commands to run after the install has completed and any updates and packages installed, just before the system reboots |
moved to https://ubuntu.com/server/docs/install/autoinstall-reference |
FoundationsTeam/AutomatedServerInstalls/ConfigReference (last edited 2020-06-11 04:20:26 by mwhudson)