mirror of
https://github.com/vyos/vyos-documentation.git
synced 2025-10-26 08:41:46 +01:00
Automation/Cloud-init - Add how to implement cloud-init on VyOS in Proxmox environment.
This commit is contained in:
Nicolas Fort
parent
fe18c3c428
commit
fc94599505
@ -233,3 +233,189 @@ most important data filtering output for ``vyos`` keyword:
|
|||||||
|
|
||||||
sudo grep vyos /var/log/cloud-init.log
|
sudo grep vyos /var/log/cloud-init.log
|
||||||
|
|
||||||
|
*********************
|
||||||
|
Cloud-init on Proxmox
|
||||||
|
*********************
|
||||||
|
|
||||||
|
Before starting, please refer to cloud-init `network-config-docs`_ in order to
|
||||||
|
know how to import user and network configurations.
|
||||||
|
|
||||||
|
Most important keys that needs to be considered:
|
||||||
|
|
||||||
|
* VyOS configuration commands are defined in user-data file.
|
||||||
|
|
||||||
|
* Networking configurations shouldn't be passed in user-data file.
|
||||||
|
|
||||||
|
* If no networking configuration is provided, then dhcp client is going to be
|
||||||
|
enabled on first interface. Bare in mind that this configuration will be
|
||||||
|
inyected at an OS level, so don't expect to find dhcp client configuration
|
||||||
|
on vyos cli. Because of this behavior, in next example lab we will disable
|
||||||
|
dhcp-client configuration on eth0.
|
||||||
|
|
||||||
|
Also, this lab considers:
|
||||||
|
|
||||||
|
* Proxmox IP address: **192.168.0.253/24**
|
||||||
|
|
||||||
|
* Storaged used: volume local, which is mounted on directory **/var/lib/vz**,
|
||||||
|
and contains all type of content, including snippets.
|
||||||
|
|
||||||
|
* Remove default dhcp client on first interface, and load other
|
||||||
|
configuration during first boot, using cloud-init.
|
||||||
|
|
||||||
|
-------------------
|
||||||
|
Generate qcow image
|
||||||
|
-------------------
|
||||||
|
|
||||||
|
A VyOS qcow image with cloud-init options is needed. This can be obteined
|
||||||
|
using `vyos-vm-images`_ repo. After clonning the repo, edit the file
|
||||||
|
**qemu.yml** and comment the **download-iso** role.
|
||||||
|
|
||||||
|
In this lab, we are using 1.3.0 VyOS version and setting a disk of 10G.
|
||||||
|
Download VyOS .iso file and save it as ``/tmp/vyos.iso``. Command used for
|
||||||
|
generating qcow image:
|
||||||
|
|
||||||
|
.. cfgcmd:: sudo ansible-playbook qemu.yml -e disk_size=10
|
||||||
|
-e iso_local=/tmp/vyos.iso -e grub_console=serial -e vyos_version=1.3.0
|
||||||
|
-e cloud_init=true -e cloud_init_ds=NoCloud
|
||||||
|
|
||||||
|
File generated with previous command:
|
||||||
|
``/tmp/vyos-1.3.0-cloud-init-10G-qemu.qcow2``
|
||||||
|
|
||||||
|
Now, that file needs to be copied to proxmox server:
|
||||||
|
|
||||||
|
.. cfgcmd:: sudo scp /tmp/vyos-1.3.0-cloud-init-10G-qemu.qcow2
|
||||||
|
root@192.168.0.253:/tmp/
|
||||||
|
|
||||||
|
|
||||||
|
------------------------
|
||||||
|
Prepare cloud-init files
|
||||||
|
------------------------
|
||||||
|
|
||||||
|
In Proxmox server three files are going to be used for this setup:
|
||||||
|
|
||||||
|
* **network-config**: file that will indicate to avoid dhcp client on first
|
||||||
|
interface.
|
||||||
|
|
||||||
|
* **user-data**: includes vyos-commands.
|
||||||
|
|
||||||
|
* **meta-data**: empty file (required).
|
||||||
|
|
||||||
|
In this lab, all files are located in ``/tmp/``. So, before going on, lets
|
||||||
|
move to that directory:
|
||||||
|
|
||||||
|
.. cfgcmd:: cd /tmp/
|
||||||
|
|
||||||
|
**user-data** file must start with ``#cloud-config`` and contains
|
||||||
|
vyos-commands. For example:
|
||||||
|
|
||||||
|
.. code-block:: none
|
||||||
|
|
||||||
|
#cloud-config
|
||||||
|
vyos_config_commands:
|
||||||
|
- set system host-name 'vyos-BRAS'
|
||||||
|
- set system ntp server 1.pool.ntp.org
|
||||||
|
- set system ntp server 2.pool.ntp.org
|
||||||
|
- delete interfaces ethernet eth0 address 'dhcp'
|
||||||
|
- set interfaces ethernet eth0 address '198.51.100.2/30'
|
||||||
|
- set interfaces ethernet eth0 description 'WAN - ISP01'
|
||||||
|
- set interfaces ethernet eth1 address '192.168.25.1/24'
|
||||||
|
- set interfaces ethernet eth1 description 'Comming through VLAN 25'
|
||||||
|
- set interfaces ethernet eth2 address '192.168.26.1/24'
|
||||||
|
- set interfaces ethernet eth2 description 'Comming through VLAN 26'
|
||||||
|
- set protocols static route 0.0.0.0/0 next-hop '198.51.100.1'
|
||||||
|
|
||||||
|
**network-config** file only has configuration that disables the automatic
|
||||||
|
dhcp client on first interface.
|
||||||
|
|
||||||
|
|
||||||
|
Content of network-config file:
|
||||||
|
|
||||||
|
.. code-block:: none
|
||||||
|
|
||||||
|
version: 2
|
||||||
|
ethernets:
|
||||||
|
eth0:
|
||||||
|
dhcp4: false
|
||||||
|
dhcp6: false
|
||||||
|
|
||||||
|
Finaly, file **meta-data** has no content, but it's required.
|
||||||
|
|
||||||
|
---------------
|
||||||
|
Create seed.iso
|
||||||
|
---------------
|
||||||
|
|
||||||
|
Once the three files were created, it's time to generate the ``seed.iso``
|
||||||
|
image, which needs to be mounted to the new VM as a cd.
|
||||||
|
|
||||||
|
Command for generating ``seed.iso``
|
||||||
|
|
||||||
|
.. cfgcmd:: mkisofs -joliet -rock -volid "cidata" -output seed.iso meta-data
|
||||||
|
user-data network-config
|
||||||
|
|
||||||
|
**NOTE**: be carefull while copying and pasting previous commands. Doble
|
||||||
|
quotes may need to be corrected.
|
||||||
|
|
||||||
|
---------------
|
||||||
|
Creating the VM
|
||||||
|
---------------
|
||||||
|
|
||||||
|
Notes for this particular example, that may need to be modified in other
|
||||||
|
setups:
|
||||||
|
|
||||||
|
* VM ID: in this example, VM ID used is 555.
|
||||||
|
|
||||||
|
* VM Storage: ``local`` volume is used.
|
||||||
|
|
||||||
|
* ISO files storage: ``local`` volume is used for ``.iso`` file storage. In
|
||||||
|
this scenario ``local`` volume type is set to **directory**, abd attached to
|
||||||
|
``/var/lib/vz``.
|
||||||
|
|
||||||
|
* VM Resources: these parameters can be modified as needed.
|
||||||
|
|
||||||
|
``seed.iso`` was previously created in directory ``/tmp/``. It's necessary to
|
||||||
|
move it to ``/var/lib/vz/template/iso``
|
||||||
|
|
||||||
|
.. cfgcmd:: mv /tmp/seed.iso /var/lib/vz/template/iso/
|
||||||
|
|
||||||
|
On proxmox server:
|
||||||
|
|
||||||
|
.. code-block:: none
|
||||||
|
|
||||||
|
## Create VM, import disk and define boot order
|
||||||
|
qm create 555 --name vyos-1.3.0-cloudinit --memory 1024 --net0 virtio,bridge=vmbr0
|
||||||
|
qm importdisk 555 vyos-1.3.0-cloud-init-10G-qemu.qcow2 local
|
||||||
|
qm set 555 --virtio0 local:555/vm-555-disk-0.raw
|
||||||
|
qm set 555 --boot order=virtio0
|
||||||
|
|
||||||
|
## Import seed.iso for cloud init
|
||||||
|
qm set 555 --ide2 media=cdrom,file=local:iso/seed.iso
|
||||||
|
|
||||||
|
## Since this server has 1 nic, lets add network intefaces (vlan 25 and 26)
|
||||||
|
qm set 555 --net1 virtio,bridge=vmbr0,firewall=1,tag=25
|
||||||
|
qm set 555 --net2 virtio,bridge=vmbr0,firewall=1,tag=26
|
||||||
|
|
||||||
|
-----------------------------
|
||||||
|
Power on VM and verifications
|
||||||
|
-----------------------------
|
||||||
|
|
||||||
|
From cli or GUI, power on VM, and after it boots, verify configuration
|
||||||
|
|
||||||
|
|
||||||
|
----------
|
||||||
|
References
|
||||||
|
----------
|
||||||
|
|
||||||
|
* VyOS `cloud-init-docs`_.
|
||||||
|
|
||||||
|
* Cloud-init `network-config-docs`_.
|
||||||
|
|
||||||
|
* Proxmox `Cloud-init-Support`_.
|
||||||
|
|
||||||
|
.. stop_vyoslinter
|
||||||
|
|
||||||
|
.. _network-config-docs: https://cloudinit.readthedocs.io/en/latest/topics/network-config.html
|
||||||
|
.. _vyos-vm-images: https://github.com/vyos/vyos-vm-images
|
||||||
|
.. _cloud-init-docs: https://docs.vyos.io/en/equuleus/automation/cloud-init.html?highlight=cloud-init#vyos-cloud-init
|
||||||
|
.. _Cloud-init-Support: https://pve.proxmox.com/pve-docs/pve-admin-guide.html#qm_cloud_init
|
||||||
|
|
||||||
|
.. start_vyoslinter
|
||||||
Loading…
x
Reference in New Issue
Block a user