diff --git a/.gitea/workflows/netbird-install.yml b/.gitea/workflows/netbird-install.yml index 1b26424..5c30d37 100644 --- a/.gitea/workflows/netbird-install.yml +++ b/.gitea/workflows/netbird-install.yml @@ -40,7 +40,7 @@ jobs: chmod 600 "${HOME}/.ssh/id_ed25519" trap 'rm -f "${HOME}/.ssh/id_ed25519"' EXIT - cd "${HOME}/homelab-infra" + cd "${HOME}/homelab-infra/ansible" extra_args=() if [ -n "${NETBIRD_LETSENCRYPT_EMAIL:-}" ]; then diff --git a/.gitea/workflows/terraform.yml b/.gitea/workflows/terraform.yml new file mode 100644 index 0000000..39f568d --- /dev/null +++ b/.gitea/workflows/terraform.yml @@ -0,0 +1,60 @@ +name: terraform-proxmox + +on: + workflow_dispatch: + inputs: + action: + description: 'Действие Terraform (plan / apply)' + required: true + type: choice + options: + - plan + - apply + default: plan + +jobs: + terraform: + runs-on: homelab + container: + image: hashicorp/terraform:1.9.8 + timeout-minutes: 15 + steps: + - name: Checkout repository + run: | + # В контейнере terraform git может отсутствовать, поэтому клонируем через рабочий каталог или curl/шаг checkout + echo "Запуск Terraform для Proxmox..." + + - name: Выполнить Terraform + env: + TF_VAR_proxmox_endpoint: ${{ secrets.PVE_ENDPOINT }} + TF_VAR_proxmox_api_token: ${{ secrets.PVE_API_TOKEN }} + TF_VAR_ssh_public_key: ${{ secrets.RUNNER_SSH_PUBKEY }} + GITEA_TOKEN: ${{ secrets.GITEA_TOKEN || github.token }} + ACTION: ${{ inputs.action }} + run: | + set -eu + + # Клонируем проект (или переходим, если раннер уже подготовил workspace) + # Для совместимости с текущим окружением раннера + if [ -d "${HOME}/homelab-infra" ]; then + cd "${HOME}/homelab-infra/terraform" + else + cd "terraform" + fi + + # Инициализация с Gitea HTTP Backend для безопасного хранения стейта + terraform init \ + -backend-config="address=https://gitea.gunihome.ru/api/v1/packages/karpenok/terraform/state/proxmox" \ + -backend-config="lock_address=https://gitea.gunihome.ru/api/v1/packages/karpenok/terraform/state/proxmox/lock" \ + -backend-config="unlock_address=https://gitea.gunihome.ru/api/v1/packages/karpenok/terraform/state/proxmox/lock" \ + -backend-config="username=karpenok" \ + -backend-config="password=${GITEA_TOKEN}" \ + -backend-config="lock_method=POST" \ + -backend-config="unlock_method=DELETE" \ + -backend-config="retry_wait_min=5" + + if [ "${ACTION}" = "plan" ]; then + terraform plan + elif [ "${ACTION}" = "apply" ]; then + terraform apply -auto-approve + fi diff --git a/README.md b/README.md new file mode 100644 index 0000000..87e95cc --- /dev/null +++ b/README.md @@ -0,0 +1,20 @@ +# Homelab Infrastructure (IaC & GitOps) + +Монорепозиторий управления домашней инфраструктурой и внешними серверами. + +## Архитектура слоев + +```text +homelab-infra/ +├── terraform/ # Слой 1: Provisioning (Proxmox VE: ВМ, LXC, сети) +├── ansible/ # Слой 2: Configuration Management (Настройка ОС, базовые роли) +├── kubernetes/ # Слой 3: Workloads (K3s, ArgoCD, приложения) +└── .gitea/ # CI/CD Workflows для Gitea Actions +``` + +### Стек технологий: +- **Гипервизор:** Proxmox VE +- **Provisioning:** Terraform / OpenTofu (провайдер `bpg/proxmox`) +- **Конфигурация хостов:** Ansible +- **Сетевая связность:** NetBird VPN (между домашней сетью и внешними VPS) +- **CI/CD:** Gitea Actions (локальный runner `homelab`) diff --git a/ansible.cfg b/ansible/ansible.cfg similarity index 100% rename from ansible.cfg rename to ansible/ansible.cfg diff --git a/inventories/prod/group_vars/all.yml b/ansible/inventories/prod/group_vars/all.yml similarity index 100% rename from inventories/prod/group_vars/all.yml rename to ansible/inventories/prod/group_vars/all.yml diff --git a/inventories/prod/group_vars/netbird.yml b/ansible/inventories/prod/group_vars/netbird.yml similarity index 100% rename from inventories/prod/group_vars/netbird.yml rename to ansible/inventories/prod/group_vars/netbird.yml diff --git a/inventories/prod/hosts.yml b/ansible/inventories/prod/hosts.yml similarity index 100% rename from inventories/prod/hosts.yml rename to ansible/inventories/prod/hosts.yml diff --git a/playbooks/host.yml b/ansible/playbooks/host.yml similarity index 100% rename from playbooks/host.yml rename to ansible/playbooks/host.yml diff --git a/playbooks/netbird.yml b/ansible/playbooks/netbird.yml similarity index 100% rename from playbooks/netbird.yml rename to ansible/playbooks/netbird.yml diff --git a/playbooks/site.yml b/ansible/playbooks/site.yml similarity index 100% rename from playbooks/site.yml rename to ansible/playbooks/site.yml diff --git a/requirements.yml b/ansible/requirements.yml similarity index 100% rename from requirements.yml rename to ansible/requirements.yml diff --git a/roles/host/defaults/main.yml b/ansible/roles/host/defaults/main.yml similarity index 100% rename from roles/host/defaults/main.yml rename to ansible/roles/host/defaults/main.yml diff --git a/roles/host/handlers/main.yml b/ansible/roles/host/handlers/main.yml similarity index 100% rename from roles/host/handlers/main.yml rename to ansible/roles/host/handlers/main.yml diff --git a/roles/host/tasks/main.yml b/ansible/roles/host/tasks/main.yml similarity index 100% rename from roles/host/tasks/main.yml rename to ansible/roles/host/tasks/main.yml diff --git a/roles/netbird/defaults/main.yml b/ansible/roles/netbird/defaults/main.yml similarity index 100% rename from roles/netbird/defaults/main.yml rename to ansible/roles/netbird/defaults/main.yml diff --git a/roles/netbird/files/.env.example b/ansible/roles/netbird/files/.env.example similarity index 100% rename from roles/netbird/files/.env.example rename to ansible/roles/netbird/files/.env.example diff --git a/roles/netbird/files/compose.yaml b/ansible/roles/netbird/files/compose.yaml similarity index 100% rename from roles/netbird/files/compose.yaml rename to ansible/roles/netbird/files/compose.yaml diff --git a/roles/netbird/handlers/main.yml b/ansible/roles/netbird/handlers/main.yml similarity index 100% rename from roles/netbird/handlers/main.yml rename to ansible/roles/netbird/handlers/main.yml diff --git a/roles/netbird/tasks/main.yml b/ansible/roles/netbird/tasks/main.yml similarity index 100% rename from roles/netbird/tasks/main.yml rename to ansible/roles/netbird/tasks/main.yml diff --git a/roles/netbird/templates/config.yaml.j2 b/ansible/roles/netbird/templates/config.yaml.j2 similarity index 100% rename from roles/netbird/templates/config.yaml.j2 rename to ansible/roles/netbird/templates/config.yaml.j2 diff --git a/roles/netbird/templates/dashboard.env.j2 b/ansible/roles/netbird/templates/dashboard.env.j2 similarity index 100% rename from roles/netbird/templates/dashboard.env.j2 rename to ansible/roles/netbird/templates/dashboard.env.j2 diff --git a/roles/netbird/templates/env.j2 b/ansible/roles/netbird/templates/env.j2 similarity index 100% rename from roles/netbird/templates/env.j2 rename to ansible/roles/netbird/templates/env.j2 diff --git a/kubernetes/README.md b/kubernetes/README.md new file mode 100644 index 0000000..b325dd0 --- /dev/null +++ b/kubernetes/README.md @@ -0,0 +1,5 @@ +# Kubernetes (Слой 3: Workloads) + +Здесь будут размещаться: +- `bootstrap/` — скрипты инициализации K3s/RKE2/Talos, установка ArgoCD / Helm. +- `apps/` — декларативные манифесты сервисов homelab, синхронизируемые через ArgoCD (GitOps). diff --git a/terraform/README.md b/terraform/README.md new file mode 100644 index 0000000..9b985b7 --- /dev/null +++ b/terraform/README.md @@ -0,0 +1,23 @@ +# Terraform / OpenTofu (Proxmox VE) + +Данная директория отвечает за **Слой 1 (Provisioning)** — создание и управление ресурсами в Proxmox VE (виртуальные машины, unprivileged LXC контейнеры, диски, сети). + +## Провайдер +Используется официальный современный провайдер [`bpg/proxmox`](https://registry.terraform.io/providers/bpg/proxmox/latest/docs). + +## Быстрый старт локально +1. Скопируйте файл переменных: + ```bash + cp terraform.tfvars.example terraform.tfvars + ``` +2. Заполните реальные данные подключения в `terraform.tfvars`. +3. Инициализация и запуск: + ```bash + terraform init + terraform plan + terraform apply + ``` + +## Хранение стейта (State) +В Gitea стейт хранится через встроенный HTTP Backend: +`https://gitea.gunihome.ru/api/v1/packages//terraform/state/` diff --git a/terraform/lxc.tf b/terraform/lxc.tf new file mode 100644 index 0000000..b7d73aa --- /dev/null +++ b/terraform/lxc.tf @@ -0,0 +1,50 @@ +# Пример базового непривилегированного LXC контейнера +# Измените параметры (vm_id, hostname, ip, storage) под свою сеть + +resource "proxmox_virtual_environment_container" "basic_app" { + description = "Managed by Terraform: basic unprivileged LXC" + node_name = var.proxmox_node + + vm_id = 200 + unprivileged = true + + initialization { + hostname = "app-01" + + ip_config { + ipv4 { + address = "192.168.1.200/24" + gateway = "192.168.1.1" + } + } + + user_account { + keys = [var.ssh_public_key] + } + } + + network_interface { + name = "eth0" + bridge = "vmbr0" + } + + operating_system { + # Путь к загруженному шаблону на ноде Proxmox + template_file_id = "local:vztmpl/debian-12-standard_12.7-1_amd64.tar.zst" + type = "debian" + } + + cpu { + cores = 1 + } + + memory { + dedicated = 1024 + swap = 512 + } + + disk { + datastore_id = "local-zfs" + size = 10 + } +} diff --git a/terraform/main.tf b/terraform/main.tf new file mode 100644 index 0000000..ef89faa --- /dev/null +++ b/terraform/main.tf @@ -0,0 +1,24 @@ +terraform { + required_version = ">= 1.5.0" + + required_providers { + proxmox = { + source = "bpg/proxmox" + version = "~> 0.70.0" + } + } + + # Хранение состояния в Gitea Package Registry (HTTP backend). + # При запуске через CI/CD параметры backend передаются через -backend-config + backend "http" {} +} + +provider "proxmox" { + endpoint = var.proxmox_endpoint + api_token = var.proxmox_api_token + insecure = var.proxmox_insecure + + ssh { + agent = true + } +} diff --git a/terraform/outputs.tf b/terraform/outputs.tf new file mode 100644 index 0000000..7db2161 --- /dev/null +++ b/terraform/outputs.tf @@ -0,0 +1,9 @@ +output "basic_app_id" { + description = "ID созданного LXC контейнера" + value = proxmox_virtual_environment_container.basic_app.vm_id +} + +output "basic_app_ip" { + description = "IPv4 адрес созданного контейнера" + value = proxmox_virtual_environment_container.basic_app.initialization[0].ip_config[0].ipv4[0].address +} diff --git a/terraform/terraform.tfvars.example b/terraform/terraform.tfvars.example new file mode 100644 index 0000000..f9b55dd --- /dev/null +++ b/terraform/terraform.tfvars.example @@ -0,0 +1,8 @@ +# Пример локальных переменных для разработки и тестирования +# Скопируйте в terraform.tfvars (файл уже в .gitignore) + +proxmox_endpoint = "https://192.168.1.100:8006/" +proxmox_api_token = "terraform@pve!runner=00000000-0000-0000-0000-000000000000" +proxmox_insecure = true +proxmox_node = "pve" +ssh_public_key = "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIEpwqB40k8QQq3k8160gfMKDaCJCX9qzvmuijfe3mO4I gitea-runner" diff --git a/terraform/variables.tf b/terraform/variables.tf new file mode 100644 index 0000000..87220aa --- /dev/null +++ b/terraform/variables.tf @@ -0,0 +1,27 @@ +variable "proxmox_endpoint" { + description = "URL Proxmox API (например, https://192.168.1.100:8006/)" + type = string +} + +variable "proxmox_api_token" { + description = "API Token Proxmox в формате USER@REALM!TOKENID=UUID_SECRET" + type = string + sensitive = true +} + +variable "proxmox_insecure" { + description = "Разрешить самоподписанные SSL-сертификаты Proxmox" + type = bool + default = true +} + +variable "proxmox_node" { + description = "Имя ноды Proxmox (например, pve)" + type = string + default = "pve" +} + +variable "ssh_public_key" { + description = "Публичный SSH-ключ для доступа к создаваемым контейнерам" + type = string +}