Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/budimanjojo/vyos-config
My VyOS IaC configuration
https://github.com/budimanjojo/vyos-config
Last synced: about 1 month ago
JSON representation
My VyOS IaC configuration
- Host: GitHub
- URL: https://github.com/budimanjojo/vyos-config
- Owner: budimanjojo
- License: apache-2.0
- Created: 2023-06-19T04:10:34.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-08-12T09:09:36.000Z (about 1 month ago)
- Last Synced: 2024-08-12T10:32:46.253Z (about 1 month ago)
- Language: Shell
- Homepage:
- Size: 106 KB
- Stars: 7
- Watchers: 2
- Forks: 3
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
### My VyOS IaC configuration
## :book: Overview
This repository contains my [VyOS](https://docs.vyos.io/en/latest/index.html) configuration in a declarative state.
Everything I have here can be applied to the machine by running [apply-config.sh](./apply-config.sh) script in the machine.
## :inbox_tray: Quickstart
After installing VyOS in your machine, setup your LAN and WAN interface and make sure it can talk to the internet.
Something like this may do:
```
configure
set interfaces ethernet eth0 address dhcp
set interfaces ethernet eth1 address 192.168.10.1/24
set system name-server 1.1.1.1
commit
```
Once you're done, connect your workstation to the `eth1` and set a static IP in the `192.168.10.1/24` range.
Then you can run [bootstrap.sh](./bootstrap.sh) and follow the instruction on your screen:
```
bash <(curl -s https://raw.githubusercontent.com/budimanjojo/vyos-config/main/bootstrap.sh)
```
The bootstrap script will:
1. Generate SSH keypair in `/config/secrets`.
2. Enable SSH access to itself.
3. Print the `scp` command to send `age` secret key into `/config/secrets` and getting the generated public key.
4. Pulling your repository into `/config` directory.
5. Generate container config files inside [containers](./containers) directory if they have `.bootstrap.tmpl` extension with secrets substituted.
6. Pull container images needed for bootstrap process.
7. Applying `set` commands inside [bootstrap](./bootstrap) directory.
After bootstrapping, you don't need to run it anymore although it should be pretty idempotent.
## :gear: Chore
Everytime you want to change something, do it inside `/config` directory and then run [apply-config.sh](./apply-config.sh) with `-c` flag.
Don't forget to push the changes to your remote repository too.
This will ensure the state of this repository to be the same as the machine configuration.
## :handshake: Thanks
A lot of inspiration in this repository came from:
- [bjw-s](https://github.com/bjw-s/vyos-config)
- [scotte](https://github.com/szinn/vyos-config)