{"id":50515839,"url":"https://github.com/texas-hpc/omni-cluster-operator","last_synced_at":"2026-06-07T01:01:51.591Z","repository":{"id":361694723,"uuid":"1253581657","full_name":"texas-hpc/omni-cluster-operator","owner":"texas-hpc","description":"Kubernetes operator for managing Sidero Omni cluster templates","archived":false,"fork":false,"pushed_at":"2026-06-03T00:06:13.000Z","size":1060,"stargazers_count":1,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-06-03T00:23:38.502Z","etag":null,"topics":["controller-runtime","gitops","kubebuilder","kubernetes","omni","operator","sidero","talos"],"latest_commit_sha":null,"homepage":"https://texas-hpc.github.io/omni-cluster-operator/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/texas-hpc.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-05-29T15:58:21.000Z","updated_at":"2026-06-03T00:06:15.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/texas-hpc/omni-cluster-operator","commit_stats":null,"previous_names":["texas-hpc/omni-cluster-operator"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/texas-hpc/omni-cluster-operator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/texas-hpc%2Fomni-cluster-operator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/texas-hpc%2Fomni-cluster-operator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/texas-hpc%2Fomni-cluster-operator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/texas-hpc%2Fomni-cluster-operator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/texas-hpc","download_url":"https://codeload.github.com/texas-hpc/omni-cluster-operator/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/texas-hpc%2Fomni-cluster-operator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34003817,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-06T02:00:07.033Z","response_time":107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["controller-runtime","gitops","kubebuilder","kubernetes","omni","operator","sidero","talos"],"created_at":"2026-06-03T00:01:10.224Z","updated_at":"2026-06-07T01:01:51.499Z","avatar_url":"https://github.com/texas-hpc.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# omni-cluster-operator\n\n\u003cimg src=\"docs/assets/patch-logo.png\" alt=\"Patch, the omni-cluster-operator mascot\" width=\"128\" align=\"right\"\u003e\n\n[![Artifact Hub](https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/omni-cluster-operator-crds)](https://artifacthub.io/packages/search?repo=omni-cluster-operator-crds)\n[![Artifact Hub](https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/omni-cluster-operator)](https://artifacthub.io/packages/search?repo=omni-cluster-operator)\n\nManage Sidero Omni cluster templates from Kubernetes, without replacing Omni.\n\n\u003e [!IMPORTANT]\n\u003e `omni-cluster-operator` is an independent community project. It is not\n\u003e affiliated with, sponsored by, endorsed by, or maintained by Sidero Labs.\n\u003e Sidero, Omni, Talos, and related names are trademarks or projects of their\n\u003e respective owners.\n\n`omni-cluster-operator` gives platform teams a GitOps-friendly way to define\nOmni connections, cluster templates, machine groups, and deletion policy with\nnormal Kubernetes custom resources while keeping Omni as the lifecycle authority.\n\nPatch is the `omni-cluster-operator` mascot: an armadillo with a keyboard and a\njob to do. We picked an armadillo because it is small, armored, persistent, and\nclose to the ground, the same attitude this operator takes toward turning\nKubernetes resources into steady Omni cluster-template updates.\n\n## Which Operator Should I Use?\n\nUse `omni-cluster-operator` when Omni is part of your management plane and you\nwant Kubernetes resources to render, validate, sync, and delete Omni cluster\ntemplates.\n\nIf you want to manage Talos Linux clusters directly without Omni, consider\n[`talos-operator`](https://alperencelik.github.io/talos-operator/) instead. It\nprovides Kubernetes custom resources for Talos cluster lifecycle management,\nincluding direct Talos configuration, upgrades, backups, and generated access\nsecrets. See the docs site's\n[Choosing an Operator](https://texas-hpc.github.io/omni-cluster-operator/concepts/choosing-an-operator/)\npage for a more detailed comparison.\n\nFull user documentation is available at\n[texas-hpc.github.io/omni-cluster-operator](https://texas-hpc.github.io/omni-cluster-operator/).\n\n## Installation\n\nYou need:\n\n- a Kubernetes cluster where the operator will run\n- Helm 3 or newer\n- cert-manager installed in the target cluster\n- access to an Omni instance\n- an Omni service account key from the Omni UI or `omnictl serviceaccount create`\n\nInstall the CRDs first:\n\n```sh\nhelm install omni-cluster-operator-crds \\\n  oci://ghcr.io/texas-hpc/charts/omni-cluster-operator-crds\n```\n\nThen install the operator:\n\n```sh\nhelm install omni-cluster-operator \\\n  oci://ghcr.io/texas-hpc/charts/omni-cluster-operator \\\n  --namespace omni-cluster-operator-system \\\n  --create-namespace\n```\n\nBy default, Helm installs the latest chart version it can resolve from the OCI\nregistry. To pin a specific release, choose matching versions from the\n[operator chart package](https://github.com/texas-hpc/omni-cluster-operator/pkgs/container/charts%2Fomni-cluster-operator)\nand\n[CRD chart package](https://github.com/texas-hpc/omni-cluster-operator/pkgs/container/charts%2Fomni-cluster-operator-crds),\nthen add `--version \u003cchart-version\u003e` to both commands.\n\n## Omni Credentials\n\nCreate the Omni service account Secret in the operator release namespace. Do not\ncommit the real service account key to Git.\n\n```sh\nkubectl create secret generic omni-service-account \\\n  --namespace omni-cluster-operator-system \\\n  --from-literal=serviceAccountKey='\u003comni service account key\u003e'\n```\n\n## Verify\n\n```sh\nkubectl get pods,svc,certificate \\\n  --namespace omni-cluster-operator-system\n\nkubectl get crd | grep omni.texashpc.com\n```\n\nThe operator runs in namespaced mode. Create `OmniConnection`, `OmniCluster`,\nchild resources, explicit kubeconfig exports, and direct Helm releases in the\noperator release namespace unless you customize the deployment.\n\n## Documentation\n\n- [Installation](https://texas-hpc.github.io/omni-cluster-operator/getting-started/installation/)\n- [Cluster lifecycle](https://texas-hpc.github.io/omni-cluster-operator/getting-started/create-a-cluster/)\n- [Workload access](https://texas-hpc.github.io/omni-cluster-operator/getting-started/workload-access/)\n- [Direct Helm reconciliation](https://texas-hpc.github.io/omni-cluster-operator/concepts/direct-helm-reconciliation/)\n- [NVIDIA GPU workloads](https://texas-hpc.github.io/omni-cluster-operator/getting-started/nvidia-gpu/)\n- [GitOps](https://texas-hpc.github.io/omni-cluster-operator/getting-started/gitops/)\n- [API reference](https://texas-hpc.github.io/omni-cluster-operator/reference/api/)\n- [Debugging](https://texas-hpc.github.io/omni-cluster-operator/guides/debugging/)\n- [Contributing](CONTRIBUTING.md)\n\n## License\n\nThe source code in this repository is licensed under the Apache License,\nVersion 2.0. See [LICENSE](LICENSE).\n\nThird-party dependencies, including Sidero Labs libraries used by the operator,\nremain under their own licenses.\n\n## Conduct\n\nParticipation in this project is covered by the\n[Code of Conduct](CODE_OF_CONDUCT.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftexas-hpc%2Fomni-cluster-operator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftexas-hpc%2Fomni-cluster-operator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftexas-hpc%2Fomni-cluster-operator/lists"}