mirror of
https://github.com/clearlinux/clear-linux-documentation.git
synced 2026-11-21 11:06:14 +00:00
azure.rst: Editorial changes (#779)
* Editorial changes to azure.rst Signed-off-by: DougTW <doug.martin@intel.com> * Added contents directive to asure.rst Signed-off-by: DougTW <doug.martin@intel.com> * Requested revisions to azure.rst - Reworded introduction paragraph (per mvincerx) - Removed redundant section references (per mvincerx) - Reworded Azure portal access paragraph (per mvincerx) - Removed extraneous "Once complete" from line 302-303 (per mvincerx) Signed-off-by: DougTW <doug.martin@intel.com>
This commit is contained in:
@@ -1,9 +1,20 @@
|
||||
.. _azure:
|
||||
|
||||
|CL-ATTR| on Microsoft Azure
|
||||
############################
|
||||
|CL-ATTR| on Microsoft\* Azure\*
|
||||
################################
|
||||
|
||||
|CL-ATTR| is available for you to use in the Microsoft* Azure* marketplace and
|
||||
This tutorial shows how to install and use the Azure :abbr:`CLI (Command Line
|
||||
Interface)` on |CL|. The Azure CLI offers the ability to create and
|
||||
manage resources in MS Azure from the command line.
|
||||
|
||||
.. contents::
|
||||
:local:
|
||||
:depth: 1
|
||||
|
||||
Description
|
||||
***********
|
||||
|
||||
|CL| is available for you to use in the Microsoft Azure marketplace and
|
||||
is offered with three different images, also known as a
|
||||
:abbr:`SKU (Stock Keeping Unit)`.
|
||||
|
||||
@@ -17,26 +28,13 @@ is offered with three different images, also known as a
|
||||
* |CL| Machine-learning - This SKU comes pre-loaded with popular open source
|
||||
tools for developing machine learning applications.
|
||||
|
||||
You can access these images directly from your MS Azure dashboard through the
|
||||
`Azure portal`_ or by using the MS Azure :abbr:`CLI (Command Line Interface)`
|
||||
2.0. If you do not already have an account set up with MS Azure, you can sign
|
||||
up for a `MS Azure free account`_ to access the |CL|
|
||||
:abbr:`VM(Virtual Machine)` images.
|
||||
Sign in at the `Azure portal`_ to access these images from the Azure dashboard,
|
||||
or use the MS Azure CLI 2.0. If you do not already have an account set up with
|
||||
MS Azure, you can sign up for a `MS Azure free account`_ to access the
|
||||
|CL| :abbr:`VM (Virtual Machine)` images.
|
||||
|
||||
The Azure CLI offers the ability to create and manage resources in MS Azure
|
||||
from the command line. In this tutorial you learn to:
|
||||
|
||||
#. Install the latest MS Azure CLI on your |CL| machine.
|
||||
|
||||
#. Log into MS Azure using the CLI 2.0 interface.
|
||||
|
||||
#. Create a MS Azure resource group.
|
||||
|
||||
#. Locate the |CL| images.
|
||||
|
||||
#. Create and log into the |CL| virtual machine.
|
||||
|
||||
#. Stop and deallocate the |CL| VM and resources.
|
||||
Prerequisites
|
||||
*************
|
||||
|
||||
To use the MS Azure CLI 2.0 on your |CL| system, your system must have the
|
||||
following packages installed:
|
||||
@@ -47,7 +45,7 @@ following packages installed:
|
||||
|
||||
* OpenSSL 1.0.2
|
||||
|
||||
You can check to see what versions you have installed on your system by
|
||||
You can check to see which versions you have installed on your system by
|
||||
running the individual commands as follows:
|
||||
|
||||
.. code-block:: bash
|
||||
@@ -119,18 +117,18 @@ Install MS Azure CLI 2.0 on |CL|
|
||||
|
||||
===> In what directory would you like to place the install? (leave blank to use '/home/[user]/lib/azure-cli'):
|
||||
|
||||
Press the :kbd:`Enter` key to accept the default or you can chose another
|
||||
directory to install the MS Azure CLI 2.0 tools into.
|
||||
Press the :kbd:`Enter` key to accept the default or chose another
|
||||
directory in which to install the MS Azure CLI 2.0 tools.
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
===> In what directory would you like to place the 'az' executable? (leave blank to use '/home/[user]/bin'):
|
||||
|
||||
Press the :kbd:`Enter` key to accept the default or you can chose another
|
||||
directory to install the :command:`az` executable in.
|
||||
Press the :kbd:`Enter` key to accept the default or chose another
|
||||
directory in which to install the :command:`az` executable.
|
||||
|
||||
#. The installation downloads and builds all required tools and when complete
|
||||
prompts you with:
|
||||
#. The installation downloads and builds all the required tools. When it is
|
||||
complete, it prompts you:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
@@ -157,7 +155,7 @@ Install MS Azure CLI 2.0 on |CL|
|
||||
-- Installation successful.
|
||||
-- Run the CLI with /home/[user]/bin/az --help
|
||||
|
||||
#. The installation program finishes and you must restart your shell for
|
||||
#. When the installation program finishes, you must restart your shell for
|
||||
the changes to take effect. When the installation is successful, run the
|
||||
following command to restart your shell.
|
||||
|
||||
@@ -286,13 +284,13 @@ Log into your Microsoft Azure account
|
||||
|
||||
Figure 2: :guilabel:`Microsoft Device Login - Azure CLI`
|
||||
|
||||
#. Once you enter the authentication code, the website changes to a screen to
|
||||
#. Once you enter the authentication code, the website displays a screen to
|
||||
enter your existing Microsoft Azure credentials.
|
||||
|
||||
#. Log in with your existing MS Azure account credentials. Once complete, the
|
||||
browser screen changes again as shown in figure 3. The screen shows you
|
||||
have signed into the Microsoft Cross-platform Command Line Interface
|
||||
application on your device and you can close the window.
|
||||
#. Log in with your existing MS Azure account credentials. The
|
||||
browser screen shows you have signed into the Microsoft Cross-platform
|
||||
Command Line Interface application on your device, as shown in figure 3.
|
||||
You can close the page.
|
||||
|
||||
.. figure:: /_figures/azure/azure-3.png
|
||||
:scale: 50 %
|
||||
@@ -310,7 +308,7 @@ To learn more about MS Azure resource groups, visit the
|
||||
`Azure Resource Manager overview`_ for an overview and detailed description
|
||||
of resources within MS Azure.
|
||||
|
||||
#. To create our new resource group, run the :command:`az group create ...`
|
||||
#. To create a new resource group, run the :command:`az group create ...`
|
||||
command shown below to create a resource group named `ClearResourceGroup`
|
||||
using the `-n` parameter and locate it in the `westus` region using the
|
||||
`-l` parameter.
|
||||
@@ -372,7 +370,7 @@ For this tutorial, we are using the |CL| Basic SKU for our VM.
|
||||
image, you can use the version label `latest` when specifying an image.
|
||||
|
||||
#. The information shown in the `Urn` column lists the
|
||||
`Publisher:Offer:Sku:Version` for each image available and this is the
|
||||
`Publisher:Offer:Sku:Version` for each image available. This is the
|
||||
information we want to create the |CL| Basic VM. Since we are creating a
|
||||
|CL| Basic VM, highlight the `clear-linux-project:clear-linux-os:basic:`
|
||||
string and copy it to your clipboard. Use the label
|
||||
@@ -392,7 +390,7 @@ For this tutorial, we are using the |CL| Basic SKU for our VM.
|
||||
are stored in your :file:`$HOME/.ssh` directory, you do not need to
|
||||
include the *--generate-ssh-keys* option.
|
||||
|
||||
Your output from this command will look similar to this output, where
|
||||
The output from this command will look similar to this output, where
|
||||
[user] is your user name:
|
||||
|
||||
.. code-block:: console
|
||||
@@ -436,7 +434,8 @@ For this tutorial, we are using the |CL| Basic SKU for our VM.
|
||||
|
||||
You are now logged into your new |CL| VM as [user], where [user] is your
|
||||
user name. To check which software bundles are included with
|
||||
this VM image, run the :command:`sudo swupd bundle-list` command inside the VM:
|
||||
this VM image, run the :command:`sudo swupd bundle-list` command inside the
|
||||
VM:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
@@ -505,10 +504,8 @@ incurring charges for them, you must deallocate the resources as well.
|
||||
|
||||
az vm deallocate --resource-group ClearResourceGroup --name ClearVM
|
||||
|
||||
**Congratulations!**
|
||||
|
||||
You are up and running with |CL| on MS Azure using the Azure
|
||||
CLI 2.0 command line tools.
|
||||
**Congratulations!** You are up and running with |CL| on MS Azure using the
|
||||
Azure CLI 2.0 command line tools.
|
||||
|
||||
Next steps
|
||||
**********
|
||||
|
||||
Reference in New Issue
Block a user