diff --git a/doc/tutorial/intro-to-autoinstall.rst b/doc/tutorial/intro-to-autoinstall.rst index 4c93ada0..1398a717 100644 --- a/doc/tutorial/intro-to-autoinstall.rst +++ b/doc/tutorial/intro-to-autoinstall.rst @@ -149,84 +149,89 @@ The structure of an autoinstall configuration See the :ref:`ai` for full details on the supported autoinstall directives. -A minimal autoinstall configuration is: +A minimal autoinstall configuration in +:external+cloud-init:ref:`user_data_formats-cloud_config` format looks like: .. code-block:: yaml - version: 1 - identity: - hostname: hostname - username: username - password: $crypted_pass + #cloud-config + autoinstall: + version: 1 + identity: + hostname: hostname + username: username + password: $crypted_pass Here is an example file that shows off most features: .. parsed-literal:: - :ref:`ai-version`: 1 - :ref:`ai-reporting`: - hook: - type: webhook - endpoint: http\://example.com/endpoint/path - :ref:`ai-early-commands`: - - ping -c1 198.162.1.1 - :ref:`ai-locale`: en_US - :ref:`ai-keyboard`: - layout: gb - variant: dvorak - :ref:`ai-network`: - network: - version: 2 - ethernets: - enp0s25: - dhcp4: yes - enp3s0: {} - enp4s0: {} - bonds: - bond0: - dhcp4: yes - interfaces: - - enp3s0 - - enp4s0 - parameters: - mode: active-backup - primary: enp3s0 - :ref:`ai-proxy`: http\://squid.internal:3128/ - :ref:`ai-apt`: - primary: - - arches: [default] - uri: http\://repo.internal/ - sources: - my-ppa.list: - source: "deb http\://ppa.launchpad.net/curtin-dev/test-archive/ubuntu $RELEASE main" - keyid: B59D 5F15 97A5 04B7 E230 6DCA 0620 BBCF 0368 3F77 - :ref:`ai-storage`: - layout: - name: lvm - :ref:`ai-identity`: - hostname: hostname - username: username - password: $crypted_pass - :ref:`ai-ssh`: - install-server: yes - authorized-keys: - - $key - allow-pw: no - :ref:`ai-snaps`: - - name: go - channel: 1.20/stable - classic: true - :ref:`ai-debconf-selections`: | - bind9 bind9/run-resolvconf boolean false - :ref:`ai-packages`: - - libreoffice - - dns-server^ - :ref:`ai-user-data`: - disable_root: false - :ref:`ai-late-commands`: - - sed -ie 's/GRUB_TIMEOUT=.\*/GRUB_TIMEOUT=30/' /target/etc/default/grub - :ref:`ai-error-commands`: - - tar c /var/log/installer | nc 192.168.0.1 1000 + #cloud-config + autoinstall: + :ref:`ai-version`: 1 + :ref:`ai-reporting`: + hook: + type: webhook + endpoint: http\://example.com/endpoint/path + :ref:`ai-early-commands`: + - ping -c1 198.162.1.1 + :ref:`ai-locale`: en_US + :ref:`ai-keyboard`: + layout: gb + variant: dvorak + :ref:`ai-network`: + network: + version: 2 + ethernets: + enp0s25: + dhcp4: yes + enp3s0: {} + enp4s0: {} + bonds: + bond0: + dhcp4: yes + interfaces: + - enp3s0 + - enp4s0 + parameters: + mode: active-backup + primary: enp3s0 + :ref:`ai-proxy`: http\://squid.internal:3128/ + :ref:`ai-apt`: + primary: + - arches: [default] + uri: http\://repo.internal/ + sources: + my-ppa.list: + source: "deb http\://ppa.launchpad.net/curtin-dev/test-archive/ubuntu $RELEASE main" + keyid: B59D 5F15 97A5 04B7 E230 6DCA 0620 BBCF 0368 3F77 + :ref:`ai-storage`: + layout: + name: lvm + :ref:`ai-identity`: + hostname: hostname + username: username + password: $crypted_pass + :ref:`ai-ssh`: + install-server: yes + authorized-keys: + - $key + allow-pw: no + :ref:`ai-snaps`: + - name: go + channel: 1.20/stable + classic: true + :ref:`ai-debconf-selections`: | + bind9 bind9/run-resolvconf boolean false + :ref:`ai-packages`: + - libreoffice + - dns-server^ + :ref:`ai-user-data`: + disable_root: false + :ref:`ai-late-commands`: + - sed -ie 's/GRUB_TIMEOUT=.\*/GRUB_TIMEOUT=30/' /target/etc/default/grub + :ref:`ai-error-commands`: + - tar c /var/log/installer | nc 192.168.0.1 1000 Error handling