k3s/vendor/k8s.io/cloud-provider/README.md

33 lines
1.2 KiB
Markdown

# cloud-provider
This repository defines the cloud-provider interface and mechanism to initialize
a cloud-provider implementation into Kubernetes. Currently multiple processes
use this code although the intent is that it will eventually only be cloud
controller manager.
**Note:** go-get or vendor this package as `k8s.io/cloud-provider`.
## Purpose
This library is a shared dependency for processes which need to be able to
integrate with cloud-provider specific functionality.
## Compatibility
Cloud Providers are expected to keep the HEAD of their implementations in sync
with the HEAD of this repository.
## Where does it come from?
`cloud-provider` is synced from
https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/cloud-provider.
Code changes are made in that location, merged into k8s.io/kubernetes and
later synced here.
## Things you should NOT do
1. Add an cloud provider specific code to this repo.
2. Directly modify anything under vendor/k8s.io/cloud-provider in this repo. Those are driven from `k8s.io/kubernetes/staging/src/k8s.io/cloud-provider`.
3. Make interface changes without first discussing them with
sig-cloudprovider.