From 0afd1db33c04f673e937cd758433a8755cbecf39 Mon Sep 17 00:00:00 2001 From: Nick Volynkin Date: Sat, 30 May 2026 19:57:55 +0300 Subject: [PATCH 1/3] docs: Rewrite the "Get started" tutorial Rewrite the tutorial according to the following principles: - Define the goal and value of a tutorial clearly. - Don't make value judgements such as "simple" or "complex". Present the facts so that the user can form their own judgement. - Provide users with a single straightforward way to complete the tutorial. (When users see options in a tutorial, they have to stop and make decisions, which reduces the tutorial completion rate). - Provide supplementary information and 'further reading' links after actions, not before. Signed-off-by: Nick Volynkin --- tutorial/get-started-with-openstack.rst | 177 +++++++++++++++--------- 1 file changed, 108 insertions(+), 69 deletions(-) diff --git a/tutorial/get-started-with-openstack.rst b/tutorial/get-started-with-openstack.rst index 277e6d6..bbccf0e 100644 --- a/tutorial/get-started-with-openstack.rst +++ b/tutorial/get-started-with-openstack.rst @@ -3,92 +3,123 @@ Get started with OpenStack Welcome! -If you are here, this likely means that you decided to give `Canonical OpenStack`_ a try. You might have heard from various sources that OpenStack is a complex piece of software. And you know what? This is true. OpenStack is complex for some very good reasons. However, you should also be aware that with the use of a proper tooling its complexity can be fully tamed. +If you are here, this likely means that you decided to give `Canonical OpenStack`_ a try. +It's complex software that you can fully tame with the right tools. -In this tutorial we will show you how to get started with Canonical OpenStack in a few simple steps. We will walk you through its installation and configuration processes and get your first VM running on top of it. You will only need one machine for this purpose and around 30 minutes to spare. +This tutorial will help you get started with Canonical OpenStack in a few steps. +It will guide you through installing Canonical OpenStack, bootstrapping the cloud, and provisioning a VM. +To complete the tutorial, you need a single dedicated machine or VM and around 30 minutes to spare. + +What you will build ++++++++++++++++++++ + +As a result of completing the tutorial, you will have a functioning single-node Canonical OpenStack cloud, +with the node serving the control, compute, and storage roles. +This cloud will be sufficient to complete all further tutorials in this documentation. +You will also understand the four key steps of each Canonical OpenStack deployment. Ready for the adventure? Let's explore OpenStack together! .. note :: - This tutorial is intended to serve for learning purposes only. If you've looking for detailed instructions on how to deploy a production-grade cloud, please refer to the :doc:`How-to Guides section` of this documentation instead. + This tutorial is intended to serve for learning purposes only. + To deploy a production-grade cloud, refer to detailed instructions in the :doc:`How-to Guides section `. Requirements ++++++++++++ -You will only need one dedicated physical machine with: +You need a dedicated physical machine with: * 4+ core amd64 processor * minimum of 16 GiB of RAM * minimum of 100 GiB SSD storage on the ``rootfs`` partition -* fresh Ubuntu Desktop 24.04 LTS installed +* a fresh installation of Ubuntu Desktop 24.04 LTS * unlimited access to the Internet -* spare un-formatted disk for MicroCeph +* a spare unformatted disk for MicroCeph You can also use a virtual machine instead, but you can expect some performance degradation in this case. -.. warning :: +.. note :: + + This tutorial intentionally limits OpenStack deployment to a single machine. + You will run all terminal commands and web browser examples from this machine, + and it will not expose OpenStack APIs or any of the provisioned cloud resources + (such as VMs and floating IPs) to your network. + + To learn about production-grade deployments, refer to :doc:`How-to Guides `. - All terminal commands used in this series of tutorials are run from the aforementioned machine. All web browser examples presented in this series of tutorials are run from the aforementioned machine. Neither OpenStack APIs nor any of the provisioned cloud resources, including VMs and floating IPs will be accessible from any other machine in your network than the aforementioned one. Everything runs on that machine. But it runs and it works! Deploy Canonical OpenStack ++++++++++++++++++++++++++ -.. note :: +Canonical OpenStack can be deployed in four steps. +This tutorial will demonstrate these steps and their meaning without going into deep details. - **Duration:** 1 minute (exact time might vary depending on your Internet connection speed) +Step 1: Install the OpenStack snap +---------------------------------- -Canonical OpenStack can be deployed for sample usage in four simple steps. Once you continue your journey with Canonical OpenStack and move forward with some more advanced scenarios you will find out that those steps are present in every single deployment procedure regardless of the cloud architecture and the bare metal provider being used. Thus, it is worth spending some time learning what exactly happens in each of those steps. Obviously, in more advanced scenarios, the exact procedure might vary slightly and some additional steps might be required. +.. note :: -Install the snap ----------------- + **Duration:** 1 minute (depends on your Internet connection speed) -We are going to start with installing the `OpenStack snap`_. The ``openstack`` snap includes the -``sunbeam`` command which we'll further use to bootstrap the cloud and to operate it -post-deployment. Sunbeam acts like a high-level interface to Canonical OpenStack, effectively -abstracting its complexity from operators. +The `OpenStack snap`_ includes ``sunbeam``, a deployment and operations tool that you will use to deploy a cloud and provision resources. +Sunbeam acts as a high-level interface to Canonical OpenStack, effectively abstracting its complexity from operators. -To install the ``openstack`` snap, execute the following terminal command: +To install the ``openstack`` snap, run the following terminal command: .. code-block :: text sudo snap install openstack -Prepare the machine -------------------- +Step 2: Prepare the machine +--------------------------- .. note :: **Duration:** 1 minute -Before we'll be able to bootstrap the cloud, we have to prepare the machine for Canonical OpenStack usage. This process includes: +You need to prepare the machine in order to bootstrap a Canonical OpenStack cloud. +This preparation includes two actions: -* ensuring all required software dependencies are installed, including the ``openssh-server``, -* configuring passwordless access to the ``sudo`` command for all terminal commands for the currently logged in user (i.e. ``NOPASSWD:ALL``). +* ensure that all required software dependencies are installed, including the ``openssh-server``, +* configure passwordless access to the ``sudo`` command for all terminal commands for the currently logged in user (i.e. ``NOPASSWD:ALL``). -In order to facilitate this process, Sunbeam can generate a script that you can further review -and execute step by step: +Sunbeam generates a script to facilitate this process. +You can pipe this script directly to Bash: .. code-block :: text - - sunbeam prepare-node-script --bootstrap - -However, if you simply want to execute all those commands at once, you can also pipe them directly to Bash instead: -.. code-block :: text - sunbeam prepare-node-script --bootstrap | bash -x && newgrp snap_daemon -Bootstrap the cloud -------------------- +.. note:: + + You can also generate a script file to review and execute step-by-step: + + .. code-block :: text + + sunbeam prepare-node-script --bootstrap + + +Step 3: Bootstrap the cloud +--------------------------- .. note :: - **Duration:** 20 minutes (exact time might vary depending on your Internet connection speed) + **Duration:** 20 minutes (depends on your Internet connection speed) + +Once the machine is ready for Canonical OpenStack, you can bootstrap the cloud: + +.. code-block :: text + + sunbeam cluster bootstrap --accept-defaults --role control,compute,storage + +Once this command completes, you will see the following message: + +.. code-block :: text + + Node has been bootstrapped with roles: storage, control, compute -Now, once the machine is ready for Canonical OpenStack usage, we can bootstrap the cloud on top of -it. Even though triggered by a single command, the overall process is relatively complex and takes -a while to complete. In principle, Sunbeam orchestrates the following actions in the background: +During the bootstrap process, Sunbeam orchestrates the following actions: * Installs `Canonical Kubernetes `_ for the purpose of hosting cloud control functions, @@ -97,24 +128,12 @@ a while to complete. In principle, Sunbeam orchestrates the following actions in * Installs the `OpenStack Hypervisor snap`_ and plugs it into cloud control services, * Installs the `MicroCeph snap`_ and plugs it into cloud control services. -To bootstrap the cloud for sample usage, execute the following command: - -.. code-block :: text - - sunbeam cluster bootstrap --accept-defaults --role control,compute,storage - .. important:: Bootstrapping may fail if the ``rootfs`` partition does not have sufficient available storage, or if there is no free, un-partitioned disk for MicroCeph. If any issue is encountered, consult the :doc:`Troubleshooting guide `. -Once it completes, you should be able to see the following message on your screen: - -.. code-block :: text - - Node has been bootstrapped with roles: storage, control, compute - .. note :: Sunbeam uses a set of credentials for access to the Juju controller. The @@ -125,29 +144,45 @@ Once it completes, you should be able to see the following message on your scree sunbeam utils juju-login -Configure the cloud -------------------- +Step 4: Configure the cloud +--------------------------- .. note :: - **Duration:** 2 minutes (exact time might vary depending on your Internet connection speed) + **Duration:** 2 minutes (depends on your Internet connection speed) -At this point your Canonical OpenStack installation is already up and running. However, to be able to demonstrate its capabilities, we have to prepare the cloud for sample use. This includes creating a ``demo`` user, populating the cloud with some common templates and creating a sandbox project with some basic configuration where we'll be able to provision resources. +Your Canonical OpenStack cloud is already up and running. +Now you need to prepare the cloud for provisioning sample resources (such as virtual machines) in a series of steps: -We will explore in :doc:`another tutorial` how this process usually looks like under the hood. However, for the time being we're simply going to let Sunbeam handle that. +1. create a ``demo`` user; +2. populate the cloud with common templates; +3. create a sandbox project with basic configuration. -To configure the cloud for sample usage, execute the following command: +Use Sunbeam to handle these steps: .. code-block :: text - + sunbeam configure --accept-defaults --openrc demo-openrc -Once it completes, you should be able to see the following message on your screen: +Once the command completes, you will see the following message: .. code-block :: text Writing openrc to demo-openrc ... done + +.. hint:: + + You will explore how cloud configuration works under the hood in the following tutorial: :doc:`On-board your users `. + +Conclusion +---------- + +Your Canonical OpenStack cloud is now ready to provision resources. + +Once you move forward with more advanced scenarios, you will see that each deployment procedure has these four steps, +regardless of the cloud architecture and the bare metal provider. + Launch a VM +++++++++++ @@ -155,9 +190,9 @@ Launch a VM **Duration:** 1 minute (first VM launch always takes longer) -The best way to verify whether Canonical OpenStack has been deployed successfully is to try to launch a VM on top of it. We will explore in :doc:`another tutorial` how this process usually looks like under the hood. However, for the time being we're simply going to let Sunbeam handle that. +Once you have a Canonical OpenStack cloud ready, you can provision a virtual machine on the cloud using Sunbeam. -In order to launch a test VM, execute the following command: +To launch a test VM, execute the following command: .. code-block :: text @@ -168,34 +203,38 @@ Sample output: .. code-block :: text Launching an OpenStack instance ... - Access instance with `ssh -i /home/ubuntu/snap/openstack/584/sunbeam ubuntu@10.20.20.94` + Access instance with `ssh -i /home/ubuntu/.config/openstack/sunbeam ubuntu@10.20.20.200` + +.. hint:: + + You will explore how resource provisioning works under the hood in the following tutorial: + :doc:`Get familiar with OpenStack `. .. TODO: Update once https://bugs.launchpad.net/snap-openstack/+bug/2045266 is solved -You should now be able to connect to your VM over SSH using the provided command: +Use the provided command to connect to the VM over SSH: .. code-block :: text ssh -i /home/ubuntu/.config/openstack/sunbeam ubuntu@10.20.20.200 -That's it. You're now connected to the VM. You can use regular shell commands to execute various tasks: +You can use regular shell commands to execute various tasks in the VM: .. code-block :: text $ uptime 10:54:29 up 1 min, 1 user, load average: 0.00, 0.00, 0.00 -To disconnect from the VM, type ``exit`` or press CTRL+D instead. +To disconnect from the VM, type ``exit`` or press CTRL+D. Next steps ++++++++++ Congratulations! +You have completed this tutorial. -You have reached the end of this tutorial. - -You can now: +Explore the next steps: -* Move to the next tutorial in this series - :doc:`"Get familiar with OpenStack"`, -* If you need to clean up the node and start over, you can check :doc:`how to remove the node `, -* Explore :doc:`How-to Guides` for instructions on setting up a production-grade environment. +* Move to the next tutorial in this series: :doc:`Get familiar with OpenStack `. +* If you need to clean up and start the tutorial over, read :doc:`Removing the primary node `. +* Learn how to set up a production-grade environment from :doc:`How-to Guides `. From 1b5916fa1a4e677054308cef3e1afe55adee0047 Mon Sep 17 00:00:00 2001 From: Nick Volynkin Date: Tue, 9 Jun 2026 10:50:14 +0300 Subject: [PATCH 2/3] docs: Rewrite the 1st tutorial, iteration 2 Temporary commit, to be squashed. Signed-off-by: Nick Volynkin --- tutorial/get-started-with-openstack.rst | 112 ++++++++++-------------- 1 file changed, 48 insertions(+), 64 deletions(-) diff --git a/tutorial/get-started-with-openstack.rst b/tutorial/get-started-with-openstack.rst index bbccf0e..29d4913 100644 --- a/tutorial/get-started-with-openstack.rst +++ b/tutorial/get-started-with-openstack.rst @@ -3,32 +3,27 @@ Get started with OpenStack Welcome! -If you are here, this likely means that you decided to give `Canonical OpenStack`_ a try. -It's complex software that you can fully tame with the right tools. - -This tutorial will help you get started with Canonical OpenStack in a few steps. -It will guide you through installing Canonical OpenStack, bootstrapping the cloud, and provisioning a VM. -To complete the tutorial, you need a single dedicated machine or VM and around 30 minutes to spare. +This tutorial will guide you through deploying a `Canonical OpenStack`_ cloud and provisioning a VM in this cloud. What you will build +++++++++++++++++++ -As a result of completing the tutorial, you will have a functioning single-node Canonical OpenStack cloud, -with the node serving the control, compute, and storage roles. +As a result of completing the tutorial, you will have a functioning single-node Canonical OpenStack cloud. This cloud will be sufficient to complete all further tutorials in this documentation. -You will also understand the four key steps of each Canonical OpenStack deployment. -Ready for the adventure? Let's explore OpenStack together! +This tutorial intentionally limits OpenStack deployment to a single machine. +APIs and cloud resources provisioned during the tutorial +are accessible only from that machine. .. note :: - This tutorial is intended to serve for learning purposes only. + This tutorial is intended for learning purposes. To deploy a production-grade cloud, refer to detailed instructions in the :doc:`How-to Guides section `. Requirements ++++++++++++ -You need a dedicated physical machine with: +To complete the tutorial, you need a single dedicated machine with the following configuration: * 4+ core amd64 processor * minimum of 16 GiB of RAM @@ -39,21 +34,11 @@ You need a dedicated physical machine with: You can also use a virtual machine instead, but you can expect some performance degradation in this case. -.. note :: - - This tutorial intentionally limits OpenStack deployment to a single machine. - You will run all terminal commands and web browser examples from this machine, - and it will not expose OpenStack APIs or any of the provisioned cloud resources - (such as VMs and floating IPs) to your network. - - To learn about production-grade deployments, refer to :doc:`How-to Guides `. - - Deploy Canonical OpenStack ++++++++++++++++++++++++++ Canonical OpenStack can be deployed in four steps. -This tutorial will demonstrate these steps and their meaning without going into deep details. +This tutorial guides you through these steps and explains their purpose. Step 1: Install the OpenStack snap ---------------------------------- @@ -62,15 +47,14 @@ Step 1: Install the OpenStack snap **Duration:** 1 minute (depends on your Internet connection speed) -The `OpenStack snap`_ includes ``sunbeam``, a deployment and operations tool that you will use to deploy a cloud and provision resources. -Sunbeam acts as a high-level interface to Canonical OpenStack, effectively abstracting its complexity from operators. - -To install the ``openstack`` snap, run the following terminal command: +Log in to the machine used in this tutorial and run the following command to install the ``openstack`` snap: .. code-block :: text sudo snap install openstack +The `OpenStack snap`_ includes ``sunbeam``, a deployment and operations tool that you will use to deploy a cloud and provision resources. + Step 2: Prepare the machine --------------------------- @@ -78,22 +62,22 @@ Step 2: Prepare the machine **Duration:** 1 minute -You need to prepare the machine in order to bootstrap a Canonical OpenStack cloud. -This preparation includes two actions: - -* ensure that all required software dependencies are installed, including the ``openssh-server``, -* configure passwordless access to the ``sudo`` command for all terminal commands for the currently logged in user (i.e. ``NOPASSWD:ALL``). - -Sunbeam generates a script to facilitate this process. -You can pipe this script directly to Bash: +Run the following command to prepare the machine for bootstrapping a Canonical OpenStack cloud: .. code-block :: text sunbeam prepare-node-script --bootstrap | bash -x && newgrp snap_daemon -.. note:: +Once the command completes, the machine is ready to bootstrap a cloud. - You can also generate a script file to review and execute step-by-step: +.. dropdown:: What happens during this step? + + The script generated and executed in the command above performs two actions: + + 1. Installs all required software dependencies (including the ``openssh-server``). + 2. Configures passwordless access to the ``sudo`` command for the currently logged in user (i.e. ``NOPASSWD:ALL``). + + You can generate a script file and review the performed actions: .. code-block :: text @@ -107,7 +91,7 @@ Step 3: Bootstrap the cloud **Duration:** 20 minutes (depends on your Internet connection speed) -Once the machine is ready for Canonical OpenStack, you can bootstrap the cloud: +Run the following command to bootstrap a Canonical OpenStack cloud on the machine: .. code-block :: text @@ -119,14 +103,16 @@ Once this command completes, you will see the following message: Node has been bootstrapped with roles: storage, control, compute -During the bootstrap process, Sunbeam orchestrates the following actions: +.. dropdown:: What happens during this step? -* Installs `Canonical Kubernetes `_ for the purpose of hosting - cloud control functions, -* Installs `Canonical Juju`_ and bootstraps a Juju controller on top of Canonical Kubernetes, -* Installs and configures cloud control functions on top of Canonical Kubernetes, -* Installs the `OpenStack Hypervisor snap`_ and plugs it into cloud control services, -* Installs the `MicroCeph snap`_ and plugs it into cloud control services. + During the bootstrap process, Sunbeam orchestrates the following actions: + + 1. Installs `Canonical Kubernetes `_ for the purpose of hosting + cloud control functions. + 2. Installs `Canonical Juju`_ and bootstraps a Juju controller on top of Canonical Kubernetes. + 3. Installs and configures cloud control functions on top of Canonical Kubernetes. + 4. Installs the `OpenStack Hypervisor snap`_ and plugs it into cloud control services. + 5. Installs the `MicroCeph snap`_ and plugs it into cloud control services. .. important:: @@ -151,14 +137,7 @@ Step 4: Configure the cloud **Duration:** 2 minutes (depends on your Internet connection speed) -Your Canonical OpenStack cloud is already up and running. -Now you need to prepare the cloud for provisioning sample resources (such as virtual machines) in a series of steps: - -1. create a ``demo`` user; -2. populate the cloud with common templates; -3. create a sandbox project with basic configuration. - -Use Sunbeam to handle these steps: +Run the following command to prepare the cloud for provisioning resources: .. code-block :: text @@ -170,18 +149,23 @@ Once the command completes, you will see the following message: Writing openrc to demo-openrc ... done +.. dropdown:: What happens during this step? -.. hint:: + The cloud preparation command performs the following actions: - You will explore how cloud configuration works under the hood in the following tutorial: :doc:`On-board your users `. + 1. Creates a ``demo`` user. + 2. Populates the cloud with common templates. + 3. Creates a sandbox project with basic configuration. + + .. note:: + + You will further explore cloud configuration in the following tutorial: :doc:`On-board your users `. Conclusion ---------- -Your Canonical OpenStack cloud is now ready to provision resources. - -Once you move forward with more advanced scenarios, you will see that each deployment procedure has these four steps, -regardless of the cloud architecture and the bare metal provider. +You now have a single-node Canonical OpenStack cloud that is ready to provision resources. +The node, deployed on your dedicated machine or VM, serves the control, compute, and storage roles. Launch a VM +++++++++++ @@ -190,12 +174,12 @@ Launch a VM **Duration:** 1 minute (first VM launch always takes longer) -Once you have a Canonical OpenStack cloud ready, you can provision a virtual machine on the cloud using Sunbeam. +You can now provision a virtual machine on your Canonical OpenStack cloud using Sunbeam. -To launch a test VM, execute the following command: +Execute the following command to provision a VM named "test": .. code-block :: text - + sunbeam launch ubuntu --name test Sample output: @@ -205,9 +189,9 @@ Sample output: Launching an OpenStack instance ... Access instance with `ssh -i /home/ubuntu/.config/openstack/sunbeam ubuntu@10.20.20.200` -.. hint:: +.. note:: - You will explore how resource provisioning works under the hood in the following tutorial: + You will further explore resource provisioning in the following tutorial: :doc:`Get familiar with OpenStack `. .. TODO: Update once https://bugs.launchpad.net/snap-openstack/+bug/2045266 is solved From 77c4daa06c2756da5ac8e43df3657bf639744579 Mon Sep 17 00:00:00 2001 From: Nick Volynkin Date: Tue, 9 Jun 2026 10:50:14 +0300 Subject: [PATCH 3/3] docs: Rewrite the 1st tutorial, iteration 3 Temporary commit, to be squashed. Signed-off-by: Nick Volynkin --- tutorial/get-started-with-openstack.rst | 54 +++++++++---------------- 1 file changed, 19 insertions(+), 35 deletions(-) diff --git a/tutorial/get-started-with-openstack.rst b/tutorial/get-started-with-openstack.rst index 29d4913..6e8b777 100644 --- a/tutorial/get-started-with-openstack.rst +++ b/tutorial/get-started-with-openstack.rst @@ -3,7 +3,7 @@ Get started with OpenStack Welcome! -This tutorial will guide you through deploying a `Canonical OpenStack`_ cloud and provisioning a VM in this cloud. +In this tutorial, you will deploy a `Canonical OpenStack`_ cloud and provision a VM in this cloud. What you will build +++++++++++++++++++ @@ -11,13 +11,13 @@ What you will build As a result of completing the tutorial, you will have a functioning single-node Canonical OpenStack cloud. This cloud will be sufficient to complete all further tutorials in this documentation. -This tutorial intentionally limits OpenStack deployment to a single machine. -APIs and cloud resources provisioned during the tutorial -are accessible only from that machine. - .. note :: This tutorial is intended for learning purposes. + It intentionally limits OpenStack deployment to a single machine. + APIs and cloud resources provisioned during the tutorial + are accessible only from that machine. + To deploy a production-grade cloud, refer to detailed instructions in the :doc:`How-to Guides section `. Requirements @@ -43,26 +43,18 @@ This tutorial guides you through these steps and explains their purpose. Step 1: Install the OpenStack snap ---------------------------------- -.. note :: - - **Duration:** 1 minute (depends on your Internet connection speed) - -Log in to the machine used in this tutorial and run the following command to install the ``openstack`` snap: +Log in to the machine used in this tutorial and run the following command to install the `OpenStack snap`_: .. code-block :: text sudo snap install openstack -The `OpenStack snap`_ includes ``sunbeam``, a deployment and operations tool that you will use to deploy a cloud and provision resources. +The ``openstack`` snap includes ``sunbeam``, a deployment and operations tool that you will use to deploy a cloud and provision resources. Step 2: Prepare the machine --------------------------- -.. note :: - - **Duration:** 1 minute - -Run the following command to prepare the machine for bootstrapping a Canonical OpenStack cloud: +Run the following command to prepare the machine for Canonical OpenStack: .. code-block :: text @@ -87,10 +79,6 @@ Once the command completes, the machine is ready to bootstrap a cloud. Step 3: Bootstrap the cloud --------------------------- -.. note :: - - **Duration:** 20 minutes (depends on your Internet connection speed) - Run the following command to bootstrap a Canonical OpenStack cloud on the machine: .. code-block :: text @@ -114,30 +102,26 @@ Once this command completes, you will see the following message: 4. Installs the `OpenStack Hypervisor snap`_ and plugs it into cloud control services. 5. Installs the `MicroCeph snap`_ and plugs it into cloud control services. -.. important:: + .. important:: - Bootstrapping may fail if the ``rootfs`` partition does not have sufficient - available storage, or if there is no free, un-partitioned disk for MicroCeph. - If any issue is encountered, consult the :doc:`Troubleshooting guide `. + Bootstrap process may fail if the ``rootfs`` partition does not have sufficient + available storage, or if there is no free, un-partitioned disk for MicroCeph. + If any issue is encountered, consult the :doc:`Troubleshooting guide `. -.. note :: + .. note :: - Sunbeam uses a set of credentials for access to the Juju controller. The - authenticated session expires after 24 hours. You can re-authenticate by - running: + Sunbeam creates a set of credentials to access the Juju controller. + An authenticated session expires after 24 hours. + Run the following command to re-authenticate: - .. code-block :: text + .. code-block :: text - sunbeam utils juju-login + sunbeam utils juju-login Step 4: Configure the cloud --------------------------- -.. note :: - - **Duration:** 2 minutes (depends on your Internet connection speed) - -Run the following command to prepare the cloud for provisioning resources: +Run the following command to apply initial configuration that allows the cloud to provision resources: .. code-block :: text