FAQ

Frequently Asked Questions

What is the release cadence?

We ship updates to ASO as needed, with an eye towards releasing every 1-2 months. If there are urgent fixes, a release may happen more quickly than that. If there haven’t been any major changes (or there are ongoing major changes that are taking a long time) a release may happen more slowly.

What is the support model?

Azure Service Operator is an officially supported Microsoft OSS product. Currently, support is done via GitHub issues or the azure-service-operator channel of the Kubernetes Slack. There are plans to integrate ASO into AKS as an addon after ASO has officially gone GA. At that point, support for ASO as an AKS addon would be accessed by raising an Azure support ticket.

Does ASO help with Disaster Recovery (DR) of resources in Azure?

No. If the Azure resource supports DR then you can configure it through ASO. If the underlying Azure Resource doesn’t support DR (or the story is more complicated/manual), then you cannot currently configure it through ASO.

How can I protect against accidentally deleting an important resource?

  1. You can set serviceoperator.azure.com/reconcile-policy: detach-on-delete. This will allow the resource to be deleted in k8s but not delete the underlying resource in Azure.
  2. You can use a project like https://github.com/petrkotas/k8s-object-lock to protect the resources you’re worried about. Note: That project is not owned/sponsored by Microsoft.
  3. You can manually add a finalizer to the resource which will not be removed except manually by you when ready to delete the resource, see this

There’s also a proposal for more general upstream support on this topic, although there hasn’t been movement on it in a while.

What is the best practice for transferring ASO resources from one cluster to another?

There are two important tenets to remember when transferring resources between clusters:

  1. Don’t accidentally delete the resources in Azure during the transfer.
  2. Don’t have two instances of ASO fighting to reconcile the same resource to different states.

Let’s say that you want to migrate all of your ASO resources from cluster A to cluster B. We recommend the following pattern:

  1. Annotate the resources in cluster A with serviceoperator.azure.com/reconcile-policy: skip. This prevents ASO in that cluster from updating or deleting those resources.
  2. Ensure that cluster B has ASO installed.
  3. kubectl apply the resources into cluster B. We strongly recommend an infrastructure-as-code approach where you keep your original/goal-state ASO YAMLs around.
  4. Delete the resources in cluster A. Note that because of the skip annotation, this will not delete the backing Azure resources.

What is the best practice for transferring ASO resources from one namespace to another?

See above. The process is the same for moving between namespaces.

Can I run ASO in active-active mode?

This is where two different ASO instances manage the same resource in Azure.

This can be done but is not recommended. The main risk here is the goal state between the two instances of the same resource differing, causing thrashing in Azure as each operator instance tries to drive to its goal. If you take great care to ensure that the goal state between the two clusters cannot differ, then active-active can be done.

We instead recommend an active-passive approach, where in 1 cluster the resources are created/managed as normal, and in the other cluster the resources are just watched. This can be accomplished with the serviceoperator.azure.com/reconcile-policy: skip annotation used in the second cluster. In the case of a DR event, automation or manual action can remove the skip annotation in the passive cluster, turning it into active mode.

Can ASO be used with IAC/GitOps tools?

Yes! We strongly recommend using something like fluxcd or argocd with ASO.

If using argocd, make sure to avoid the SyncPolicy Replace=true, as that removes finalizers and annotations added by the operator whenever resources are re-applied. ASO relies on the finalizer and annotations it adds being left alone to function properly. If they are unexpectedly removed the operator may not behave as expected.

What’s the difference between ASO and Crossplane.io?

There are a lot of similarities between ASO and Crossplane. They do similar things and have similar audiences. You can see some of this discussed here.

Today primary differences are:

  • ASO is officially maintained by Microsoft, while Crossplane Azure is community maintained.
  • ASO focuses on simplicity. It doesn’t offer any of the higher level abstractions that Crossplane does. ASO is not and will not ever be multi-cloud.
  • The code generator we use to generate ASO resources is higher fidelity than the one that Crossplane uses. As a result, there are places where ASO resources are easier to use. One example of this is references between resources such as linking a VMSS to a VNET. In Crossplane you do this by specifying the raw ARM ID. In ASO, you can specify the raw ARM ID but you can also specify a reference to the corresponding resource in Kubernetes (with its Kubernetes name) and ASO translates that into an ARM ID under the hood so that you don’t have to. This makes managing graphs of interlinked resources easier.

