Skip to content
@sogeor

Sogeor

Open-source reference DevSecOps platform: build any Kubernetes cluster from a short description, on Proxmox or in the cloud, secure by default.

sogeor

An open-source reference DevSecOps platform: build any Kubernetes cluster from a short description, on a home Proxmox server or in the cloud, with security by default at every layer. Aligned with international (CIS, NIST SSDF, SLSA, OWASP) and Russian (GOST R 56939-2024, FSTEC orders, FSTEC BDU) frameworks.

Architecture

flowchart LR
  L0["Layer 0<br/>bootstrap"] --> GHA["GitHub Actions<br/>state on gitlab.com"]
  GHA --> EDGE["edge<br/>Headscale mesh"]
  GHA --> MGMT["mgmt cluster<br/>Talos"]
  MGMT -- "Argo CD + Cluster API" --> MAIN["main<br/>kubeadm, Ubuntu / Astra"]
  MGMT -- "Argo CD + Cluster API" --> TALOS["talos<br/>Talos Linux"]
  MAIN <-- "Cilium ClusterMesh" --> TALOS
Loading
  • Management cluster mgmt (Talos): Argo CD, Cluster API with autoscaling, OpenBao, Keycloak, Harbor, GitLab, backups.
  • Workload clusters are created from mgmt in the cloud, scale down to zero worker nodes and can be torn down and restored from backups in one operation.

Cluster constructor

A cluster is a combination of independent axes; a new combination is a new description file, not new code.

Axis Values
Distribution Talos, kubeadm, k3s
Operating system (per node pool) Ubuntu 24.04, Ubuntu 26.04, Astra Linux SE 1.8, Talos, Alpine (experimental)
Provider Proxmox, Selectel, VK Cloud, Yandex Cloud, Timeweb, bring-your-own VDS
Topology single (minimum cost) or ha, switched by configuration
Profiles core, CI, data, security-plus, observability-plus, chaos, ru-track

Principles

  • Supply chain: SLSA provenance, SBOM and VEX attestations, Cosign signatures verified at admission.
  • No static secrets in CI: OIDC → OpenBao short-lived credentials.
  • Policy as code on every layer: infrastructure plans, cluster descriptions, OS, admission, runtime, network.
  • Zero trust access: short-lived SSH certificates, OIDC for the Kubernetes API, no public admin endpoints.
  • Self-healing: nodes are recreated from descriptions, data is restored from backups automatically.
  • Documentation is part of the product: every repository explains every option and every action.

Repositories

Repository Purpose Status
images VM images: Ubuntu for Proxmox, Talos Image Factory schematic Ready OpenSSF Scorecard
.github Organization profile and community defaults Ready OpenSSF Scorecard
workflows Reusable GitHub Actions workflows and composite actions Ready OpenSSF Scorecard
docs Platform-wide documentation site, ADRs, runbooks In progress OpenSSF Scorecard
bootstrap Layer 0: Hyper-V, Proxmox, cloud accounts, secrets Planned
modules OpenTofu modules and the cluster constructor In progress OpenSSF Scorecard
management Outer contour: edge, mgmt cluster, DNS, Cloudflare Planned
platform GitOps for all clusters Planned
ansible Roles for non-Talos nodes Planned
ci-templates GitLab CI templates for the inner contour Planned
charts Shared Helm service chart Planned
store Online store running on the platform Planned
policies Policy and detection as code Planned
compliance Compliance matrix, evidence, tooling Planned

Documentation: sogeor.github.io/docs — platform overview, cluster constructor, ADRs and runbooks. Each repository also documents itself in its docs/ directory.

Pinned Loading

  1. images images Public

    Hardened VM images for the sogeor platform: Packer templates for Proxmox (Ubuntu 24.04 base and Kubernetes) and a Talos Image Factory schematic, scanned with goss, OpenSCAP CIS and Trivy with SBOM.

    Shell

  2. docs docs Public

    Documentation of the sogeor DevSecOps platform: overview, cluster constructor, network, security and compliance, platform ADRs, runbooks and threat models, with pinned docs of every platform reposi…

    Python

  3. workflows workflows Public

    Reusable GitHub Actions workflows and composite actions for the sogeor DevSecOps platform: pinned, least-privilege CI building blocks.

    Shell

  4. modules modules Public

    OpenTofu modules and generators of the sogeor cluster constructor: one validated cluster description, provider modules with a common node contract, Talos and Cluster API outputs.

    HCL

Repositories

Showing 7 of 7 repositories

Top languages

Loading…

Most used topics

Loading…