Tutorial: Configure compute on Azure Stack Edge Pro GPU device

  • Article

This tutorial describes how to configure a compute role and create a Kubernetes cluster on your Azure Stack Edge Pro GPU device.

This procedure can take 20 to 30 minutes to complete.

In this tutorial, you learn how to:

  • Configure compute
  • Get Kubernetes endpoints

Important

Managed IoT Edge on Azure Stack Edge uses an earlier version of the IoT Edge runtime that doesn't include the latest features and patches.

  • Support for existing deployments of managed IoT Edge on Azure Stack Edge will end on March 31, 2024, and existing IoT Edge workloads will be removed. You must upgrade to the latest version of Azure Stack Edge and deploy IoT Edge on an Ubuntu VM.
  • For Azure Stack Edge 2301 and later, all deployments of IoT Edge on Azure Stack Edge must be on an Ubuntu VM.

For detailed instructions, see Deploy IoT runtime on Ubuntu VM on Azure Stack Edge.

Prerequisites

Before you set up a compute role on your Azure Stack Edge Pro device:

  • Make sure that you've activated your Azure Stack Edge Pro device as described in Activate Azure Stack Edge Pro.

  • Make sure that you've followed the instructions in Enable compute network and:

    • Enabled a network interface for compute.
    • Assigned Kubernetes node IPs and Kubernetes external service IPs.

    Note

    If your datacenter firewall is restricting or filtering traffic based on source IPs or MAC addresses, make sure that the compute IPs (Kubernetes node IPs) and MAC addresses are on the allowed list. The MAC addresses can be specified by running the Set-HcsMacAddressPool cmdlet on the PowerShell interface of the device.

Configure compute

To configure compute on your Azure Stack Edge Pro, you create an IoT Hub resource via Azure portal.

  1. In the Azure portal of your Azure Stack Edge resource, go to Overview, and select Kubernetes for Azure Stack Edge.

    Get started with compute

  2. In Get started with Kubernetes service, select Add.

    Configure compute

  3. After the resource is created, the Overview indicates that the Kubernetes service is online.

    Get started with compute 3

It can take 20-30 minutes to configure compute because, behind the scenes, virtual machines, and a Kubernetes cluster are being created.

Get Kubernetes endpoints

To configure a client to access Kubernetes cluster, you'll need the Kubernetes endpoint. Follow these steps to get Kubernetes API endpoint from the local UI of your Azure Stack Edge Pro device.

  1. In the local web UI of your device, go to Device page.

  2. Under the Device endpoints, copy the Kubernetes API endpoint. This endpoint is a string in the following format: https://compute.<device-name>.<DNS-domain>[Kubernetes-cluster-IP-address].

    Screenshot that shows the Device page in local U I.

  3. Save the endpoint string. You'll use this endpoint string later when configuring a client to access the Kubernetes cluster via kubectl.

  4. While you are in the local web UI, you can:

    • If you've been provided a key from Microsoft (select users may have a key), go to Kubernetes API, select Advanced config, and download an advanced configuration file for Kubernetes.

      Screenshot that shows the Device page in local U I 1.

      Screenshot that shows the Device page in local U I 2.

    • You can also go to Kubernetes dashboard endpoint and download an aseuser config file.

      Screenshot that shows the Device page in local U I 3.

      You can use this config file to sign into the Kubernetes dashboard or debug any issues in your Kubernetes cluster. For more information, see Access Kubernetes dashboard.

Next steps

In this tutorial, you learned how to:

  • Configure compute
  • Get Kubernetes endpoints

To learn how to administer your Azure Stack Edge Pro device, see:

Use local web UI to administer an Azure Stack Edge Pro