Compare commits

...
2 Commits
29 changed files with 236 additions and 1 deletions

No files matched your search

+1 -1
View File
@@ -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
+61
View File
@@ -0,0 +1,61 @@
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
+21
View File
@@ -0,0 +1,21 @@
# 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`)
View File
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
+6
View File
@@ -0,0 +1,6 @@
# Kubernetes (Слой 3: Workloads)
Здесь будут размещаться:
- `bootstrap/` — скрипты инициализации K3s/RKE2/Talos, установка ArgoCD / Helm.
- `apps/` — декларативные манифесты сервисов homelab, синхронизируемые через ArgoCD (GitOps).
+24
View File
@@ -0,0 +1,24 @@
# 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/<owner>/terraform/state/<state-name>`
+51
View File
@@ -0,0 +1,51 @@
# Пример базового непривилегированного 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
}
}
+25
View File
@@ -0,0 +1,25 @@
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
}
}
+10
View File
@@ -0,0 +1,10 @@
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
}
+9
View File
@@ -0,0 +1,9 @@
# Пример локальных переменных для разработки и тестирования
# Скопируйте в 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"
+28
View File
@@ -0,0 +1,28 @@
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
}