README ¶
Deprecation Notice: cloud providers in this directory are deprecated and will be removed in favor of external (a.k.a out-of-tree) providers. Existing providers in this directory (a.k.a in-tree providers) should only make small incremental changes as needed and avoid large refactors or new features. New providers seeking to support Kubernetes should follow the out-of-tree model as specified in the Running Kubernetes Cloud Controller Manager docs. For more information on the future of Kubernetes cloud providers see KEP-0002 and KEP-0013.
Cloud Providers in this directory will continue to be actively developed or maintained and supported at their current level of support as a longer-term solution evolves.
Overview:The mechanism for supporting cloud providers is currently in transition: the original method of implementing cloud provider-specific functionality within the main kubernetes tree (here) is no longer advised; however, the proposed solution is still in development.
Guidance for potential cloud providers:
- Support for cloud providers is currently in a state of flux. Background information on motivation and the proposal for improving is in the github proposal.
- In support of this plan, a new cloud-controller-manager binary was added in 1.6. This was the first of several steps (see the proposal for more information).
- Attempts to contribute new cloud providers or (to a lesser extent) persistent volumes to the core repo will likely meet with some pushback from reviewers/approvers.
- It is understood that this is an unfortunate situation in which 'the old way is no longer supported but the new way is not ready yet', but the initial path is unsustainable, and contributors are encouraged to participate in the implementation of the proposed long-term solution, as there is risk that PRs for new cloud providers here will not be approved.
- Though the fully productized support envisioned in the proposal is still 2 - 3 releases out, the foundational work is underway, and a motivated cloud provider could accomplish the work in a forward-looking way. Contributors are encouraged to assist with the implementation of the design outlined in the proposal.
Some additional context on status / direction:
- 1.6 added a new cloud-controller-manager binary that may be used for testing the new out-of-core cloudprovider flow.
- Setting cloud-provider=external allows for creation of a separate controller-manager binary
- 1.7 adds extensible admission control, further enabling topology customization.
Documentation ¶
Overview ¶
Package cloudprovider supplies interfaces and implementations for cloud service providers. To use: import cloudprovider "k8s.io/cloud-provider"
Directories ¶
Path | Synopsis |
---|---|
fake
Package fake is a test-double implementation of cloudprovider Interface, LoadBalancer and Instances.
|
Package fake is a test-double implementation of cloudprovider Interface, LoadBalancer and Instances. |
gce
Package gce is an implementation of Interface, LoadBalancer and Instances for Google Compute Engine.
|
Package gce is an implementation of Interface, LoadBalancer and Instances for Google Compute Engine. |
gce/cloud
Package cloud implements a more golang friendly interface to the GCE compute API.
|
Package cloud implements a more golang friendly interface to the GCE compute API. |
gce/cloud/filter
Package filter encapsulates the filter argument to compute API calls.
|
Package filter encapsulates the filter argument to compute API calls. |
gce/cloud/gen
Generator for GCE compute wrapper code.
|
Generator for GCE compute wrapper code. |
gce/cloud/meta
Package meta contains the meta description of the GCE cloud types to generate code for.
|
Package meta contains the meta description of the GCE cloud types to generate code for. |
gce/cloud/mock
Package mock encapsulates mocks for testing GCE provider functionality.
|
Package mock encapsulates mocks for testing GCE provider functionality. |
photon
This version of Photon cloud provider supports the disk interface for Photon persistent disk volume plugin.
|
This version of Photon cloud provider supports the disk interface for Photon persistent disk volume plugin. |
Click to show internal directories.
Click to hide internal directories.