https://github.com/kubernetes/cloud-provider-aws

Cloud provider for AWS
https://github.com/kubernetes/cloud-provider-aws

k8s-sig-cloud-provider

Last synced: 5 days ago
JSON representation

Cloud provider for AWS

• Host: GitHub
• URL: https://github.com/kubernetes/cloud-provider-aws
• Owner: kubernetes
• License: apache-2.0
• Created: 2018-03-21T06:09:43.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2024-12-10T18:40:04.000Z (11 days ago)
• Last Synced: 2024-12-10T19:47:05.217Z (11 days ago)
• Topics: k8s-sig-cloud-provider
• Language: Go
• Homepage: https://cloud-provider-aws.sigs.k8s.io/
• Size: 12.2 MB
• Stars: 401
• Watchers: 25
• Forks: 309
• Open Issues: 20
• Metadata Files:
  • Readme: docs/README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: code-of-conduct.md
  • Security: SECURITY.md

Awesome Lists containing this project

README

        


    

    





    

        The

         AWS 

        Cloud Provider for

         Kubernetes 

    





    

        

    

    

        

    

    

        

    

    





    

        

    

    

        

    

    

        

    



# cloud-provider-aws

The AWS cloud provider provides the interface between a Kubernetes cluster and AWS service APIs. This project allows a Kubernetes cluster to provision, monitor and remove AWS resources necessary for operation of the cluster.



    See the online documentation here



## Compatibility with Kubernetes

The AWS cloud provider is released with a specific semantic version that correlates with the Kubernetes upstream version. The major and minor versions are equivalent to the compatible upstream release, and the patch version is reserved to denote subsequent releases of the cloud provider code for that Kubernetes release.  Currently, for a given cloud provider release version, compatibility is ONLY guaranteed between that release and the corresponding Kubernetes version, meaning you need to upgrade the cloud provider components every time you upgrade Kubernetes, just like you would do for the kube controller manager.  See the [external cloud provider versioning KEP](https://github.com/kubernetes/enhancements/tree/master/keps/sig-cloud-provider/1771-versioning-policy-for-external-cloud-providers) for more details.

## Migration from In-Tree

The in-tree cloud provider code has mostly stopped accepting new features, so future development for the AWS cloud provider should continue here.  The in-tree plugins will be removed in a future release of Kubernetes.

## Components

### AWS Cloud Controller Manager

The AWS Cloud Controller Manager is the controller that is primarily responsible for creating and updating AWS loadbalancers (classic and NLB) and node lifecycle management.  The controller loops that are migrating out of the kube controller manager include the route controller, the service controller, the node controller, and the node lifecycle controller.  See the [cloud controller manager KEP](https://github.com/kubernetes/enhancements/tree/master/keps/sig-cloud-provider/2392-cloud-controller-manager) for more details.

##### Container Images

AWS Cloud Controller Managed container images are available in `registry.k8s.io/provider-aws/cloud-controller-manager`.

### AWS Credential Provider

The AWS credential provider is a binary that is executed by kubelet to provide credentials for images in ECR.  Refer to the [credential provider extraction KEP](https://github.com/kubernetes/enhancements/tree/master/keps/sig-cloud-provider/2133-out-of-tree-credential-provider) for more details.

### Volume Plugins

All the EBS volume plugin related logic will be in maintenance mode. For new feature request or bug fixes, please create issue or pull request in [EBS CSI Driver](https://github.com/kubernetes-sigs/aws-ebs-csi-driver)