Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ravens/docker-vyos
VyOS inside a container.
https://github.com/ravens/docker-vyos
Last synced: about 1 month ago
JSON representation
VyOS inside a container.
- Host: GitHub
- URL: https://github.com/ravens/docker-vyos
- Owner: ravens
- License: mit
- Created: 2019-07-09T21:40:56.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2019-07-28T20:40:22.000Z (about 5 years ago)
- Last Synced: 2024-07-07T22:22:13.761Z (3 months ago)
- Language: Dockerfile
- Size: 13.7 KB
- Stars: 14
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# docker-vyos
VyOS inside a container for validing config files, playing with the software etc. without the heavyness of a VM.
## generating a local docker image for vyos
### rolling release
Per the original https://hub.docker.com/r/2stacks/vyos instructions:
```
sudo apt-get install -y squashfs-tools python-bs4
curl --output vyos-latest.iso `python vyos-latest.py` # will fetch a rolling release for you
mkdir unsquashfs
mkdir rootfs
sudo mount -o loop vyos-latest.iso rootfs
sudo unsquashfs -f -d unsquashfs/ rootfs/live/filesystem.squashfs
sudo tar -C unsquashfs -c . | docker import - vyos
sudo umount rootfs
```
### using VMWare Marketplace image
Using your vmware account, fetch the VyOS [appliance OVA file](https://marketplace.vmware.com/vsx/solutions/vyos-1-2-lts-1-2-0)
```
sudo apt-get install -y squashfs-tools p7zip-full
mkdir unsquashfs
mkdir rootfs
tar xvf vyos-1.2.1.ova
7z x -ooutput_ova vyos-1.2.1-disk1.vmdk
sudo unsquashfs -f -d unsquashfs/ output_ova/boot/1.2.1/1.2.1.squashfs
sudo tar -C unsquashfs -c . | docker import - vyos
```
## starting a VyOS docker instance
I am providing a docker-compose.yml and some initial config file (config.init), opiniated with DNS and SSH. The config directory will receive the configuration of VyOS as stored in the system.
How does this works ? This docker-compose will use the init as entrypoint of the squashfs image from VyOS to initialize most of VyOS components as the normal iso. The trick is to change vyos-config init script by a simple one that loads the config.init mounted by docker.
```
docker-compose build
docker-compose up -d
```
## accessing the VyOS prompt
Just running the following command after a couple of seconds to let the initial configuration settle in:
```
docker-compose exec -u vyos vyos /bin/vbash
```
Then one can interact with the VyOS prompt as usual
```
show configuration
configure
set system time-zone Europe/Madrid
commit
save
exit
```
## notes and disclaimer
I did not tested (yet) advanced services like firewall, routing or IPSec. YMMV and you might have to adjust the docker-compose or adjust VyOS code itself for those usage in container mode.