Skip to content
lgcorzoPublic
forked from minio/docs

About

Fork of minio/docs with security patches. Part of Dark Gravity.

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Β 
Β 

Latest commit

Β 

History

902 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Sovereign Documentation Engine (@lgcorzo/docs)

Maintained fork of minio/docs. It applies security patches and maintenance fixes on top of upstream. Part of the Dark Gravity factory. License: CC BY 4.0.

License: CC BY 4.0 Sovereign Ecosystem Build Status

This repository forms the central documentation build engine and architectural reference source for the Sovereign MinIO Ecosystem under @lgcorzo. It powers static site generation, API reference compilation, and deployment guides across all core components of the autonomous storage factory.


Dark Gravity Factory & Sovereign Maintenance Rationale

This repository is actively maintained under @lgcorzo as a critical pillar of the Dark Gravity Factory autonomous AI production ecosystem.

Key Maintenance Pillars

  1. Full Supply-Chain Autonomy:

    • Zero reliance on upstream breaking license changes, deprecation notices, or unannounced URL host retirements.
    • Independent verification, hermetic build environments, and complete ownership of docs build toolchains and rendering scripts.
  2. Dark Gravity Factory Core Integration:

    • Serves as the central knowledge engine powering autonomous agent pipelines, developer documentation, deployment runbooks, and architectural specifications across high-throughput storage and cryptographic security modules.
  3. Compliance & Security Standards:

    • Maintained with automated security scanning and versioned documentation designed to facilitate auditing and traceability.
    • Continuous security posture with zero-CVE SLAs enforced through automated daily vulnerability scanning (Trivy, CodeQL, govulncheck).
  4. Ecosystem Interoperability:

    • Seamless cross-reference integration across all 38 repositories in the @lgcorzo sovereign ecosystem (MinIO Server, MC CLI, KES, Operator, DirectPV, Console, SIMD libraries, and client SDKs).

Sovereign Ecosystem Architecture & Repositories (38 Repositories)

The following table summarizes the 38 interconnected repositories maintained under the @lgcorzo sovereign umbrella:

Tier Component Type Repositories Role in Dark Gravity Factory
Tier 1 Core Storage & Infrastructure minio, mc, operator, kes, console, directpv, warp, sidekick, certgen, dperf High-throughput object storage, K8s orchestration, cryptographic KMS, web console, bare-metal storage provisioning, and performance benchmarking.
Tier 2 Crypto & SIMD Acceleration sha256-simd, md5-simd, blake2b-simd, simdjson-go, highwayhash, crc64nvme, sio, asm2plan9s Hardware-accelerated cryptographic primitives, SIMD JSON parsing, and streaming encryption for maximum throughput.
Tier 3 SDKs & Core Client Libraries minio-go, madmin-go, kms-go, pkg, cli, colorjson, csvparser, dnscache, filepath, mtls, multipart-debug, mux, pkger, selfupdate, websocket, xxml, zipindex Multi-language SDKs, administrative management APIs, KMS protocols, and low-level utility libraries for sovereign services.
Tier 4 Testing & Documentation mint, docs, minio-cf Automated integration testing suites, Sphinx/Markdown documentation engines, and cloud template configurations.

πŸ›οΈ Ecosystem Sovereignty & Independence Report

1. Degree of Independence from Upstream MinIO

