https://github.com/M0NsTeRRR/Homelab-infra

Homelab management infrastructure (Packer / Terraform / Ansible)
https://github.com/M0NsTeRRR/Homelab-infra

Last synced: 2 months ago
JSON representation

Homelab management infrastructure (Packer / Terraform / Ansible)

• Host: GitHub
• URL: https://github.com/M0NsTeRRR/Homelab-infra
• Owner: M0NsTeRRR
• License: other
• Archived: true
• Created: 2019-11-14T17:12:51.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2023-06-24T17:56:49.000Z (over 1 year ago)
• Last Synced: 2024-08-02T15:53:58.549Z (5 months ago)
• Language: Jinja
• Size: 1.25 MB
• Stars: 17
• Watchers: 3
• Forks: 5
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
## This project has been replaced by -> https://github.com/M0NsTeRRR/homelabv3-infra

This is my Homelab infrastructure.

![Ansible Lint](https://github.com/M0NsTeRRR/Homelab-infra/workflows/Ansible%20Lint/badge.svg)

![Packer Lint](https://github.com/M0NsTeRRR/Homelab-infra/workflows/Packer%20Lint/badge.svg)

![Terraform Lint](https://github.com/M0NsTeRRR/Homelab-infra/workflows/Terraform%20Lint/badge.svg)

# Requirements

- Ansible core (version >= 2.14)

  - Python3 and Pip

- Packer (version >= 1.8)

  - Packer builder arm

- Terraform (version >= 1.3)

  - Terragrunt (version >= 0.42)

# Ansible

`cd ansible`  

Fill certs folders

Install python dependencies `pip3 install -r requirements.txt`

Install ansible galaxy dependencies `ansible-galaxy install -r requirements.yml`

fill all `secrets.yml` based on `secrets.example` in each subdirectory of `groups_vars`

#### Set environment variable `ANSIBLE_VAULT_PASS` like `export ANSIBLE_VAULT_PASS='password'`

### Playbooks to add fingerprint on know_hosts

`ansible-playbook -i hosts playbooks/add-ssh-keys.yml`

### Playbooks to create client certificate signed by a CA

`ansible-playbook -i hosts playbooks/generate-certs.yml`

### Playbooks to deploy a zone

`ansible-playbook -i hosts deploy_.yml`  

Replace `` by the appropriate zone name

# Packer

`cd packer`

Init packer plugins  

`packer init packer/templates/debian`

Port 8888 used for debian build  

Port 8889 used for ubuntu build  

Open both ports on windows firewall  

Start powershell prompt with admin right `netsh interface portproxy add v4tov4 listenaddress= connectaddress= listenport= connectport=`  

Replace  with the LAN IP of your PC and  with [8888, 8889]  

To delete the rules `netsh interface portproxy del v4tov4 listenaddress= listenport=`

Supported distributions :

**VM**

- Debian (11.3.0) - [iso](https://cdimage.debian.org/debian-cd/current/amd64/iso-cd/debian-11.3.0-amd64-netinst.iso)

- Ubuntu (20.04.4) - [iso](https://releases.ubuntu.com/20.04/ubuntu-20.04.4-live-server-amd64.iso)

**Raspberry Pi (v3/v4)**

- Ubuntu (20.04.4) - [iso](https://cdimage.ubuntu.com/releases/20.04.4/release/ubuntu-20.04.4-preinstalled-server-arm64+raspi.img.xz)

### Create template

`./build.sh` (sudo permission required for Raspberry Pi choice only)

# Terraform

`cd terraform`  

Install dependencies `pip3 install paramiko`

fill `account.hcl` based on `account.example`

**Command must be run in one of this directories (dmz/lab/vpn)**

### Create an execution plan

`terragrunt run-all plan`

### Deploy/update infrastructure

`terragrunt run-all apply`

# Licence

The code is under CeCILL license.

You can find all details here: https://cecill.info/licences/Licence_CeCILL_V2.1-en.html

# Credits

Copyright © Ludovic Ortega, 2021

Contributor(s):

-Ortega Ludovic - [email protected]