Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/pascaliske/infrastructure

Flux based GitOps repository for my home lab infrastructure.
https://github.com/pascaliske/infrastructure

ansible flux homelab infrastructure k3s k8s-at-home kubernetes monitoring network terraform traefik

Last synced: about 19 hours ago
JSON representation

Flux based GitOps repository for my home lab infrastructure.

Host: GitHub
URL: https://github.com/pascaliske/infrastructure
Owner: pascaliske
License: mit
Created: 2019-11-13T22:56:46.000Z (almost 5 years ago)
Default Branch: main
Last Pushed: 2024-10-29T19:58:47.000Z (8 days ago)
Last Synced: 2024-10-29T21:47:37.500Z (8 days ago)
Topics: ansible, flux, homelab, infrastructure, k3s, k8s-at-home, kubernetes, monitoring, network, terraform, traefik
Language: YAML
Homepage: https://k8s.pascaliske.dev
Size: 17.1 MB
Stars: 59
Watchers: 4
Forks: 3
Open Issues: 12
Metadata Files:
- Readme: README.md
- License: LICENSE.md
- Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

        # Infrastructure

> Flux based GitOps repository for my home lab infrastructure.

[![Branch checks](https://img.shields.io/github/checks-status/pascaliske/infrastructure/main?style=flat-square)](https://github.com/pascaliske/infrastructure) [![Pipeline (linting)](https://img.shields.io/github/actions/workflow/status/pascaliske/infrastructure/linting.yml?branch=main&label=linting&style=flat-square)](https://github.com/pascaliske/infrastructure/actions/workflows/linting.yml) [![Pipeline (docs)](https://img.shields.io/github/actions/workflow/status/pascaliske/infrastructure/docs.yml?branch=main&label=docs&style=flat-square)](https://github.com/pascaliske/infrastructure/actions/workflows/docs.yml) ![GitHub commit activity](https://img.shields.io/github/commit-activity/m/pascaliske/infrastructure?style=flat-square) [![GitHub Last Commit](https://img.shields.io/github/last-commit/pascaliske/infrastructure?style=flat-square)](https://github.com/pascaliske/infrastructure/commits/main) ![GitHub top language](https://img.shields.io/github/languages/top/pascaliske/infrastructure?style=flat-square) ![GitHub repo size](https://img.shields.io/github/repo-size/pascaliske/infrastructure?style=flat-square) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)](https://opensource.org/licenses/MIT)

![Kubernetes](https://img.shields.io/badge/kubernetes-%23326ce5.svg?style=flat-square&logo=kubernetes&logoColor=white) ![Terraform](https://img.shields.io/badge/terraform-%235835CC.svg?style=flat-square&logo=terraform&logoColor=white) ![Ansible](https://img.shields.io/badge/ansible-%231A1918.svg?style=flat-square&logo=ansible&logoColor=white)

## Requirements

- [Task](https://taskfile.dev) to execute all required commands

- [Node.js](https://nodejs.org) + [Yarn](https://yarnpkg.com) (for local repository management only)

- [Ansible](https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html) to provision the cluster nodes with common settings, Tailscale and K3s

- [Terraform](https://www.terraform.io/) to deploy all external DNS records

- [Flux](https://fluxcd.io/docs/installation/) which manages and updates the cluster state

## Installation

The cluster can be set up using the following commands:

```zsh

# clone the repo to your local machine

$ git clone https://github.com/pascaliske/infrastructure

# install needed dependencies

$ task install

# setup ansible vault file (one-time)

$ task vault:setup

# provision nodes using ansible (1)

$ task cluster:provision

# bootstrap flux cluster

$ task cluster:bootstrap -- \

    --owner=$GITHUB_USER \ # required flag (2)

    --repository=$GITHUB_REPO \ # required flag (3)

    --branch=main

```

1. More information on the following command can be found in the [provisioning section](/provisioning/#provisionyml).

2. Ensure you either fill in your GitHub username or you make it available as an environment variable.

3. Name of the repository to hold the declarative cluster state. If it does not exists yet, it will automatically be created by Flux.

## Updates

Most updates inside this project are automated. Take a look at the [update section](/updates/) for detailed information on this topic.

## Thanks

A big thank you goes to these awesome people and their projects who inspired me to do this project:

- [onedr0p/home-ops](https://github.com/onedr0p/home-ops)

- [nicholaswilde/home-cluster](https://github.com/nicholaswilde/home-cluster)

- [billimek/k8s-gitops](https://github.com/billimek/k8s-gitops)

Also I want to thank you the awesome [`k8s-at-home` community](https://github.com/k8s-at-home/) for all their work on [their Helm Charts](https://github.com/k8s-at-home/charts) which helped me a lot.

## License

[MIT](LICENSE.md) – © 2024 [Pascal Iske](https://pascaliske.dev)