{"id":25495953,"url":"https://github.com/opennetworkinglab/onos-kubernetes","last_synced_at":"2025-11-09T21:30:21.650Z","repository":{"id":48948554,"uuid":"148550518","full_name":"opennetworkinglab/onos-kubernetes","owner":"opennetworkinglab","description":"Examples and other collateral for deploying ONOS clusters using Kubernetes.","archived":false,"fork":false,"pushed_at":"2020-03-09T18:22:38.000Z","size":50,"stargazers_count":24,"open_issues_count":5,"forks_count":8,"subscribers_count":9,"default_branch":"master","last_synced_at":"2024-04-13T03:14:02.238Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","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/opennetworkinglab.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-09-12T22:37:02.000Z","updated_at":"2024-03-29T07:00:58.000Z","dependencies_parsed_at":"2022-08-30T09:01:45.025Z","dependency_job_id":null,"html_url":"https://github.com/opennetworkinglab/onos-kubernetes","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opennetworkinglab%2Fonos-kubernetes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opennetworkinglab%2Fonos-kubernetes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opennetworkinglab%2Fonos-kubernetes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opennetworkinglab%2Fonos-kubernetes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/opennetworkinglab","download_url":"https://codeload.github.com/opennetworkinglab/onos-kubernetes/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239576797,"owners_count":19662113,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":[],"created_at":"2025-02-19T00:52:48.625Z","updated_at":"2025-11-09T21:30:21.582Z","avatar_url":"https://github.com/opennetworkinglab.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"## ONOS Kubernetes\n\nThis project provides a canonical Kubernetes deployment for [ONOS] 1.14 and beyond. The goal of this project is to provide one click deployment of a configurable ONOS+Atomix+Mininet cluster.\n\n## Pod Configuration\n\nTo install the ONOS Helm chart, download [Helm] and run `helm install`:\n\n```\nhelm install charts/onos\n```\n\nAtomix uses an anti-affinity policy to ensure cluster state is replicated on distinct hosts.\nWhen running the ONOS chart in Minikube, anti-affinity must be disabled since there's only a single Kubernetes worker node:\n\n```\nhelm install --set atomix.podAntiAffinity.enabled=false charts/onos\n```\n\nThe number of ONOS and Atomix nodes are independent of one another. To scale southbound I/O,\nincrease the number of ONOS nodes by overriding `replicas`, and to scale data storage and fault tolerance, increase the number of Atomix nodes by overriding `atomix.replicas`:\n\n```\nhelm install --set replicas=5 --set atomix.replicas=3 charts/onos\n```\n\nBy default, the latest stable official ONOS and Atomix images are used. To override the images, use the `image` and `atomix.image` values:\n\n```\nhelm install --set image.repository=onosproject/onos --set image.tag=1.14.1 charts/onos\n```\n\n```\nhelm install --set atomix.image.tag=3.0.6 charts/onos\n```\n\nTo set the resource requests for ONOS containers, override the `resources.requests` values:\n\n```\nhelm install --set resources.requests.cpu=2 --set resources.requests.memory=4Gi charts/onos\n```\n\nThe same goes for Atomix:\n\n```\nhelm install --set atomix.resources.requests.cpu=2 --set atomix.resources.requests.memory=4Gi charts/onos\n```\n\nTo set the Atomix persistence configuration, override `atomix.persistence` values:\n\n```\nhelm install --set atomix.persistence.size=2Gi --set atomix.persistence.storageClass=local-storage charts/onos\n```\n\nWe strongly recommend using the `local-storage` storage class.\n\n### Application Configuration\n\nTo activate ONOS applications at startup, override the `apps` value:\n\n```\nhelm install --set apps={openflow, mcast} charts/onos\n```\n\nTo customize the Atomix configuration, override `atomix.config` and provide\na custom configuration in either JSON or HOCON format:\n\n```\nhelm install --set atomix.config=\"partitionGroups.raft {type: raft, partitions: 7}\" charts/onos\n```\n\nTo change the heap size for either ONOS or Atomix, override `heap` or `atomix.heap` respectively:\n\n```\nhelm install --set heap=4G charts/onos\n```\n\n### Upgrading Atomix\n\nHelm does not support upgrades of dependency charts. Thus, to upgrade the Atomix cluster you must manually patch the Atomix StatefulSet. First, install the ONOS chart:\n\n```\nhelm install --set atomix.image.tag=3.0.5 charts/onos\n```\n\nOnce the chart is ready, patch the Atomix image to upgrade Atomix:\n\n```\nkubectl patch statefulset iced-bison-atomix --type='json' -p='[{\"op\": \"replace\", \"path\": \"/spec/template/spec/containers/0/image\", \"value\": \"atomix/atomix:3.0.6\"}]'\n```\n\nThe Atomix pod disruption budget ensures only a single Atomix node will be down at any given time. Availability for the ONOS cluster will be maintained throughout the upgrade.\n\n[ONOS]: https://onosproject.org\n[Helm]: https://helm.sh\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopennetworkinglab%2Fonos-kubernetes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopennetworkinglab%2Fonos-kubernetes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopennetworkinglab%2Fonos-kubernetes/lists"}