Edit

Share via


Uninstall the Open Service Mesh (OSM) add-on from your Azure Kubernetes Service (AKS) cluster

This article shows you how to uninstall the OMS add-on and related resources from your AKS cluster.

Warning

Microsoft has announced the retirement of the Open Service Mesh (OSM) add-on for AKS. The upstream OSM project has also been retired by the Cloud Native Computing Foundation (CNCF). Identify any existing OSM configurations and migrate them to equivalent Istio configurations. For migration steps, see Migration guidance for Open Service Mesh (OSM) configurations to Istio.

Disable the OSM add-on from your cluster

  • Disable the OSM add-on from your cluster using the az aks disable-addon command and the --addons parameter.

    az aks disable-addons \
      --resource-group myResourceGroup \
      --name myAKSCluster \
      --addons open-service-mesh
    

Remove OSM resources

  • Uninstall the remaining resources on the cluster using the osm uninstall cluster-wide-resources command.

    osm uninstall cluster-wide-resources
    

    Note

    For version 1.1, the command is osm uninstall mesh --delete-cluster-wide-resources

    Important

    You must remove these additional resources after you disable the OSM add-on. Leaving these resources on your cluster may cause issues if you enable the OSM add-on again in the future.

Next steps

Learn more about Open Service Mesh.