VOOZH about

URL: https://thenewstack.io/tutorial-register-and-configure-kubernetes-clusters-with-azure-arc/

⇱ Tutorial: Register and Configure Kubernetes Clusters with Azure Arc - The New Stack


TNS
SUBSCRIBE
Join our community of software engineering leaders and aspirational developers. Always stay in-the-know by getting the most important news and exclusive content delivered fresh to your inbox to learn more about at-scale software development.
REQUIRED
It seems that you've previously unsubscribed from our newsletter in the past. Click the button below to open the re-subscribe form in a new tab. When you're done, simply close that tab and continue with this form to complete your subscription.
The New Stack does not sell your information or share it with unaffiliated third parties. By continuing, you agree to our Terms of Use and Privacy Policy.
Welcome and thank you for joining The New Stack community!
Please answer a few simple questions to help us deliver the news and resources you are interested in.
REQUIRED
REQUIRED
REQUIRED
REQUIRED
REQUIRED
Great to meet you!
Tell us a bit about your job so we can cover the topics you find most relevant.
REQUIRED
REQUIRED
REQUIRED
REQUIRED
REQUIRED
Welcome!

We’re so glad you’re here. You can expect all the best TNS content to arrive Monday through Friday to keep you on top of the news and at the top of your game.

What’s next?

Check your inbox for a confirmation email where you can adjust your preferences and even join additional groups.

Follow TNS on your favorite social media networks.

Become a TNS follower on LinkedIn.

Check out the latest featured and trending stories while you wait for your first TNS newsletter.

PREV
1 of 2
NEXT
VOXPOP
As a JavaScript developer, what non-React tools do you use most often?
Angular
0%
Astro
0%
Svelte
0%
Vue.js
0%
Other
0%
I only use React
0%
I don't use JavaScript
0%
Thanks for your opinion! Subscribe below to get the final results, published exclusively in our TNS Update newsletter:
NEW! Try Stackie AI
From clobbered drafts to real-time sync
Apr 14th 2026 10:00am, by David Moore
TypeScript 6.0 RC arrives as a bridge to a faster future
Mar 14th 2026 9:00am, by Darryl K. Taft
Mastra empowers web devs to build AI agents in TypeScript
Jan 28th 2026 11:00am, by Loraine Lawson
2020-11-25 11:40:22
Tutorial: Register and Configure Kubernetes Clusters with Azure Arc
feature,tutorial,
Cloud Services / DevOps / Kubernetes

Tutorial: Register and Configure Kubernetes Clusters with Azure Arc

This post is the third of a four-part series this week exploring Microsoft Arc, and how it can be used as a control plane to manage services. Check back each day through Thursday for subsequent installments.
Nov 25th, 2020 11:40am by Janakiram MSV
👁 Featued image for: Tutorial: Register and Configure Kubernetes Clusters with Azure Arc
This post is the third of a four-part series this week exploring Microsoft Arc, and how it can be used as a control plane to manage services. Check back each day through Thursday for subsequent installments: (Part 1) (Part 2)

This article is the third part of the Azure Arc series, where we explore Arc enabled Kubernetes clusters. We will also configure GitOps to consistently deploy workloads across all the registered clusters.

We can attach and configure Kubernetes clusters inside or outside of Azure by using Azure Arc enabled Kubernetes. In the below screenshot, we have four clusters deployed in AKS, EKS, GKE, and bare metal with Azure Arc.

👁 Image

By the end of this tutorial, you will be able to attach an existing cluster and deploy the cluster configuration agent on it.

Setting up the Environment

Make sure you have a cluster running in GKE or another environment. Even clusters based on Minikube or Kind can be registered with Azure Arc.

For this tutorial, I am running a four-node cluster in GKE.

👁 Image

Start by registering the provider for your Azure subscription. Please be patient while the providers are registered. This may take a while.

az provider register --namespace Microsoft.Kubernetes
az provider register --namespace Microsoft.KubernetesConfiguration

We also need to register an extension for the az CLI to work with Arc enabled Kubernetes clusters. Run the below commands to register.

