Skip to content

Latest commit

 

History

History
129 lines (90 loc) · 6.14 KB

README.md

File metadata and controls

129 lines (90 loc) · 6.14 KB
Raw

Cloud provider for Azure

Go Report Card Coverage Status GitHub stars GitHub stars

Introduction

This repository provides the Azure implementation of the Kubernetes cloud provider interface.

This is the "external" or "out-of-tree" cloud provider for Azure. The "in-tree" cloud provider has been deprecated since v1.20 and only bug fixes are allowed in its Kubernetes repository directory.

Current status

cloud-provider-azure has been GA since v1.0.0. Releases are available from the Microsoft Container Registry (MCR).

The latest release of azure-cloud-controller-manager and azure-cloud-node-manager can be found at

  • mcr.microsoft.com/oss/kubernetes/azure-cloud-controller-manager:v1.27.3
  • mcr.microsoft.com/oss/kubernetes/azure-cloud-node-manager:v1.27.3

Version matrix

(Minor release versions match Kubernetes minor release versions since v1.23.0.)

Kubernetes version cloud-provider version cloud-provider branch
master N/A master
v1.27.x v1.27.z release-1.27
v1.26.x v1.26.z release-1.26
v1.25.x v1.25.z release-1.25
v1.24.x v1.24.z release-1.24
v1.23.x v1.23.z release-1.23
v1.22.x v1.1.z release-1.1

AKS version matrix

Below table shows the cloud-controller-manager and cloud-node-manager versions supported in Azure Kubernetes Service(AKS).

AKS version cloud-controller-manager version cloud-node-manager version
v1.27.x (not supported yet) v1.27.5 v1.27.4
v1.26.x v1.26.11 v1.26.10
v1.25.x v1.25.15 v1.25.14
v1.24.x v1.24.21 v1.24.20
v1.23.x v1.23.30 v1.23.24
v1.22.x v1.1.26 v1.1.14
v1.21.x v1.0.23 v1.0.18

Build

To build the binary for azure-cloud-controller-manager:

make all

To build the Docker image for azure-cloud-controller-manager:

IMAGE_REGISTRY=<registry> make image

For detailed directions on image building, please read here.

Run

To run azure-cloud-controller-manager locally:

azure-cloud-controller-manager \
    --cloud-provider=azure \
    --cluster-name=kubernetes \
    --controllers=*,-cloud-node \
    --cloud-config=/etc/kubernetes/cloud-config/azure.json \
    --kubeconfig=/etc/kubernetes/kubeconfig \
    --allocate-node-cidrs=true \
    --configure-cloud-routes=true \
    --cluster-cidr=10.240.0.0/16 \
    --route-reconciliation-period=10s \
    --leader-elect=true \
    --secure-port=10267 \
    --v=2

To run azure-cloud-node-manager locally:

azure-cloud-node-manager \
    --node-name=$(hostname) \
    --wait-routes=true

It is recommended to run azure-cloud-controller-manager as a Deployment with multiple replicas, or directly with kubelet as static Pods on each control plane Node. See here for an example.

Get more detail at Deploy Cloud Controller Manager.

E2E tests

Please read the following documents for e2e test information:

Documentation

See kubernetes-sigs.github.io/cloud-provider-azure for more documentation.

Contributing

Please see CONTRIBUTING.md for instructions on how to contribute.

Code of conduct

Participation in the Kubernetes community is governed by the Kubernetes Code of Conduct.

License

Apache License 2.0.