Skip to content

nojnhuh/azure-service-operator

This branch is 1184 commits behind Azure/azure-service-operator:main.

Folders and files

NameName
Last commit message
Last commit date
Dec 15, 2022
Jan 16, 2023
Apr 13, 2022
Jul 31, 2022
Jul 31, 2022
Feb 2, 2022
May 25, 2021
Feb 19, 2023
Oct 15, 2019
Jan 30, 2023
Jul 15, 2022
Apr 13, 2020
Dec 14, 2022
Aug 19, 2021
Feb 14, 2023
Apr 13, 2022
Aug 29, 2019
Aug 18, 2021
Jun 9, 2022
Dec 12, 2022
Sep 19, 2022
Jul 18, 2019
Oct 10, 2022
Apr 13, 2022
Mar 2, 2020
Aug 3, 2022
Jul 8, 2020
Oct 18, 2022
May 12, 2021
Oct 18, 2022
Feb 14, 2023
Jul 29, 2022
Oct 5, 2021
Jan 23, 2023
Jan 9, 2023
Jan 9, 2023
Jan 9, 2023
Oct 18, 2021

Repository files navigation

Azure Service Operator (for Kubernetes)

Go Report Card Build Status v2 Status

Note: The API is expected to change (while adhering to semantic versioning). Alpha, Beta, and Stable mean roughly the same for this project as they do for all Kubernetes features.

What is it?

Azure Service Operator (ASO) helps you provision Azure resources and connect your applications to them from within Kubernetes.

If you want to use Azure resources but would prefer to manage those resources using Kubernetes tooling and primitives (for example kubectl apply), then Azure Service Operator might be for you.

Overview

The Azure Service Operator consists of:

  • The Custom Resource Definitions (CRDs) for each of the Azure services a Kubernetes user can provision.
  • The Kubernetes controller that manages the Azure resources represented by the user specified Custom Resources. The controller attempts to synchronize the desired state in the user specified Custom Resource with the actual state of that resource in Azure, creating it if it doesn't exist, updating it if it has been changed, or deleting it.

Versions of Azure Service Operator

There are two major versions of Azure Service Operator: v1 and v2. Consult the below table and descriptions to learn more about which you should use.

Note: ASO v1 and v2 are two totally independent operators. Each has its own unique set of CRDs and controllers. They can be deployed side by side in the same cluster.

ASO Version Lifecycle stage Development status Installation options
v2 Beta Under active development. Helm chart, GitHub release 2.x. See installation for example.
v1 Beta Bug and security fixes primarily. Helm chart, OperatorHub or GitHub release 1.x

ASO v2

Azure Service Operator v2 was built based on the lessons learned from ASO v1, with the following improvements:

  • Supports code-generated CRDs based on Azure OpenAPI specifications. This enables us to quickly add new resources as they are requested.
  • More powerful Status. You can view the actual state of the resource in Azure through ASO v2, which enables you to see server-side applied defaults and more easily debug issues.
  • Dedicated storage versions. This enables faster (and less error prone) support for new Azure API versions, even if there were significant changes in resource shape.
  • Uniformity. ASO v2 resources are very uniform due to their code-generated nature.
  • Clearer resource states. The state a resource is in is exposed via a Ready condition.

Learn more about Azure Service Operator v2

ASO v1

⚠️ We strongly recommend new users consider ASO v2 instead of ASO v1

Azure Service Operator v1 is no longer under active development. Bug and security fixes are still made.

Features may be added if the scope is small and the impact is large, but we are winding down investment into ASO v1. If you are already using ASO v1 a migration path/tool will be provided to eventually move ASO v1 resources to ASO v2. In the meantime you can continue using ASO v1 as you have been.

Learn more about Azure Service Operator v1

Contributing

The contribution guide covers everything you need to know about how you can contribute to Azure Service Operators.

Support and feedback

For help, please use the following resources:

  1. Review the documentation
  2. Search open issues. If your issue is not represented there already, please open a new one.
  3. Chat with us on the azure-service-operator channel of the Kubernetes Slack. If you are not a member you can get an invitation from the community inviter.

For more information, see SUPPORT.md.

Code of conduct

This project has adopted the Microsoft Open Source Code of Conduct. For more information, see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

About

Azure Service Operator allows you to create Azure resources using kubectl

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 98.2%
  • Shell 1.1%
  • Other 0.7%