az extension add --name connectedk8s
az extension add --name k8sconfiguration

We also need the latest version of Helm installed. On macOS install it through Homebrew.

brew install helm

Finally, create a resource group for the registered clusters. Make sure the resource group is created in one of the supported regions — East US and West Europe.

az group create --name arc-demo-clusters -l WestEurope

We are now ready to register the cluster. Make sure your KUBECONFIG environment is pointing to the correct cluster.

Registering a Google Kubernetes Engine Cluster with Azure Arc

Let’s take a look at the namespaces in our cluster.

👁 Image

Currently, there are no workloads running in the cluster. We only have the default namespaces created during the cluster provisioning.

Registering the Kubernetes cluster with Azure Arc will result in a new namespace. Let’s initiate the registration by running the below command:

az connectedk8s connect \
	--name arc-demo-gke \
	--resource-group arc-demo-clusters

👁 Image

Let’s explore the namespaces and the resources created in the new namespace.

👁 Image

👁 Image

Azure Arc agents are deployed in the namespace, azure-arc. These agents maintain the connection between the Kubernetes cluster and the Azure Arc control plane.

We can list all the connected clusters with the below command:

az connectedk8s list -o table

👁 Image

You can also verify the registration through Azure Portal.

👁 Image

Deploying Applications and Configuration through GitOps

GitOps is the practice of declaring the desired state of Kubernetes configuration such as deployments, namespaces, and configmaps in a Git repository followed by polling and pull-based deployment model of these configurations to the cluster using an operator.

With Azure Arc, we can deploy applications and configurations to all the registered clusters by committing the manifests to a Git repository. An agent running in each of the registered clusters will automatically pull the manifests/specifications and applies them to the cluster.

We need a Git repository that will act as the single source of truth for all the participating clusters. For this tutorial, you can use https://github.com/janakiramm/arcdemo that has the popular Azure Vote sample application and an empty namespace called guestbook.

You may also try forking the repository and adding your own manifests to it. In that case, make sure the GitOps agent is pointed to your repository than the one shared above.

Ensure that your KUBECONFIG variable is pointing to the same GKE cluster that we configured earlier. Run the below command to configure the cluster with the GitOps agent.

az k8sconfiguration create \
 --name cluster-config \
 --cluster-name arc-demo-gke \
 --resource-group arc-demo-clusters \
 --operator-instance-name cluster-config \
 --operator-namespace cluster-config \
 --repository-url https://github.com/janakiramm/arcdemo \
 --scope cluster \
 --cluster-type connectedClusters

👁 Image

In a few minutes, the cluster-config namespace will be running the GitOps agent that watches the GitHub repository for new commits.

👁 Image

You will also notice the addition of two namespaces — vote and guestbook which are applied from the specs stored at GitHub repository.

All the clusters registered with Azure Arc and running the cluster configuration agent will have these namespaces and the associated deployments and configuration.

Try making the changes to the manifests, and committing them to the repo. You will notice the changes automatically propagating to all the registered clusters without manual intervention. This is the power of GitOps-based deployment and configuration.

In the next part of this series, we will explore Azure Arc Data Services. Stay tuned!

Janakiram MSV’s Webinar series, “Machine Intelligence and Modern Infrastructure (MI2)” offers informative and insightful sessions covering cutting-edge technologies. Sign up for the upcoming MI2 webinar at http://mi2.live.

Feature image by ipicgr via Pixabay.

TRENDING STORIES
Janakiram MSV (Jani) is a practicing architect, research analyst, and advisor to Silicon Valley startups. He focuses on the convergence of modern infrastructure powered by cloud-native technology and machine intelligence driven by generative AI. Before becoming an entrepreneur, he spent...
Read more from Janakiram MSV
SHARE THIS STORY
TRENDING STORIES
SHARE THIS STORY
TRENDING STORIES
TNS DAILY NEWSLETTER Receive a free roundup of the most recent TNS articles in your inbox each day.
The New Stack does not sell your information or share it with unaffiliated third parties. By continuing, you agree to our Terms of Use and Privacy Policy.