From 5bb7943a73206ce73ee1dfe8efa50866e736a23a Mon Sep 17 00:00:00 2001 From: Andrew Kim Date: Mon, 28 Jan 2019 11:48:17 -0500 Subject: [PATCH] Draft KEPs for out-of-tree cloud providers --- .../2019-01-25-out-of-tree-aws.md | 99 +++++++++++++++++++ .../2019-01-25-out-of-tree-azure.md | 99 +++++++++++++++++++ .../2019-01-25-out-of-tree-gce.md | 99 +++++++++++++++++++ .../2019-01-25-out-of-tree-ibm.md | 99 +++++++++++++++++++ .../2019-01-25-out-of-tree-openstack.md | 99 +++++++++++++++++++ .../2019-01-25-out-of-tree-vsphere.md | 99 +++++++++++++++++++ 6 files changed, 594 insertions(+) create mode 100644 keps/sig-cloud-provider/2019-01-25-out-of-tree-aws.md create mode 100644 keps/sig-cloud-provider/2019-01-25-out-of-tree-azure.md create mode 100644 keps/sig-cloud-provider/2019-01-25-out-of-tree-gce.md create mode 100644 keps/sig-cloud-provider/2019-01-25-out-of-tree-ibm.md create mode 100644 keps/sig-cloud-provider/2019-01-25-out-of-tree-openstack.md create mode 100644 keps/sig-cloud-provider/2019-01-25-out-of-tree-vsphere.md diff --git a/keps/sig-cloud-provider/2019-01-25-out-of-tree-aws.md b/keps/sig-cloud-provider/2019-01-25-out-of-tree-aws.md new file mode 100644 index 000000000000..46188b32c41b --- /dev/null +++ b/keps/sig-cloud-provider/2019-01-25-out-of-tree-aws.md @@ -0,0 +1,99 @@ +--- +title: Support Out-of-Tree AWS Cloud Provider +authors: + - @andrewsykim +owning-sig: sig-cloud-provider +participating-sigs: + - sig-aws +reviewers: + - TBD +approvers: + - TBD +editor: TBD +creation-date: 2019-01-25 +last-updated: 2019-01-25 +status: provisional + +--- + +# Supporting Out-of-Tree AWS Cloud Provider + +## Table of Contents + +* [Table of Contents](#table-of-contents) +* [Release Signoff Checklist](#release-signoff-checklist) +* [Summary](#summary) +* [Motivation](#motivation) + * [Goals](#goals) + * [Non-Goals](#non-goals) +* [Proposal](#proposal) + * [Implementation Details/Notes/Constraints [optional]](#implementation-detailsnotesconstraints-optional) + * [Risks and Mitigations](#risks-and-mitigations) +* [Design Details](#design-details) + * [Test Plan](#test-plan) + * [Graduation Criteria](#graduation-criteria) + * [Upgrade / Downgrade Strategy](#upgrade--downgrade-strategy) + * [Version Skew Strategy](#version-skew-strategy) +* [Implementation History](#implementation-history) + +## Release Signoff Checklist + +- [X] k/enhancements issue in release milestone and linked to KEP (https://github.com/kubernetes/enhancements/issues/631) +- [ ] KEP approvers have set the KEP status to `implementable` +- [ ] Design details are appropriately documentedbs +- [ ] Test plan is in place, giving consideration to SIG Architecture and SIG Testing input +- [ ] Graduation criteria is in place +- [ ] "Implementation History" section is up-to-date for milestone +- [ ] Supporting documentation e.g., additional design documents, links to mailing list discussions/SIG meetings, relevant PRs/issues, release notes + +## Summary + +Build support for the out-of-tree AWS cloud provider. This involves a well-tested version of the cloud-controller-manager +that has feature parity to the kube-controller-manager. + +## Motivation + +Motivation for supporting out-of-tree providers can be found in [KEP-0002](https://github.com/kubernetes/enhancements/blob/master/keps/sig-cloud-provider/0002-cloud-controller-manager.md). +This KEP is specifically tracking progress for the AWS cloud provider. + +### Goals + +* Develop/test/release the AWS cloud-controller-manager +* Kubernetes clusters running on AWS should be running the cloud-controller-manager. + +### Non-Goals + +* Removing in-tree AWS cloud provider code, this effort falls under the [KEP for removing in-tree providers](https://github.com/kubernetes/enhancements/blob/master/keps/sig-cloud-provider/2019-01-25-removing-in-tree-providers.md). + +## Proposal + +### Implementation Details/Notes/Constraints [optional] + +TODO for SIG-AWS + +### Risks and Mitigations + +TODO for SIG-AWS + +## Design Details + +### Test Plan + +TODO for SIG-AWS + +### Graduation Criteria + +TODO for SIG-AWS + +### Upgrade / Downgrade Strategy + +TODO for SIG-AWS + +### Version Skew Strategy + +TODO for SIG-AWS + +## Implementation History + +TODO for SIG-AWS + diff --git a/keps/sig-cloud-provider/2019-01-25-out-of-tree-azure.md b/keps/sig-cloud-provider/2019-01-25-out-of-tree-azure.md new file mode 100644 index 000000000000..2840b7a0a4c2 --- /dev/null +++ b/keps/sig-cloud-provider/2019-01-25-out-of-tree-azure.md @@ -0,0 +1,99 @@ +--- +title: Support Out-of-Tree Azure Cloud Provider +authors: + - @andrewsykim +owning-sig: sig-cloud-provider +participating-sigs: + - sig-aws +reviewers: + - TBD +approvers: + - TBD +editor: TBD +creation-date: 2019-01-25 +last-updated: 2019-01-25 +status: provisional + +--- + +# Supporting Out-of-Tree Azure Cloud Provider + +## Table of Contents + +* [Table of Contents](#table-of-contents) +* [Release Signoff Checklist](#release-signoff-checklist) +* [Summary](#summary) +* [Motivation](#motivation) + * [Goals](#goals) + * [Non-Goals](#non-goals) +* [Proposal](#proposal) + * [Implementation Details/Notes/Constraints [optional]](#implementation-detailsnotesconstraints-optional) + * [Risks and Mitigations](#risks-and-mitigations) +* [Design Details](#design-details) + * [Test Plan](#test-plan) + * [Graduation Criteria](#graduation-criteria) + * [Upgrade / Downgrade Strategy](#upgrade--downgrade-strategy) + * [Version Skew Strategy](#version-skew-strategy) +* [Implementation History](#implementation-history) + +## Release Signoff Checklist + +- [X] k/enhancements issue in release milestone and linked to KEP (https://github.com/kubernetes/enhancements/issues/667) +- [ ] KEP approvers have set the KEP status to `implementable` +- [ ] Design details are appropriately documentedbs +- [ ] Test plan is in place, giving consideration to SIG Architecture and SIG Testing input +- [ ] Graduation criteria is in place +- [ ] "Implementation History" section is up-to-date for milestone +- [ ] Supporting documentation e.g., additional design documents, links to mailing list discussions/SIG meetings, relevant PRs/issues, release notes + +## Summary + +Build support for the out-of-tree Azure cloud provider. This involves a well-tested version of the cloud-controller-manager +that has feature parity to the kube-controller-manager. + +## Motivation + +Motivation for supporting out-of-tree providers can be found in [KEP-0002](https://github.com/kubernetes/enhancements/blob/master/keps/sig-cloud-provider/0002-cloud-controller-manager.md). +This KEP is specifically tracking progress for the Azure cloud provider. + +### Goals + +* Develop/test/release the Azure cloud-controller-manager +* Kubernetes clusters running on Azure should be running the cloud-controller-manager. + +### Non-Goals + +* Removing in-tree Azure cloud provider code, this effort falls under the [KEP for removing in-tree providers](https://github.com/kubernetes/enhancements/blob/master/keps/sig-cloud-provider/2019-01-25-removing-in-tree-providers.md). + +## Proposal + +### Implementation Details/Notes/Constraints [optional] + +TODO for SIG-Azure + +### Risks and Mitigations + +TODO for SIG-Azure + +## Design Details + +### Test Plan + +TODO for SIG-Azure + +### Graduation Criteria + +TODO for SIG-Azure + +### Upgrade / Downgrade Strategy + +TODO for SIG-Azure + +### Version Skew Strategy + +TODO for SIG-Azure + +## Implementation History + +TODO for SIG-Azure + diff --git a/keps/sig-cloud-provider/2019-01-25-out-of-tree-gce.md b/keps/sig-cloud-provider/2019-01-25-out-of-tree-gce.md new file mode 100644 index 000000000000..1846044a6c62 --- /dev/null +++ b/keps/sig-cloud-provider/2019-01-25-out-of-tree-gce.md @@ -0,0 +1,99 @@ +--- +title: Support Out-of-Tree GCE Cloud Provider +authors: + - @andrewsykim +owning-sig: sig-cloud-provider +participating-sigs: + - sig-aws +reviewers: + - TBD +approvers: + - TBD +editor: TBD +creation-date: 2019-01-25 +last-updated: 2019-01-25 +status: provisional + +--- + +# Supporting Out-of-Tree GCE Cloud Provider + +## Table of Contents + +* [Table of Contents](#table-of-contents) +* [Release Signoff Checklist](#release-signoff-checklist) +* [Summary](#summary) +* [Motivation](#motivation) + * [Goals](#goals) + * [Non-Goals](#non-goals) +* [Proposal](#proposal) + * [Implementation Details/Notes/Constraints [optional]](#implementation-detailsnotesconstraints-optional) + * [Risks and Mitigations](#risks-and-mitigations) +* [Design Details](#design-details) + * [Test Plan](#test-plan) + * [Graduation Criteria](#graduation-criteria) + * [Upgrade / Downgrade Strategy](#upgrade--downgrade-strategy) + * [Version Skew Strategy](#version-skew-strategy) +* [Implementation History](#implementation-history) + +## Release Signoff Checklist + +- [X] k/enhancements issue in release milestone and linked to KEP (https://github.com/kubernetes/enhancements/issues/668) +- [ ] KEP approvers have set the KEP status to `implementable` +- [ ] Design details are appropriately documentedbs +- [ ] Test plan is in place, giving consideration to SIG Architecture and SIG Testing input +- [ ] Graduation criteria is in place +- [ ] "Implementation History" section is up-to-date for milestone +- [ ] Supporting documentation e.g., additional design documents, links to mailing list discussions/SIG meetings, relevant PRs/issues, release notes + +## Summary + +Build support for the out-of-tree GCE cloud provider. This involves a well-tested version of the cloud-controller-manager +that has feature parity to the kube-controller-manager. + +## Motivation + +Motivation for supporting out-of-tree providers can be found in [KEP-0002](https://github.com/kubernetes/enhancements/blob/master/keps/sig-cloud-provider/0002-cloud-controller-manager.md). +This KEP is specifically tracking progress for the GCE cloud provider. + +### Goals + +* Develop/test/release the GCE cloud-controller-manager +* Kubernetes clusters running on GCE should be running the cloud-controller-manager. + +### Non-Goals + +* Removing in-tree GCE cloud provider code, this effort falls under the [KEP for removing in-tree providers](https://github.com/kubernetes/enhancements/blob/master/keps/sig-cloud-provider/2019-01-25-removing-in-tree-providers.md). + +## Proposal + +### Implementation Details/Notes/Constraints [optional] + +TODO for SIG-GCP + +### Risks and Mitigations + +TODO for SIG-GCP + +## Design Details + +### Test Plan + +TODO for SIG-GCP + +### Graduation Criteria + +TODO for SIG-GCP + +### Upgrade / Downgrade Strategy + +TODO for SIG-GCP + +### Version Skew Strategy + +TODO for SIG-GCP + +## Implementation History + +TODO for SIG-GCP + diff --git a/keps/sig-cloud-provider/2019-01-25-out-of-tree-ibm.md b/keps/sig-cloud-provider/2019-01-25-out-of-tree-ibm.md new file mode 100644 index 000000000000..f283833cdacb --- /dev/null +++ b/keps/sig-cloud-provider/2019-01-25-out-of-tree-ibm.md @@ -0,0 +1,99 @@ +--- +title: Support Out-of-Tree IBM Cloud Provider +authors: + - @andrewsykim +owning-sig: sig-cloud-provider +participating-sigs: + - sig-aws +reviewers: + - TBD +approvers: + - TBD +editor: TBD +creation-date: 2019-01-25 +last-updated: 2019-01-25 +status: provisional + +--- + +# Supporting Out-of-Tree IBM Cloud Provider + +## Table of Contents + +* [Table of Contents](#table-of-contents) +* [Release Signoff Checklist](#release-signoff-checklist) +* [Summary](#summary) +* [Motivation](#motivation) + * [Goals](#goals) + * [Non-Goals](#non-goals) +* [Proposal](#proposal) + * [Implementation Details/Notes/Constraints [optional]](#implementation-detailsnotesconstraints-optional) + * [Risks and Mitigations](#risks-and-mitigations) +* [Design Details](#design-details) + * [Test Plan](#test-plan) + * [Graduation Criteria](#graduation-criteria) + * [Upgrade / Downgrade Strategy](#upgrade--downgrade-strategy) + * [Version Skew Strategy](#version-skew-strategy) +* [Implementation History](#implementation-history) + +## Release Signoff Checklist + +- [X] k/enhancements issue in release milestone and linked to KEP (https://github.com/kubernetes/enhancements/issues/671) +- [ ] KEP approvers have set the KEP status to `implementable` +- [ ] Design details are appropriately documentedbs +- [ ] Test plan is in place, giving consideration to SIG Architecture and SIG Testing input +- [ ] Graduation criteria is in place +- [ ] "Implementation History" section is up-to-date for milestone +- [ ] Supporting documentation e.g., additional design documents, links to mailing list discussions/SIG meetings, relevant PRs/issues, release notes + +## Summary + +Build support for the out-of-tree IBM cloud provider. This involves a well-tested version of the cloud-controller-manager +that has feature parity to the kube-controller-manager. + +## Motivation + +Motivation for supporting out-of-tree providers can be found in [KEP-0002](https://github.com/kubernetes/enhancements/blob/master/keps/sig-cloud-provider/0002-cloud-controller-manager.md). +This KEP is specifically tracking progress for the IBM cloud provider. + +### Goals + +* Develop/test/release the IBM cloud-controller-manager +* Kubernetes clusters running on IBM should be running the cloud-controller-manager. + +### Non-Goals + +* Removing in-tree IBM cloud provider code, this effort falls under the [KEP for removing in-tree providers](https://github.com/kubernetes/enhancements/blob/master/keps/sig-cloud-provider/2019-01-25-removing-in-tree-providers.md). + +## Proposal + +### Implementation Details/Notes/Constraints [optional] + +TODO for SIG-IBM + +### Risks and Mitigations + +TODO for SIG-IBM + +## Design Details + +### Test Plan + +TODO for SIG-IBM + +### Graduation Criteria + +TODO for SIG-IBM + +### Upgrade / Downgrade Strategy + +TODO for SIG-IBM + +### Version Skew Strategy + +TODO for SIG-IBM + +## Implementation History + +TODO for SIG-IBM + diff --git a/keps/sig-cloud-provider/2019-01-25-out-of-tree-openstack.md b/keps/sig-cloud-provider/2019-01-25-out-of-tree-openstack.md new file mode 100644 index 000000000000..5bddafbcaeb6 --- /dev/null +++ b/keps/sig-cloud-provider/2019-01-25-out-of-tree-openstack.md @@ -0,0 +1,99 @@ +--- +title: Support Out-of-Tree OpenStack Cloud Provider +authors: + - @andrewsykim +owning-sig: sig-cloud-provider +participating-sigs: + - sig-aws +reviewers: + - TBD +approvers: + - TBD +editor: TBD +creation-date: 2019-01-25 +last-updated: 2019-01-25 +status: provisional + +--- + +# Supporting Out-of-Tree OpenStack Cloud Provider + +## Table of Contents + +* [Table of Contents](#table-of-contents) +* [Release Signoff Checklist](#release-signoff-checklist) +* [Summary](#summary) +* [Motivation](#motivation) + * [Goals](#goals) + * [Non-Goals](#non-goals) +* [Proposal](#proposal) + * [Implementation Details/Notes/Constraints [optional]](#implementation-detailsnotesconstraints-optional) + * [Risks and Mitigations](#risks-and-mitigations) +* [Design Details](#design-details) + * [Test Plan](#test-plan) + * [Graduation Criteria](#graduation-criteria) + * [Upgrade / Downgrade Strategy](#upgrade--downgrade-strategy) + * [Version Skew Strategy](#version-skew-strategy) +* [Implementation History](#implementation-history) + +## Release Signoff Checklist + +- [X] k/enhancements issue in release milestone and linked to KEP (https://github.com/kubernetes/enhancements/issues/669) +- [ ] KEP approvers have set the KEP status to `implementable` +- [ ] Design details are appropriately documentedbs +- [ ] Test plan is in place, giving consideration to SIG Architecture and SIG Testing input +- [ ] Graduation criteria is in place +- [ ] "Implementation History" section is up-to-date for milestone +- [ ] Supporting documentation e.g., additional design documents, links to mailing list discussions/SIG meetings, relevant PRs/issues, release notes + +## Summary + +Build support for the out-of-tree OpenStack cloud provider. This involves a well-tested version of the cloud-controller-manager +that has feature parity to the kube-controller-manager. + +## Motivation + +Motivation for supporting out-of-tree providers can be found in [KEP-0002](https://github.com/kubernetes/enhancements/blob/master/keps/sig-cloud-provider/0002-cloud-controller-manager.md). +This KEP is specifically tracking progress for the OpenStack cloud provider. + +### Goals + +* Develop/test/release the OpenStack cloud-controller-manager +* Kubernetes clusters running on OpenStack should be running the cloud-controller-manager. + +### Non-Goals + +* Removing in-tree OpenStack cloud provider code, this effort falls under the [KEP for removing in-tree providers](https://github.com/kubernetes/enhancements/blob/master/keps/sig-cloud-provider/2019-01-25-removing-in-tree-providers.md). + +## Proposal + +### Implementation Details/Notes/Constraints [optional] + +TODO for SIG-OpenStack + +### Risks and Mitigations + +TODO for SIG-OpenStack + +## Design Details + +### Test Plan + +TODO for SIG-OpenStack + +### Graduation Criteria + +TODO for SIG-OpenStack + +### Upgrade / Downgrade Strategy + +TODO for SIG-OpenStack + +### Version Skew Strategy + +TODO for SIG-OpenStack + +## Implementation History + +TODO for SIG-OpenStack + diff --git a/keps/sig-cloud-provider/2019-01-25-out-of-tree-vsphere.md b/keps/sig-cloud-provider/2019-01-25-out-of-tree-vsphere.md new file mode 100644 index 000000000000..ccee85333476 --- /dev/null +++ b/keps/sig-cloud-provider/2019-01-25-out-of-tree-vsphere.md @@ -0,0 +1,99 @@ +--- +title: Support Out-of-Tree vSphere Cloud Provider +authors: + - @andrewsykim +owning-sig: sig-cloud-provider +participating-sigs: + - sig-aws +reviewers: + - TBD +approvers: + - TBD +editor: TBD +creation-date: 2019-01-25 +last-updated: 2019-01-25 +status: provisional + +--- + +# Supporting Out-of-Tree vSphere Cloud Provider + +## Table of Contents + +* [Table of Contents](#table-of-contents) +* [Release Signoff Checklist](#release-signoff-checklist) +* [Summary](#summary) +* [Motivation](#motivation) + * [Goals](#goals) + * [Non-Goals](#non-goals) +* [Proposal](#proposal) + * [Implementation Details/Notes/Constraints [optional]](#implementation-detailsnotesconstraints-optional) + * [Risks and Mitigations](#risks-and-mitigations) +* [Design Details](#design-details) + * [Test Plan](#test-plan) + * [Graduation Criteria](#graduation-criteria) + * [Upgrade / Downgrade Strategy](#upgrade--downgrade-strategy) + * [Version Skew Strategy](#version-skew-strategy) +* [Implementation History](#implementation-history) + +## Release Signoff Checklist + +- [X] k/enhancements issue in release milestone and linked to KEP (https://github.com/kubernetes/enhancements/issues/670) +- [ ] KEP approvers have set the KEP status to `implementable` +- [ ] Design details are appropriately documentedbs +- [ ] Test plan is in place, giving consideration to SIG Architecture and SIG Testing input +- [ ] Graduation criteria is in place +- [ ] "Implementation History" section is up-to-date for milestone +- [ ] Supporting documentation e.g., additional design documents, links to mailing list discussions/SIG meetings, relevant PRs/issues, release notes + +## Summary + +Build support for the out-of-tree vSphere cloud provider. This involves a well-tested version of the cloud-controller-manager +that has feature parity to the kube-controller-manager. + +## Motivation + +Motivation for supporting out-of-tree providers can be found in [KEP-0002](https://github.com/kubernetes/enhancements/blob/master/keps/sig-cloud-provider/0002-cloud-controller-manager.md). +This KEP is specifically tracking progress for the vSphere cloud provider. + +### Goals + +* Develop/test/release the vSphere cloud-controller-manager +* Kubernetes clusters running on vSphere should be running the cloud-controller-manager. + +### Non-Goals + +* Removing in-tree vSphere cloud provider code, this effort falls under the [KEP for removing in-tree providers](https://github.com/kubernetes/enhancements/blob/master/keps/sig-cloud-provider/2019-01-25-removing-in-tree-providers.md). + +## Proposal + +### Implementation Details/Notes/Constraints [optional] + +TODO for SIG-VMware + +### Risks and Mitigations + +TODO for SIG-VMware + +## Design Details + +### Test Plan + +TODO for SIG-VMware + +### Graduation Criteria + +TODO for SIG-VMware + +### Upgrade / Downgrade Strategy + +TODO for SIG-VMware + +### Version Skew Strategy + +TODO for SIG-VMware + +## Implementation History + +TODO for SIG-VMware +