The @lgcorzo MinIO ecosystem operates with Full Sovereignty (100% Operational & Deployment Independence):

  • Git Remote Topology: 100% Sovereign. Zero active upstream remotes exist across any of the 38 repositories. All default branches (main/master) push exclusively to github.com/lgcorzo/* and are under independent access control and branch protection.
  • Artifact & Container Registry: 100% Sovereign & Automated. Upstream image registries (quay.io/minio/*, docker.io/minio/*) are completely decommissioned from deployment manifests. All container runtimes (operator, operator-sidecar, minio, mc) are compiled automatically by GitHub Actions CI/CD pipelines (.github/workflows/docker-publish.yml in each repository) upon commit pushes and tag creation, building hermetic multi-arch (linux/amd64, linux/arm64) images and publishing directly to GitHub Container Registry (ghcr.io/lgcorzo/*). Zero manual local builds are required for distribution.
  • Zero-:latest Tagging Policy: All production images and Helm charts strictly bind to immutable semantic tags (v*.*.*-lgcorzo.*).
  • Security & Vulnerability Remediation: Fully decoupled from upstream patch cycles. GitHub CodeQL static code analysis, Dependabot security updates, and automated patching are active across 100% of the repositories (38/38).

2. Date of Complete Sovereignty & Historical Divergence Point

  • Sovereignty Baseline Date: October 10, 2026
  • As of this milestone date, the entire 38-repository cluster achieved:
    1. Complete resolution and closure of all outstanding security and dependency issues (74/74 issues resolved).
    2. End-to-end continuous deployment via FluxCD into live Kubernetes clusters using strictly sovereign images.
    3. Removal of legacy upstream replace directives (e.g. directpv pinning directly to github.com/lgcorzo/sha256-simd v1.0.2).

3. Concrete Evidence of Real Independence

The ecosystem provides reproducible, verifiable proof of autonomy:

  1. Live Production Workloads: Kubernetes clusters running MicroK8s in the storage namespace deploy exclusively from ghcr.io/lgcorzo/*:
    • minio-operator running ghcr.io/lgcorzo/operator:v7.1.1-lgcorzo.3
    • mlflow-minio-pool-0-0 running ghcr.io/lgcorzo/minio:v0.1.0-lgcorzo.2 with sidecar v7.1.1-lgcorzo.3
    • Bucket provisioning jobs running ghcr.io/lgcorzo/mc:v0.1.1-lgcorzo.2
  2. Independent Toolchains: The client CLI (mc) and core server build against the modern Go 1.26 toolchain (golang:1.26-alpine) with independent multi-arch (linux/amd64, linux/arm64) compilation.
  3. Decoupled Security Governance: CodeQL scans run independently on sovereign GitHub Actions pipelines, resolving security vulnerabilities (such as golang.org/x/crypto v0.36.0+) without waiting for upstream releases.

4. Branch Evolution & Divergent Roadmap

From October 10, 2026 onward, @lgcorzo default branches follow a distinct architectural trajectory independent of upstream:

  • No Upstream Rebase Mandate: The repositories no longer perform automated fast-forward or destructive rebases from upstream repositories. Upstream changes are treated as third-party reference sources, not authoritative base branches.
  • AIStor Extension Architecture: Non-AWS additions and sovereign enhancements follow the AIStor extension standard, focusing on enterprise-grade multi-tenancy, autonomous AI data pipelines, and structured auditability and traceability.
  • Sovereign Go Module Architecture: Moving systematically through the Sovereign Go Module Decoupling Plan using replace-overlays and sovereign module namespaces (github.com/lgcorzo/*), ensuring stability and freedom from upstream licensing restrictions.

Automated CI/CD & Sovereign Maintenance Lifecycle

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                      Upstream Tracking Branch                          β”‚
β”‚                     (weekly upstream-sync cron)                        β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                                   β”‚
                                   β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                   Dark Gravity Factory CA/CD                           β”‚
β”‚     (Daily Trivy / CodeQL / VulnCheck Scans + Autonomous AST Patching) β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                                   β”‚
                                   β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                  Human-in-the-Loop (HITL) Gate                         β”‚
β”‚             (Mandatory code review & sign-off prior to merge)          β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                                   β”‚
                                   β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                  Hermetic Multi-Stage Build & Release                  β”‚
β”‚       (Multi-arch AMD64/ARM64, GHCR + Local Registry, Minisign/Cosign) β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Build Instructions

@lgcorzo/docs uses Sphinx to generate static HTML pages using ReSTructured Text (rST) and Markdown.

Prerequisites

  • Any GNU/Linux Operating System, or macOS 12.3 or later.
  • Python 3.10.x or later and pip
  • python3-venv
  • Node.js 18+ and npm
  • git

Local Build Steps

  1. Clone docs repository locally:
git clone https://github.com/lgcorzo/docs && cd docs/
  1. Create and activate a Python virtual environment:
python3 -m venv venv && source venv/bin/activate
  1. Install Python and Node.js dependencies:
pip install -r requirements.txt && npm install && npm run build
  1. Compile documentation:
make SYNC_SDK=true mindocs
  1. Preview the generated documentation at http://localhost:8000:
python3 -m http.server --directory build/$(git rev-parse --abbrev-ref HEAD)/mindocs/html

Syncing Operator CRD Docs

To sync Operator CRD documentation:

make sync-operator-crd

This script:

  • Downloads and converts tenant_crd.adoc from github.com/lgcorzo/operator.
  • Downloads Operator Helm values.yaml and Tenant Helm values.yaml.
  • Converts AsciiDoc to XML/Markdown and applies Sphinx ingest formatting.

License

This project is licensed under a Creative Commons Attribution 4.0 International License. See CONTRIBUTING.md for contribution guidelines.


Fork Maintenance & Agent Transparency

  • Changes vs. Upstream: Security dependency updates, CI/CD workflow fixes, and CodeQL remediation are tracked in the commit history and Pull Requests.
  • Agent Tagging ([agent]): Commits and pull requests generated automatically by agents in the Dark Gravity pipeline are prefixed with [agent] to distinguish automated maintenance from manual work.

About

Fork of minio/docs with security patches. Part of Dark Gravity.

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages