Skip to content

Deploy abcdesktop on Azure with Microsoft Azure Kubernetes Service

Requirements

  • az command line interface azure-cli installed.
  • You need your Azure Subscription Name, Username, and Password.
  • A running Azure Kubernetes Service cluster that is ready and running.

Azure console overview

Create a new Azure Kubernetes Service cluster.

azure console kubernetes create cluster

All options and features use their default values.

In this example, the Kubernetes cluster is named abcdesktopkubernetescluster. This screenshot shows the Azure Kubernetes Service console, displaying the Node pools and Networking configuration.

azure console overview

Check your caller-identity

If you have not already done so, run the az login command:

az login

The remaining steps complete in your web browser using your own credentials.

Set your subscription for your Azure account

az account set --subscription XXXXXX-YYYYY-ZZZZZ-AAAA-BBBBBBBBBB

Create your kubernetes config

az aks get-credentials --name MyManagedCluster --overwrite-existing --resource-group MyResourceGroup

For example

  • resource-group: abcdesktop
  • name: abcdesktopkubernetescluster
az aks get-credentials --resource-group abcdesktop --name abcdesktopkubernetescluster --overwrite-existing

Get your Kubernetes cluster information

Run the kubectl cluster-info command line to confirm that the kubectl command can communicate with your Azure cluster.

kubectl cluster-info
Kubernetes control plane is running at https://abcdesktopkubernetescluster-dns-rm7w2mot.hcp.northeurope.azmk8s.io:443
CoreDNS is running at https://abcdesktopkubernetescluster-dns-rm7w2mot.hcp.northeurope.azmk8s.io:443/api/v1/namespaces/kube-system/services/kube-dns:dns/proxy
Metrics-server is running at https://abcdesktopkubernetescluster-dns-rm7w2mot.hcp.northeurope.azmk8s.io:443/api/v1/namespaces/kube-system/services/https:metrics-server:/proxy

To further debug and diagnose cluster problems, use 'kubectl cluster-info dump'.

Run the abcdesktop install script

Download and extract the latest release automatically

curl -sL https://raw.githubusercontent.com/abcdesktopio/conf/main/kubernetes/install-4.4.sh | bash

To get more details about the install process, please read the Setup guide

Connect to your abcdesktop service

By default, the install script listens on TCP port :30443 and uses a kubectl port-forward command to forward traffic to the HTTP service on port :80.

Open your web browser and navigate to http://localhost:30443.

abcdesktop login

Log in as user Philip J. Fry with the password fry

abcdesktop login as fry

After the image-pulling process completes, you get your first abcdesktop session

abcdesktop for fry

Add applications to your desktop

Using the same terminal session, run the application install script:

curl -sL https://raw.githubusercontent.com/abcdesktopio/conf/main/kubernetes/pullapps-4.4.sh | bash

To get more details about the install applications process, please read the Setup applications guide

Then reload the web page with the desktop of Philip J. Fry. New applications are now listed in the plasmashell dock.

abcdesktop for fry with applications

Start Firefox application

The first run may require waiting for the image-pulling process to complete.

Navigate to https://mylocation.org to check where your pod is running. For the North Europe region, the desktop is located near Dublin, Ireland.

abcdesktop for fry with applications

Looking for an older version? Previous documentation (old.abcdesktop.com)