{"id":18690474,"url":"https://github.com/kvaps/kube-opennebula","last_synced_at":"2025-10-04T10:02:08.037Z","repository":{"id":48492339,"uuid":"121171922","full_name":"kvaps/kube-opennebula","owner":"kvaps","description":"  Helm chart and OpenNebula images ready to deploy on Kubernetes","archived":false,"fork":false,"pushed_at":"2023-01-30T20:33:23.000Z","size":286,"stargazers_count":48,"open_issues_count":3,"forks_count":11,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-12T05:54:28.774Z","etag":null,"topics":["chart","docker","helm","kubernetes","opennebula"],"latest_commit_sha":null,"homepage":"","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/kvaps.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-02-11T22:04:52.000Z","updated_at":"2024-10-26T15:21:21.000Z","dependencies_parsed_at":"2023-02-16T11:15:26.467Z","dependency_job_id":null,"html_url":"https://github.com/kvaps/kube-opennebula","commit_stats":null,"previous_names":[],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kvaps%2Fkube-opennebula","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kvaps%2Fkube-opennebula/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kvaps%2Fkube-opennebula/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kvaps%2Fkube-opennebula/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kvaps","download_url":"https://codeload.github.com/kvaps/kube-opennebula/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248525156,"owners_count":21118616,"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":["chart","docker","helm","kubernetes","opennebula"],"created_at":"2024-11-07T10:47:41.113Z","updated_at":"2025-10-04T10:02:07.984Z","avatar_url":"https://github.com/kvaps.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Kube-OpenNebula\n\n![](https://opennebula.org/wp-content/uploads/2019/04/img-logo-blue.svg)\n\nHelm chart and OpenNebula images ready to deploy on Kubernetes\n\n## Quick start\n\n### Control plane\n\n* Create namespace:\n  \n  ```bash\n  kubectl create namespace opennebula\n  ```\n\n* Install Helm repo:\n\n  ```bash\n  helm repo add kvaps https://kvaps.github.io/charts\n  ```\n  \n* Deploy OpenNebula:\n  \n  ```bash\n  # download example values\n  helm show values kvaps/opennebula --version 1.2.0 \u003e values.yaml\n\n  # install release\n  helm install opennebula kvaps/opennebula --version 1.2.0 \\\n    --namespace opennebula \\\n    --set oned.createCluster=1 \\\n    -f values.yaml \\\n    --wait\n  ```\n\n### Compute nodes\n\n* To deploy external compute node your hosts should have `libvirtd` and `qemu-kvm` installed and configured [sudoers](https://github.com/OpenNebula/one/tree/release-5.10.1/share/pkgs/sudoers).  \n  However you can just [install `opennebula-node`](https://docs.opennebula.org/5.10/deployment/node_installation/kvm_node_installation.html) meta-package.\n\n* Get OpenNebula's ssh-key, and place it to `/var/lib/one/.ssh/authorized_keys` on every node to allow OpenNebula login via ssh.\n  ```bash\n  kubectl exec opennebula-opennebula-oned-0 -c oned -- ssh-keygen -y -f /var/lib/one/.ssh/id_rsa\n  ```\n\n* Create new host via OpenNebula Interface.\n\n\n* Check is everything is fine  \n  You should be able login via ssh from oned pod to every node. You can check that by executing the following command:\n  ```bash\n  kubectl exec -ti opennebula-opennebula-oned-0 ssh \u003cnode\u003e\n  ```\n\n## Customization\n\nSometimes you need to perform some customization, eg. update sunstone views and addtitional drivers, etc.\n\nAll these customizations could be done by updating dockerimages, you can find some examples [here](examples/prod/dockerfiles), or by simple using `extraVolumes` and `extraVolumeMounts` in chart values.\n\n## Production setup\n\nProduction install assumes having persistent storage.\n\nOpenNebula requires one ReadWriteOnce persistent volume per each oned-instance where database files will be stored, even [local volumes](https://kubernetes.io/blog/2019/04/04/kubernetes-1.14-local-persistent-volumes-ga/) enough for that, however it also requires one shared (ReadWriteMany) persistent volume for virtual machine logs and vnc tokens, take a look at [nfs-server-provisioner](https://github.com/helm/charts/tree/master/stable/nfs-server-provisioner) if you'r storage does not support ReadWriteMany.\n\nExample production configuration can be found [here](examples/prod/deploy)\n\n## Backups and restore\n\nFind current leader:\n\n```\nkubectl get pod -n opennebula -l role=leader\n```\n\nPerform backup:\n```\nkubectl exec -n opennebula -c oned \u003cleader_pod\u003e -- sh -c 'mysqldump -h$DB_SERVER -u$DB_USER -p$DB_PASSWD $DB_NAME | gzip -9' \u003e opennebula-db.sql.gz\n```\n\n**To restore**, redeploy release with `--set oned.debug=true` and:\n```\nkubectl exec -n opennebula -i -c oned \u003ceach_oned_pod\u003e -- sh -c 'zcat | mysql -h$DB_SERVER -u$DB_USER -p$DB_PASSWD -D$DB_NAME' \u003c opennebula-db.sql.gz\n```\n\nthen disable debug\n\n\n## Upgrade notes\n\n```\nkubectl get pod -n opennebula -l role=leader\n```\n\nPerform backup:\n```\nkubectl exec -n opennebula -c oned \u003cleader_pod\u003e -- sh -c 'mysqldump -h$DB_SERVER -u$DB_USER -p$DB_PASSWD $DB_NAME | gzip -9' \u003e opennebula-db.sql.gz\n```\n\n**To restore**, redeploy release with `--set oned.debug=true` and:\n```\nkubectl exec -n opennebula -i -c oned \u003ceach_oned_pod\u003e -- sh -c 'zcat | mysql -h$DB_SERVER -u$DB_USER -p$DB_PASSWD -D$DB_NAME' \u003c opennebula-db.sql.gz\n```\n\nthen disable debug\n\n\n## Upgrade notes\n\nThe minor upgrades can be performed by standard way using rolling update, however major updates must be performed by fully chart reinstallation.  \nYou have to remove the old chart, and install new one. No worry as your data should be saved on persistent volumes, thus new images will perform database migration on their first start.\n\n\u003e **Warning:** Don't forget to make backup before the upgrade!\n\nMinor upgrade:\n```bash\nhelm upgrade opennebula kvaps/opennebula --version 1.2.0 \\\n  --namespace opennebula \\\n  -f values.yaml \\\n  --wait\n```\n\nMajor upgrade:\n```bash\n# Remove the chart\nhelm remove opennebula \\\n  --namespace opennebula\n\n# Deploy the new chart\nhelm upgrade opennebula kvaps/opennebula --version 1.2.0 \\\n  --namespace opennebula \\\n  -f values.yaml \\\n  --wait\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkvaps%2Fkube-opennebula","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkvaps%2Fkube-opennebula","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkvaps%2Fkube-opennebula/lists"}