{"id":13819994,"url":"https://github.com/kubevirt/cloud-provider-kubevirt","last_synced_at":"2026-03-04T09:04:24.144Z","repository":{"id":37397571,"uuid":"159406434","full_name":"kubevirt/cloud-provider-kubevirt","owner":"kubevirt","description":"Kubernetes cloud-provider for KubeVirt","archived":false,"fork":false,"pushed_at":"2025-05-23T04:12:16.000Z","size":107138,"stargazers_count":82,"open_issues_count":10,"forks_count":36,"subscribers_count":9,"default_branch":"main","last_synced_at":"2025-05-25T11:03:43.842Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/kubevirt.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2018-11-27T22:10:55.000Z","updated_at":"2025-04-21T05:45:46.000Z","dependencies_parsed_at":"2024-04-17T05:30:43.544Z","dependency_job_id":"64565b28-2e43-48b9-9656-97cc2c152748","html_url":"https://github.com/kubevirt/cloud-provider-kubevirt","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/kubevirt/cloud-provider-kubevirt","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubevirt%2Fcloud-provider-kubevirt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubevirt%2Fcloud-provider-kubevirt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubevirt%2Fcloud-provider-kubevirt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubevirt%2Fcloud-provider-kubevirt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kubevirt","download_url":"https://codeload.github.com/kubevirt/cloud-provider-kubevirt/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubevirt%2Fcloud-provider-kubevirt/sbom","scorecard":{"id":572783,"data":{"date":"2025-08-11","repo":{"name":"github.com/kubevirt/cloud-provider-kubevirt","commit":"a0acf3389a24069e16eedb544ed90d2733fbce92"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":4.4,"checks":[{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Code-Review","score":7,"reason":"Found 11/15 approved changesets -- score normalized to 7","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/publish.yaml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: Apache License 2.0: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: githubv4.Query: Resource not accessible by integration","details":null,"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact v0.5.1 not signed: https://api.github.com/repos/kubevirt/cloud-provider-kubevirt/releases/121309758","Warn: release artifact v0.5.0 not signed: https://api.github.com/repos/kubevirt/cloud-provider-kubevirt/releases/121145948","Warn: release artifact v0.4.0 not signed: https://api.github.com/repos/kubevirt/cloud-provider-kubevirt/releases/81315144","Warn: release artifact v0.3.2 not signed: https://api.github.com/repos/kubevirt/cloud-provider-kubevirt/releases/77555665","Warn: release artifact v0.3.1 not signed: https://api.github.com/repos/kubevirt/cloud-provider-kubevirt/releases/77526826","Warn: release artifact v0.5.1 does not have provenance: https://api.github.com/repos/kubevirt/cloud-provider-kubevirt/releases/121309758","Warn: release artifact v0.5.0 does not have provenance: https://api.github.com/repos/kubevirt/cloud-provider-kubevirt/releases/121145948","Warn: release artifact v0.4.0 does not have provenance: https://api.github.com/repos/kubevirt/cloud-provider-kubevirt/releases/81315144","Warn: release artifact v0.3.2 does not have provenance: https://api.github.com/repos/kubevirt/cloud-provider-kubevirt/releases/77555665","Warn: release artifact v0.3.1 does not have provenance: https://api.github.com/repos/kubevirt/cloud-provider-kubevirt/releases/77526826"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Security-Policy","score":10,"reason":"security policy file detected","details":["Info: security policy file detected: github.com/kubevirt/.github/SECURITY.md:1","Info: Found linked content: github.com/kubevirt/.github/SECURITY.md:1","Info: Found disclosure, vulnerability, and/or timelines in security policy: github.com/kubevirt/.github/SECURITY.md:1","Info: Found text in security policy: github.com/kubevirt/.github/SECURITY.md:1"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 28 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Pinned-Dependencies","score":1,"reason":"dependency not pinned by hash detected -- score normalized to 1","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish.yaml:19: update your workflow using https://app.stepsecurity.io/secureworkflow/kubevirt/cloud-provider-kubevirt/publish.yaml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/publish.yaml:20: update your workflow using https://app.stepsecurity.io/secureworkflow/kubevirt/cloud-provider-kubevirt/publish.yaml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish.yaml:23: update your workflow using https://app.stepsecurity.io/secureworkflow/kubevirt/cloud-provider-kubevirt/publish.yaml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/publish.yaml:37: update your workflow using https://app.stepsecurity.io/secureworkflow/kubevirt/cloud-provider-kubevirt/publish.yaml/main?enable=pin","Warn: containerImage not pinned by hash: build/images/kubevirt-cloud-controller-manager/Dockerfile:1","Warn: containerImage not pinned by hash: build/images/kubevirt-cloud-controller-manager/Dockerfile:13: pin your Docker image by updating registry.access.redhat.com/ubi9/ubi-micro to registry.access.redhat.com/ubi9/ubi-micro@sha256:f5c5213d2969b7b11a6666fc4b849d56b48d9d7979b60a37bb853dff0255c14b","Warn: goCommand not pinned by hash: vendor/github.com/json-iterator/go/build.sh:10","Warn: goCommand not pinned by hash: vendor/google.golang.org/grpc/regenerate.sh:35","Warn: goCommand not pinned by hash: vendor/google.golang.org/grpc/vet.sh:37","Info:   0 out of   2 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   2 third-party GitHubAction dependencies pinned","Info:   1 out of   4 goCommand dependencies pinned","Info:   0 out of   2 containerImage dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Vulnerabilities","score":6,"reason":"4 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GO-2024-3333","Warn: Project is vulnerable to: GO-2025-3503 / GHSA-qxp5-gwg8-xv66","Warn: Project is vulnerable to: GO-2025-3595 / GHSA-vvgc-356p-c3xw","Warn: Project is vulnerable to: GO-2025-3488 / GHSA-6v2p-p543-phr9"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-20T16:47:27.786Z","repository_id":37397571,"created_at":"2025-08-20T16:47:27.787Z","updated_at":"2025-08-20T16:47:27.787Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30076935,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-04T08:01:56.766Z","status":"ssl_error","status_checked_at":"2026-03-04T08:00:42.919Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":[],"created_at":"2024-08-04T08:00:56.552Z","updated_at":"2026-03-04T09:04:24.128Z","avatar_url":"https://github.com/kubevirt.png","language":"Go","funding_links":[],"categories":["others","Go"],"sub_categories":[],"readme":"# cloud-provider-kubevirt\n[![Build Status](https://travis-ci.org/kubevirt/cloud-provider-kubevirt.svg?branch=master)](https://travis-ci.org/kubevirt/cloud-provider-kubevirt)\n[![Go Report Card](https://goreportcard.com/badge/github.com/kubevirt/cloud-provider-kubevirt)](https://goreportcard.com/report/github.com/kubevirt/cloud-provider-kubevirt)\n\nThe KubeVirt cloud-provider allows you to use KubeVirt and Kubernetes as a \"cloud\" to run Kubernetes clusters on top.\nThis project contains the `kubevirt-cloud-controller-manager`, an implementation of the cloud controller manager (see\n[Concepts Underlying the Cloud Controller Manager](https://kubernetes.io/docs/concepts/architecture/cloud-controller/)\nfor more details).\n\n## Introduction\nThe KubeVirt cloud-provider allows a Kubernetes cluster running in KubeVirt VMs (tenant cluster) to\ninteract with KubeVirt and Kubernetes (infrastructure cluster) to provision, manage and clean up resources. For example, the\ncloud-provider ensures that [zone and region\nlabels](https://kubernetes.io/docs/reference/kubernetes-api/labels-annotations-taints/#failure-domainbetakubernetesiozone)\nof nodes in the tenant cluster are set based on the zone and region of the KubeVirt VMs in the infrastructure cluster.\nThe cloud-provider also ensures tenant cluster services of type\n[LoadBalancer](https://kubernetes.io/docs/concepts/services-networking/service/#loadbalancer) are properly exposed\nthrough services in the UnderKube.\n\n## Prerequisites\nIn order to have the LoadBalancer logic working in the \"tenant KubeVirt cluster, user must make sure the the KubeVirt\nVMs, used for the tenant cluster nodes, are created with the following labels:\n```shell\ncluster.x-k8s.io/cluster-name: \u003ctenant-cluster-name\u003e\ncluster.x-k8s.io/role: worker\n```\nThose labels are used by the infra cluster services as a NodeSelector - traffic from the\ninfra cluster services created for the tenant cluster is redirected into VM with those Labels\n\n## How to run `kubevirt-cloud-controller-manager`\nSee [Running cloud-controller-manager](https://kubernetes.io/docs/tasks/administer-cluster/running-cloud-controller/#running-cloud-controller-manager)\nfor general information on how to configure your tenant cluster to run `kubevirt-cloud-controller-manager`. You can\nfind example manifests for `kubevirt-cloud-controller-manager` in the [manifests directory](cluster/manifests) for\nstatic Pod, Deployment and DaemonSet configurations.\n\nTo get it to run, you'll need to provide a kubeconfig for the infrastructure cluster to the `kubevirt-cloud-controller-manager` configuration.\nThe configuration should contain an `kubeconfig` key, like in the following example:\n```shell\ncat /etc/kubernetes/cloud/config\n```\nOutput:\n```yaml\nkubeconfig: \u003cinfraKubeConfigPath\u003e\nloadBalancer:\n  creationPollInterval: 5\n  creationPollTimeout: 60\n```\n\n## How to build a Docker image\nWith `make image` you can build a [Docker image](build/images/kubevirt-cloud-controller-manager) containing `kubevirt-cloud-controller-manager`.\n\n## Development\n### Create a cloud config\nFirst create a cloud config file in the project directory\n```shell\ntouch dev/cloud-config\n```\nNext add a kubeconfig path to the cloud-config file.\nThe kubeconfig must point to the infrastructure cluster where KubeVirt is installed.\n```shell\nkubeconfig: \u003cinfraKubeConfigPath\u003e\n```\nFor more configuration options look at the\n[cloud configuration](https://github.com/kubevirt/cloud-provider-kubevirt/blob/main/pkg/cloudprovider/kubevirt/cloud.go#L30) \n\n### Build KubeVirt CCM\nBuild `kubevirt-cloud-controller-manager` using `make build`. It will put the finished binary in\n`bin/kubevirt-cloud-controller-manager`. \n\n### Run KubeVirt CCM\nRun the following command:\n```shell\nbin/kubevirt-cloud-controller-manager --kubeconfig \u003cpath-to-tenant-cluster-kubeconfig\u003e --cloud-config dev/cloud-config \n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkubevirt%2Fcloud-provider-kubevirt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkubevirt%2Fcloud-provider-kubevirt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkubevirt%2Fcloud-provider-kubevirt/lists"}