Deploy and manage applications from Azure Marketplace on Azure Arc-enabled Kubernetes clusters

Azure Marketplace is an online store that contains thousands of IT software applications and services built by industry-leading technology companies. In Azure Marketplace, you can find, try, buy, and deploy the software and services that you need to build new solutions and manage your cloud infrastructure. The catalog includes solutions for different industries and technical areas, free trials, and consulting services from Microsoft partners.

Included among these solutions are Kubernetes application-based container offers. These offers contain applications that can run on Azure Arc-enabled Kubernetes clusters, represented as cluster extensions. Deploying an offer from Azure Marketplace creates a new instance of the extension on your Arc-enabled Kubernetes cluster.

This article shows you how to:

• Discover applications that support Azure Arc-enabled Kubernetes clusters.
• Purchase an application.
• Deploy the application on your cluster.
• Monitor usage and billing information.

You can use Azure CLI or the Azure portal to perform these tasks.

Prerequisites

• An existing Azure Arc-enabled Kubernetes connected cluster, with at least one node of operating system and architecture type linux/amd64.
  • If you don't have a connected cluster yet, use our quickstart.
  • Upgrade your agents to the latest version.
• If using Azure CLI to review, deploy, and manage Azure Marketplace applications:
  • The latest version of Azure CLI.
  • The latest version of the k8s-extension Azure CLI extension. Install the extension by running az extension add --name k8s-extension. If the k8s-extension extension is already installed, make sure you have the latest version by running az extension update --name k8s-extension.

Note

This feature is currently supported only in the following regions:

• East US, East US2, EastUS2 EUAP, West US, West US2, Central US, West Central US, South Central US, West Europe, North Europe, Canada Central, South East Asia, Australia East, Central India, Japan East, Korea Central, UK South, UK West, Germany West Central, France Central, East Asia, West US3, Norway East, South African North, North Central US, Australia South East, Switzerland North, Japan West, South India

Discover Kubernetes applications that support Azure Arc-enabled clusters

Azure portal

To discover Kubernetes applications in the Azure Marketplace from within the Azure portal:

1. In the Azure portal, search for Marketplace. In the results, under Services, select Marketplace.

2. From Marketplace, you can search for an offer or publisher directly by name, or you can browse all offers. To find Kubernetes application offers, select Containers from the Categories section in the left menu.

   Important

   The Containers category includes both Kubernetes apps and standalone container images. Select only Kubernetes Apps offers when following these steps. Container images have a different deployment process, and generally can't be deployed on Arc-enabled Kubernetes clusters.

3. Several Kubernetes application offers appear on the page. To view all of the Kubernetes application offers, select See more.

   

4. Alternately, you can search for a specific publisherId to view that publisher's Kubernetes applications in Azure Marketplace. For details on how to find publisher IDs, see the Azure CLI tab for this article.

   

Once you find an application that you want to deploy, move on to the next section.

Azure CLI

You can use Azure CLI to get a list of extensions, including Azure Marketplace applications, that can be deployed on Azure Arc-enabled connected clusters. To do so, run this command, providing the name of your connected cluster and the resource group where the cluster is located.

az k8s-extension extension-types list-by-cluster --cluster-type connectedClusters --cluster-name <clusterName> --resource-group <resourceGroupName>

The command returns a list of extension types that can be deployed on the connected clusters, similar to the example shown here.

"id": "/subscriptions/{sub}/resourceGroups/{rg} /providers/Microsoft.Kubernetes/connectedClusters/{clustername} /providers/Microsoft.KubernetesConfiguration/extensiontypes/contoso",
"name": "contoso",
"type": "Microsoft.KubernetesConfiguration/extensionTypes",
"properties": {
    "extensionType": "contoso",
    "description": "Contoso extension",
    "isSystemExtension": false,
    "publisher": "contoso",
    "isManagedIdentityRequired": false,
    "supportedClusterTypes": [
        "managedclusters",
        "connectedclusters"
    ],
    "supportedScopes": {
        "defaultScope": "namespace",
        "clusterScopeSettings": {
            "allowMultipleInstances": false,
            "defaultReleaseNamespace": null
        }
    },
    "planInfo": {
        "offerId": "contosoOffer",
        "planId": "contosoPlan",
        "publisherId": "contoso"
    }
}

