These instructions represent the complete set of commands you need to enter into your terminal to install Charmed Kubernetes on Azure.

Not using Azure? See our other guides ›

  1. Install Juju

    Juju is a tool for deploying, configuring and operating complex software on public or private clouds. It can be installed with a snap:

    sudo snap install juju --classic
  2. Find your cloud

    Juju has baked-in knowledge of many public clouds such as AWS, Azure and Google. You can see which ones are ready to use by running this command:

    juju clouds

    Find out more about Clouds in Juju

  3. Add cloud credentials

    Most clouds require credentials so that the cloud knows which operations are authorised, so you will need to supply these for Juju. You can login with your Azure account and acquire your credentials using the Azure CLI. Then, you can add your credentials to Juju running:

    juju add-credential azure
  4. Add juju controller

    The Juju controller is used to manage the software deployed through Juju, from deployment to upgrades to day-two operations. One Juju controller can manage multiple projects or workspaces, which in Juju are known as ‘models’.

    juju bootstrap azure my-controller
  5. Add a Kubernetes model

    The model holds a specific deployment. It is a good idea to create a new one specifically for each deployment.

    juju add-model k8s

    Remember that you can have multiple models on each controller, so you can deploy multiple Kubernetes clusters or other applications.

  6. Deploy Kubernetes

    Deploy the Kubernetes bundle to the model. This will add instances to the model and deploy the required applications. This can take up to 20 minutes depending on your machine.

    juju deploy charmed-kubernetes
  7. Monitor the deployment

    Juju is now busy creating instances, installing software and connecting the different parts of the cluster together, which can take several minutes. You can monitor what’s going on by running:

    watch -c juju status --color

    To view the last twenty log messages for the “k8s” model:

    juju debug-log -m k8s -n 20
  8. Start using your cluster!

    Congratulations! You have a Kubernetes cluster up and running - now let’s use it! The link below takes you to the operations guide, detailing some of the common things you’ll want to do next:

    Get started with your new cluster ›