Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rimelek/homelab
Source code to create a home lab. Part of a video tutorial
https://github.com/rimelek/homelab
ansible homelab tutorial
Last synced: 12 days ago
JSON representation
Source code to create a home lab. Part of a video tutorial
- Host: GitHub
- URL: https://github.com/rimelek/homelab
- Owner: rimelek
- License: mit
- Created: 2023-06-18T19:33:34.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-06-01T19:19:56.000Z (6 months ago)
- Last Synced: 2024-06-16T23:24:59.730Z (5 months ago)
- Topics: ansible, homelab, tutorial
- Language: Shell
- Homepage:
- Size: 39.1 KB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# README
This project was created to help you build your own home lab where you can test
your applications and configurations without breaking your workstation, so you can
learn on cheap devices without paying for more expensive cloud services.
The project contains code written for the tutorial, but you can also use parts of it
if you refer to this repository.
Tutorial on YouTube in English:
Tutorial on YouTube in Hungarian:
Note: The inventory.yml file is not shared since that depends on the actual environment,
so it will be different for everyone. If you want to learn more about the inventory file,
watch the videos on YouTube or read the written version on . Links in
the video descriptions on YouTube.
You can also find an example inventory file in the project root. You can copy that and change
the content, so you will use your IP addresses and usernames.
```bash
cp inventory-example.yml inventory.yml
```
Optionally, if you want to start an SSH agent, run:
```bash
ssh-agent $SHELL
```
If you generated an SSH private key at `~/.ssh/ansible` it will be added automatically
when you source the homelab env scripts. Otherwise, you need to run:
```bash
ssh-add $PATH_OF_THE_SSH_PRIVATE_KEY
```
Use the actual path of the SSH private key instead of the variable.
Since Ansible 8.0.0 requires a recent Python version, if you are on Ubuntu 22.04 for example you can install Nix and run the following command to create the Python environment using Python 3.11:
```bash
./create-nix-env.sh venv
```
or
```bash
./create-nix-env.sh venv-linux
```
If you created a python virtual environment with the name "venv", you can activate it using
```bash
source homelab-env.sh
```
Override the `HOMELAB_ENV` variable to customize the environment:
```bash
HOMELAB_ENV=custom-env source homelab-env.sh
```
If you want `venv-linux` on linux and `venv-darwin` on macOS, you can run
```bash
source homelab-env-os.sh
```
Run any playbook:
```bash
./run.sh playbook-hello.yml
```
Existing playbooks:
- **playbook-hello.yml**: Just a demo playbook for beginners to create a file.
- **playbook-system-base.yml**: Installation of common tools on the hosts, including useful command line tools
- **playbook-lxd-install.yml**: Installation of LXD to run virtual machines and containers.
- **playbook-lxd-remove.yml**: Remove LXD
- **playbook-lxd-docker-vm.yml**: Create and start a virtual machine and run Docker and Portainer in it.