When you find an application that you want to deploy, note the following values from the response received: planId, publisherId, offerID, and extensionType. You need these values to accept the application's terms and deploy the application.

Deploy a Kubernetes application

Azure portal

Once you identify an offer you want to deploy, select it and follow these steps:

1. In the Plans + Pricing tab, review the options. If there are multiple plans available, find the one that meets your needs. Review the terms on the page to make sure they're acceptable, and then select Create.

   

2. Select the subscription, resource group, and Arc-enabled cluster to which you want to deploy the application.

3. Complete all pages of the deployment wizard to specify all configuration options that the application requires. These options will vary depending on the offer.

4. When you're finished, select Review + Create, then select Create to deploy the offer.

Azure CLI

Accept terms and agreements

Before you can deploy a Kubernetes application, you need to accept its terms and agreements. Be sure to read these terms carefully so that you understand costs and any other requirements.

To view the details of the terms, run the following command, providing the values for offerID, planID, and publisherID:

az vm image terms show --offer <offerID> --plan <planId> --publisher <publisherId>

To accept the terms, run the following command, using the same values for offerID, planID, and publisherID.

az vm image terms accept --offer <offerID> --plan <planId> --publisher <publisherId>

Note

Although this command is for VMs, it also works for containers, including Arc-enabled Kubernetes clusters. For more information, see the az vm image terms reference.

Deploy the application

To deploy the application (extension) through Azure CLI, follow the steps outlined in Deploy and manage Azure Arc-enabled Kubernetes cluster extensions. An example command might look like this:

az k8s-extension create --name <offerID> --extension-type <extensionType> --cluster-name <clusterName> --resource-group <resourceGroupName> --cluster-type connectedClusters --plan-name <planId> --plan-product <offerID> --plan-publisher <publisherId>  

Verify the deployment

Deploying an offer from Azure Marketplace creates a new extension instance on your Arc-enabled Kubernetes cluster. You can verify that the deployment was successful by confirming that the extension is running successfully.

Azure portal

Navigate to the cluster on which you installed the extension. In the service menu, under Settings, select Extensions.

If the deployment was successful, the Status for the extension is Succeeded. While the deployment is still in progress, the status is Creating. Wait a few minutes, then check again.

If the status is Failed, see Troubleshoot the failed deployment of a Kubernetes application offer.

Azure CLI

Verify the deployment by using the following command to list the extensions that are already running or being deployed on your cluster:

az k8s-extension list --cluster-name <clusterName> --resource-group <resourceGroupName> --cluster-type connectedClusters

If the deployment was successful, provisioningState is Succeeded. If the deployment is still in progress, provisioningState is Creating. Wait a few minutes then check again.

If provisioningState is Failed, see Troubleshoot the failed deployment of a Kubernetes application offer.

To view the extension instance from the cluster, run the following command:

az k8s-extension show --name <extension-name> --cluster-name <clusterName> --resource-group <resourceGroupName> --cluster-type connectedClusters

Monitor billing and usage information

You can monitor billing and usage information for a deployed extension in the Azure portal.

1. In the Azure portal, navigate to your cluster's resource group.

2. In the service menu, under Cost Management, select Cost analysis. Under Product, you can see a cost breakdown for the plan that you selected.

Remove an application

You can delete a purchased plan for a Kubernetes offer by deleting the extension instance on the cluster.

Azure portal

To delete the extension instance in the Azure portal, navigate to the cluster on which you installed the extension. In the service menu, under Settings, select Extensions. Select the application you want to remove, then select Uninstall.

Azure CLI

The following command deletes an extension from the cluster:

az k8s-extension delete --name <extension-name> --cluster-name <clusterName> --resource-group <resourceGroupName> --cluster-type connectedClusters

Troubleshooting

For with resolving issues, see Troubleshoot the failed deployment of a Kubernetes application offer.

Next steps

• Learn about extensions for Arc-enabled Kubernetes.
• Use our quickstart to connect a Kubernetes cluster to Azure Arc.