cloud-provider-azure

README

Cloud provider for Azure

Introduction

This repository provides tools and scripts for building and testing Kubernetes cloud-controller-manager for Azure. The project is under development.

The Azure cloud provider code locates at Kubernetes repository directory. If you want to create issues or pull requests for cloud provider, please go to Kubernetes repository.

There is an ongoing work for refactoring cloud providers out of the upstream repository. For more details, please check this issue.

Build

Build azure-cloud-controller-manager:

make

Build docker image for azure-cloud-controller-manager:

IMAGE_REGISTRY=<registry> make image

Run

Run azure-cloud-controller-manager:

azure-cloud-controller-manager --cloud-provider=azure \
    --cloud-config=/etc/kubernetes/azure.json \
    --kubeconfig=/etc/kubernetes/kubeconfig \
    --allocate-node-cidrs=true \
    --configure-cloud-routes=true \
    --cluster-cidr=10.240.0.0/12 \
    --leader-elect=true \
    --v=2

Please checkout more details in docs/cloud-controller-manager.md.

E2E tests

Please check the following documents for e2e tests:

• Upstream Kubernetes e2e tests
• Azure e2e tests

Documentation

• Component versioning
• Dependency management
• Cloud provider config
• Load balancer Annotations
• Using Azure availability zones
• Using cross resource group nodes
• AzureDisk known issues
• AzureFile known issues

See docs for more documentations.

Contributing

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

NOTE

Currently this repository is used for building and testing cloud-controller-manager for Azure, it references Azure cloud provider implementation code as vendor dir. After handoff, the Azure cloud provider implementation will be moved here.