mirror of
https://github.com/khuedoan/homelab.git
synced 2025-01-07 05:51:17 +07:00
67 lines
2.3 KiB
Markdown
67 lines
2.3 KiB
Markdown
# Homelab
|
|
|
|
> ⚠️ WORK IN PROGRESS
|
|
|
|
## Hardware
|
|
|
|
|
|
|
|
- 4 nodes of NEC SFF PC (Japanese version of the ThinkCentre M700)
|
|
- CPU: Intel Core i5-6600T
|
|
- RAM: 16GB
|
|
- SSD: 128GB
|
|
- TP-Link TL-SG108 switch
|
|
|
|
## Architecture
|
|
|
|
| Layer | Name | Description | Provisioner |
|
|
|-------|------------------------|--------------------------------------------------------------|---------------------|
|
|
| 0 | [metal](./metal) | Bare metal OS installation, LXD, Terraform state backend,... | Ansible, PXE server |
|
|
| 1 | [infra](./infra) | Kubernetes clusters, shared apps (Git, Vault, Argo...) | Terraform, Helm |
|
|
| 2 | [apps](./apps) | | Argo |
|
|
|
|
## Usage
|
|
|
|
### Prerequisite
|
|
|
|
For the controller (to run Ansible, stateless PXE server, Terraform...):
|
|
|
|
- SSH keys in `~/.ssh/{id_rsa,id_rsa.pub}`
|
|
- Docker with `host` networking driver (which means [only Docker on Linux hosts](https://docs.docker.com/network/host/))
|
|
|
|
For bare metal nodes:
|
|
|
|
- PXE IPv4 enabled
|
|
- Wake-on-LAN enabled
|
|
- Secure boot disabled (optional, depending on the OS)
|
|
|
|
### Configurations
|
|
|
|
- [Bare metal nodes settings](./metal/hosts.ini) (IP, MAC...)
|
|
- [OS settings](./metal/group_vars/all.yml) (PXE, network...)
|
|
|
|
### Building
|
|
|
|
Open the tools container:
|
|
|
|
```sh
|
|
make
|
|
```
|
|
|
|
Then build each layer:
|
|
|
|
```sh
|
|
make metal
|
|
make infra
|
|
make apps
|
|
```
|
|
|
|
## Acknowledgments
|
|
|
|
- [Fix `nf_conntrack` hash size fix for Kubernetes on LXD](https://github.com/corneliusweig/kubernetes-lxd/issues/10#issuecomment-615950053)
|
|
- [Humble project](https://github.com/locmai/humble)
|
|
- [Kubernetes on LXD issue with BTRFS](https://medium.com/@ernstae/kubenetes-on-lxd-with-rancher-2-0-part-one-and-a-half-94e6e03f4f2e)
|
|
- [LXD container profile for Kubernetes](https://github.com/justmeandopensource/kubernetes/blob/master/lxd-provisioning/k8s-profile-config)
|
|
- [Make LXD containers get IP addresses from LAN](https://blog.simos.info/how-to-make-your-lxd-container-get-ip-addresses-from-your-lan/)
|
|
- [Some device mount for Kubernetes on LXD](https://sleeplessbeastie.eu/2020/10/07/how-to-install-kubernetes-on-lxd/)
|