1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
|
# vyos-vm-images
[Ansible](https://www.ansible.com/) playbooks to build VyOS VM images.
## Requirements
You need a machine with at least 20 GB free space with Debian 10 (bare-metal, virtual, Docker container with --privileged flag). Also, you need to install ansible and python packages:
```
sudo apt update
sudo apt install -y ansible python
```
If you want to build an OVA image, you also need `ovftool` from VMware. It should be downloaded from the [VMware site](https://code.vmware.com/tool/ovf). Also, you need a private key to sign an OVA file. It can be generated with the next command:
```
openssl req -x509 -nodes -sha256 -days 365 -newkey rsa:1024 -keyout myself.pem -out myself.pem
```
All other requirements will be installed by ansible-playbook.
## Prepare
You need to copy the ISO image with VyOS to /tmp/vyos.iso before running ansible-playbook. Resulting images also will be located inside /tmp/ directory.
## Supported Platforms
- QEMU
```
ansible-playbook qemu.yml
```
- VMware Cloud-init
```
ansible-playbook vmware.yml -e vyos_vmware_private_key_path=path_to_private_key
```
- VMware simple ova
```
ansible-playbook vmware.yml -e vyos_vmware_private_key_path=path_to_private_key -e cloud_init=false -e ovf_template=simple
```
- Microsoft Hyper-V
```
ansible-playbook hyperv.yml
```
- Vagrant libvirt
```
ansible-playbook vagrant-libvirt.yml
```
## Additional (optional) parameters
- Path to local ISO image (default: /tmp/vyos.iso):
```
-e iso_local=path
```
Example:
```
-e iso_local=/tmp/vyos/custom_image.iso
```
- Disk size (default: 10GB):
```
-e disk_size=size
```
Example for 2 GB:
```
-e disk_size=2
```
- Enable Cloud-init (default: according to platform):
```
-e cloud_init=true
```
- Configure custom Cloud-init datasources (default: according to platform):
```
-e cloud_init_ds=datasources
```
Example:
```
-e cloud_init_ds=NoCloud,ConfigDrive,None
```
- Install guest agent. It can be `qemu`, `vmware` (default: none):
```
-e guest_agent=agent
```
Example:
```
-e guest_agent=qemu
```
- Disable configuration stage modules in Cloud-init. Mostly useful when you are building for non-cloud environments, where Cloud-init meta-data is not available (default: false):
```
-e cloud_init_disable_config=true
```
- Create an archive with files required to PXE boot (default: false):
```
-e pxe=true
```
- Keep default `vyos` user with password `vyos` in configuration when building an image with Cloud-init (default: false):
```
-e keep_user=true
```
- Select a type of partition table for a disk image. Supported: `mbr`, `gpt`, `hybrid` (default: `hybrid`):
```
-e parttable_type=hybrid
```
- Select default console for boot. Supported: `kvm`, `serial` (default: depending on platform):
```
-e grub_console=serial
```
- Install custom packages. Can be a list in the `files/custom_packages_list.txt` file separated by spaces, or deb files inside the `files/custom_debs/` directory:
```
-e custom_packages=true
```
|