We would like to share our code-generator with Crossplane, as it’s higher fidelity than Terrajet (the codegenerator Crossplane uses to generate resources) for Azure resources. Right now our focus is on getting ASO to GA, after which we will hopefully have more time to invest in that.

Can I configure how often ASO re-syncs to Azure when there have been no changes?

Yes, using the azureSyncPeriod argument in Helm’s values.yaml, or using the AZURE_SYNC_PERIOD in the aso-controller-settings secret. This value is a string with format like: 15m, 1h, or 24h.

After changing this value, you must restart the azureserviceoperator-controller-manager pod in order for it to take effect if the pod is already running.

Be careful setting this value too low as it can produce a lot of calls to Azure.

I’m seeing Subscription throttling, what can I do?

Azure subscriptions have a default limit of ~1200 PUTs an hour. Prior to ASO-beta.4, ASO’s default azureSyncPeriod was 15m. It was changed to 1h in ASO-beta.4.

When azureSyncPeriod is up for a particular resource, a new PUT is issued to the resource RP to correct any drift from the goal state defined in ASO. There has been discussion about changing to do diffing locally to reduce requests to Azure, see #1491.

You can estimate the maximum number of resources ASO can support based on the configured azureSyncPeriod and the rough cap of 1200 / hr.

azureSyncPeriod Maximum possible resources
15m 300
1h 1200
24h ~28000

Should I use user-assigned or system-assigned identity?

We don’t take a position on whether it’s universally better to deploy ASO using a user-assigned or system-assigned managed identity because the correct choice for you depends on your own context.

If you haven’t already read it, Azure has a good best practices for managed identity guide that may be useful.

When using Workload Identity, how can I easily inject the ASO created User Managed Identity details onto the service account?

The workload identity documentation suggests that you need to set the azure.workload.identity/client-id annotation on the ServiceAccount. This is not actually required! Setting that annotation instructs the Workload Identity webhook to inject the AZURE_CLIENT_ID environment variable into the pods on which the ServiceAccount is used.

If you’ve created your user managed identity with ASO, it’s easier to just do that injection yourself by using the operatorSpec.configMaps feature of the identity:

Identity:

operatorSpec:
  configMaps:
    tenantId:
      name: identity-details
      key: tenantId
    clientId:
      name: identity-details
      key: clientId

and

Pod:

env:
  - name: AZURE_CLIENT_ID
    valueFrom:
      configMapKeyRef:
        key: clientId
        name: identity-details

What should I know about RoleAssignment naming in ASO?

The RoleAssignment resource is required to have a name in Azure which is a UUID. Since it’s difficult to make a UUID for each assignment, ASO attempts to generate a unique UUID automatically if one isn’t specified. ASO does this by generating a UUID (v5) from a seed string with the following fields and setting it as the AzureName if one has not been specified:

  1. name
  2. namespace
  3. owner.name
  4. owner.namespace
  5. owner.group
  6. owner.kind

For the most part this should just work without you needing to worry about it. If you’re running multiple ASO clusters targeting different subscriptions in the same tenant you may need to be careful to avoid situations where two resources (one in subscription A, one in subscription B) both have the same values for the fields called out above. If this happens you may see an error like:

 (RoleAssignmentUpdateNotPermitted) Tenant ID, application ID, principal ID, and scope are not allowed to be updated.
 Code: RoleAssignmentUpdateNotPermitted
 Message: Tenant ID, application ID, principal ID, and scope are not allowed to be updated.

If you see this error, you can work around it by manually specifying a UUID for AzureName, or deleting the RoleAssignment which hit the error and creating it again with a different name.

If you’re planning to move management of a RoleAssignment from one namespace to another (by setting the reconcile-policy: skip on the old one, deleting it, and then creating the RoleAssignment in a different namespace allowing it to adopt the existing resource in Azure) you must manually specify the AzureName of the RoleAssignment as the original UUID. Otherwise, the UUID defaulting algorithm will choose a different UUID since the namespace has changed.

How can I import existing Azure resources into ASO?

See Annotations understood by the operator for details about how to control whether the operator modifies Azure resources or just watches them.

There are a few options for importing resources into your cluster:

  • If you’re looking to import a large number of Azure resources you can use asoctl.
  • If you’re looking to import a small number of resources, you can also manually create the resources in your cluster yourself and apply them. As long as the resource name, type and subscription are the same as the existing Azure resource, ASO will automatically adopt the resource. Make sure to use the reconcile-policy you want.