clearlinux/clear-linux-documentation
2
0
Fork 0
mirror of https://github.com/clearlinux/clear-linux-documentation.git synced 2026-08-25 09:27:37 +00:00
Code Issues Packages Projects Releases Wiki Activity

Rework the azure.rst document

Browse Source 
Incorporate changes requested by Bun and Rodrigo with major changes to
some content

Signed-off-by: Tom Leavitt <30448839+tpleavitt@users.noreply.github.com>
This commit is contained in:
Tom Leavitt
2018-01-25 13:28:39 -08:00
parent 5fb205a1ad
commit 4177fef6df
5 changed files with 523 additions and 497 deletions
Download Patch File Download Diff File Expand all files Collapse all files
source/clear-linux/tutorials/azure.rst
-497
View File
@@ -1,497 +0,0 @@
.. _azure:
Run Clear Linux using Microsoft Azure CLI 2.0
#############################################
|CLOSIA| is available for you to use in the Microsoft* Azure* marketplace and
is offered with three different images:
* |CL| Basic - A bare-bones system which can be used as a starting point for
those wanting to explore and build out a system with additional software
bundles of their choosing.
* |CL| Containers - This offering comes with the containers-basic software
bundle already installed.
* |CL| Machine-learning - This offering 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.
The Azure Command Line Interface offers the ability to create and manage
resources in 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.
#. Locate the |CL| images.
#. Create a MS Azure resource group.
#. Create a |CL| virtual machine.
#. Log into the |CL| VM and use it.
#. Stop the |CL| VM.
#. Deallocate resources to stop incurring charges.
Install MS Azure CLI 2.0 on Clear Linux
***************************************
Prerequisites for using the MS Azure CLI 2.0 on your |CL| system require you
to have Python 2.7 or later, libffi, and OpenSSL 1.0.2 installed. You can
check to see what versions you have installed on your system by running the
individual commands as follows:
.. code-block:: console
$ python --version
python 2.7.12
$ openssl version
OpenSSL 1.0.2n 7 Dec 2017
$ls -l /usr/lib64/libffi*
lrwxrwxrwx 1 root root 15 Jan 12 2017 /usr/lib64/libffi.so.6 -> libffi.so.6.0.4
-rwxr-xr-x 1 root root 38792 Jan 12 2017 /usr/lib64/libffi.so.6.0.4
If you do not have these packages installed on your |CL| system, install the
sysadmin-basic software bundle using the :command:`swupd` command:
.. code-block:: console
$ sudo swupd bundle-add sysadmin-basic
.. note::
These instructions are for installing the MS Azure CLI 2.0 tools on a |CL|
system. If you are installing the CLI on another platform, follow the
instructions in the `MS Azure Install Azure CLI tutorial`_ for your
specific operating system.
To install the MS Azure CLI 2.0 on |CL|, use the :command:`curl` command as
shown:
.. code-block:: console
$ curl -L https://aka.ms/InstallAzureCli | bash
If you get an error message from :command:`curl` related to the -L parameter,
or an error message is generated that includes the text "Object Moved", use
the full URL instead of the aka.ms redirect address:
.. code-block:: console
$ curl https://azurecliprod.blob.core.windows.net/install | bash
The installation script begins and prompts you several times during execution
for information.
.. note::
Your username will be substituted for :envvar:`$USER` in these prompts.
.. code-block:: console
===> 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.
.. 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.
The installation downloads and builds all required tools and when complete
prompts you with:
.. code-block:: console
===> Modify profile to update your $PATH and enable shell/tab completion now? (Y/n): Y
Type :kbd:`y` and press the :kbd:`Enter` key to allow this modification.
.. code-block:: console
===> Enter a path to an rc file to update (leave blank to use '/home/$USER/.bashrc'):
Press the :kbd:`Enter` key to accept the default or enter the pathname to your
:file:`.bashrc` file. The installation completes with the final output shown
below:
.. code-block:: console
-- Backed up '/home/$USER/.bashrc' to '/home/$USER/.bashrc.backup'
-- Tab completion set up complete.
-- If tab completion is not activated, verify that '/home/$USER/.bashrc' is sourced by your shell.
--
-- ** Run `exec -l $SHELL` to restart your shell. **
--
-- Installation successful.
-- Run the CLI with /home/tom/bin/az --help
The installation program finishes and you need to restart your shell for the
changes to take effect. If the installation is successful, run the following
command to restart your shell.
.. code-block:: console
$ exec -l $SHELL
With the MS Azure CLI 2.0 executable successfully built and installed, run the
:command:`az` command.
.. code-block:: console
$ az
The output from the :command:`az` command is shown below:
.. code-block:: console
/\
/ \ _____ _ _ __ ___
/ /\ \ |_ / | | | \'__/ _ \
/ ____ \ / /| |_| | | | __/
/_/ \_\/___|\__,_|_| \___|
Welcome to the cool new Azure CLI!
Here are the base commands:
account : Manage Azure subscription information.
acr : Manage Azure Container Registries.
acs : Manage Azure Container Services.
ad : Synchronize on-premises directories and manage Azure Active Directory
resources.
advisor : (PREVIEW) Manage Azure Advisor.
aks : Manage Kubernetes clusters.
appservice : Manage App Service plans.
backup : Commands to manage Azure Backups.
batch : Manage Azure Batch.
batchai : Batch AI.
billing : Manage Azure Billing.
cdn : Manage Azure Content Delivery Networks (CDNs).
cloud : Manage registered Azure clouds.
cognitiveservices: Manage Azure Cognitive Services accounts.
configure : Display and manage the Azure CLI 2.0 configuration. This command is
interactive.
consumption : Manage consumption of Azure resources.
container : (PREVIEW) Manage Azure Container Instances.
cosmosdb : Manage Azure Cosmos DB database accounts.
disk : Manage Azure Managed Disks.
dla : (PREVIEW) Manage Data Lake Analytics accounts, jobs, and catalogs.
dls : (PREVIEW) Manage Data Lake Store accounts and filesystems.
eventgrid : Manage Azure Event Grid topics and subscriptions.
extension : Manage and update CLI extensions.
feature : Manage resource provider features.
feedback : Loving or hating the CLI? Let us know!
find : Find Azure CLI commands.
functionapp : Manage function apps.
group : Manage resource groups and template deployments.
image : Manage custom virtual machine images.
interactive : Start interactive mode.
iot : (PREVIEW) Manage Internet of Things (IoT) assets.
keyvault : Safeguard and maintain control of keys, secrets, and certificates.
lab : Manage Azure DevTest Labs.
lock : Manage Azure locks.
login : Log in to Azure.
logout : Log out to remove access to Azure subscriptions.
managedapp : Manage template solutions provided and maintained by Independent Software
Vendors (ISVs).
monitor : Manage the Azure Monitor Service.
mysql : Manage Azure Database for MySQL servers.
network : Manage Azure Network resources.
policy : Manage resource policies.
postgres : Manage Azure Database for PostgreSQL servers.
provider : Manage resource providers.
redis : Access to a secure, dedicated Redis cache for your Azure applications.
reservations : Manage Azure Reservations.
resource : Manage Azure resources.
role : Manage user roles for access control with Azure Active Directory and service
principals.
sf : Manage and administer Azure Service Fabric clusters.
snapshot : Manage point-in-time copies of managed disks, native blobs, or other
snapshots.
sql : Manage Azure SQL Databases and Data Warehouses.
storage : Manage Azure Cloud Storage resources.
tag : Manage resource tags.
vm : Provision Linux or Windows virtual machines.
vmss : Manage groupings of virtual machines in an Azure Virtual Machine Scale Set
(VMSS).
webapp : Manage web apps.
Log into your Microsoft Azure account
*************************************
With the :command:`az` command properly installed and functional, login to
your MS Azure account using the :command:`az login` command. You will be
prompted to open your browser and enter the displayed URL and enter the code
XXXXXXXXX to authenticate, where XXXXXXXXX is a random code generated for each
session.
.. code-block:: console
$ az login
The output from this command is:
.. code-block:: console
To sign in, use a web browser to open the page https://aka.ms/devicelogin and enter the code XXXXXXXXX to authenticate.
Following the instructions, the website takes you to a MS Azure device login
page and asks you to enter the generated code. Enter the code and the
website changes to a browser screen to enter your existing Microsoft Azure
credentials. Log in with your Azure account credentials. Once complete, the
browser screen changes, telling you that you have signed in to the Microsoft
Cross-platform Command Line Interface application on your device and you can
close the window. The MS Azure CLI 2.0 interface is now active with your
Azure account information.
Locate the Clear Linux image
****************************
You can locate the available clear linux images in the MS Azure marketplace by
running the following :command:`az` command:
.. code-block:: console
$ az vm image list --offer clear-linux --all --output table
This command may take some time to finish and the output lists all available
|CL| images available in the Microsoft Azure marketplace and is shown below:
.. code-block:: console
Offer Publisher Sku Urn Version
-------------- ------------------- ---------------- ------------------------------------------------------------- ---------
clear-linux-os clear-linux-project basic clear-linux-project:clear-linux-os:basic:15780.0.0 15780.0.0
clear-linux-os clear-linux-project basic clear-linux-project:clear-linux-os:basic:15960.0.0 15960.0.0
clear-linux-os clear-linux-project basic clear-linux-project:clear-linux-os:basic:16050.0.0 16050.0.0
clear-linux-os clear-linux-project basic clear-linux-project:clear-linux-os:basic:16150.0.0 16150.0.0
clear-linux-os clear-linux-project basic clear-linux-project:clear-linux-os:basic:16500.0.0 16500.0.0
clear-linux-os clear-linux-project basic clear-linux-project:clear-linux-os:basic:16810.0.0 16810.0.0
clear-linux-os clear-linux-project basic clear-linux-project:clear-linux-os:basic:18080.0.0 18080.0.0
clear-linux-os clear-linux-project basic clear-linux-project:clear-linux-os:basic:18620.0.0 18620.0.0
clear-linux-os clear-linux-project basic clear-linux-project:clear-linux-os:basic:18860.0.0 18860.0.0
clear-linux-os clear-linux-project containers clear-linux-project:clear-linux-os:containers:15780.0.0 15780.0.0
clear-linux-os clear-linux-project containers clear-linux-project:clear-linux-os:containers:15960.0.0 15960.0.0
clear-linux-os clear-linux-project containers clear-linux-project:clear-linux-os:containers:16050.0.0 16050.0.0
clear-linux-os clear-linux-project containers clear-linux-project:clear-linux-os:containers:16150.0.0 16150.0.0
clear-linux-os clear-linux-project containers clear-linux-project:clear-linux-os:containers:16500.0.0 16500.0.0
clear-linux-os clear-linux-project containers clear-linux-project:clear-linux-os:containers:16810.0.0 16810.0.0
clear-linux-os clear-linux-project containers clear-linux-project:clear-linux-os:containers:18080.0.0 18080.0.0
clear-linux-os clear-linux-project containers clear-linux-project:clear-linux-os:containers:18620.0.0 18620.0.0
clear-linux-os clear-linux-project containers clear-linux-project:clear-linux-os:containers:18860.0.0 18860.0.0
clear-linux-os clear-linux-project machine-learning clear-linux-project:clear-linux-os:machine-learning:15780.0.0 15780.0.0
clear-linux-os clear-linux-project machine-learning clear-linux-project:clear-linux-os:machine-learning:15960.0.0 15960.0.0
clear-linux-os clear-linux-project machine-learning clear-linux-project:clear-linux-os:machine-learning:16050.0.0 16050.0.0
clear-linux-os clear-linux-project machine-learning clear-linux-project:clear-linux-os:machine-learning:16150.0.0 16150.0.0
clear-linux-os clear-linux-project machine-learning clear-linux-project:clear-linux-os:machine-learning:16500.0.0 16500.0.0
clear-linux-os clear-linux-project machine-learning clear-linux-project:clear-linux-os:machine-learning:16810.0.0 16810.0.0
clear-linux-os clear-linux-project machine-learning clear-linux-project:clear-linux-os:machine-learning:18080.0.0 18080.0.0
clear-linux-os clear-linux-project machine-learning clear-linux-project:clear-linux-os:machine-learning:18620.0.0 18620.0.0
clear-linux-os clear-linux-project machine-learning clear-linux-project:clear-linux-os:machine-learning:18860.0.0 18860.0.0
The information shown in the `Urn` column lists the
`Publisher:Offer:Sku:Version` for each image available and this is the
information to use to create the |CL| 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. For the version you can use the label `latest` instead
of referencing a specific version, which is what we will do when we create our
VM in a moment.
Create a MS Azure resource group
********************************
With all the information gathered, we need to create a resource group to
manage multiple resources within MS Azure for our |CL| VM. To learn more about
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` 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.
.. code-block:: console
$ az group create -n ClearResourceGroup -l westus
When the command has completed, the output from this command is similar to
the following:
.. code-block:: console
{
"id": "/subscriptions/{unique-id}/resourceGroups/ClearResourceGroup",
"location": "westus",
"managedBy": null,
"name": "ClearResourceGroup",
"properties": {
"provisioningState": "Succeeded"
},
"tags": null
}
Create a |CL| virtual machine
*****************************
To create a new |CL| VM, run the following :command:`az` command using the
URN `:clear-linux-project:clear-linux-os:basic:latest` that we located earlier
in our search for the |CL| images available in the MS Azure marketplace:
.. code-block:: console
$ az vm create --resource-group ClearResourceGroup --name ClearVM --image clear-linux-project:clear-linux-os:basic:latest --generate-ssh-keys
.. note::
If you have already defined your public/private SSH key pair and they are
stored in your :file:`$HOME/.ssh` directory, you do not need to include the
:parameter:`--generate-ssh-keys` parameter.
Your output from this command will look similar to this output, where $USER is
your user name:
.. code-block:: console
SSH key files '/home/$USER/.ssh/id_rsa' and '/home/$USER/.ssh/id_rsa.pub' have been generated under ~/.ssh to allow SSH access to the VM. If using machines without permanent storage, back up your keys to a safe location.
running...
{
"fqdns": "",
"id": "/subscriptions/{unique-id}/resourceGroups/ClearResourceGroup/providers/Microsoft.Compute/virtualMachines/ClearVM",
"location": "westus",
"macAddress": "00-0D-3A-37-C7-59",
"powerState": "VM running",
"privateIpAddress": "10.0.0.4",
"publicIpAddress": "13.91.4.245",
"resourceGroup": "ClearResourceGroup",
"zones": ""
}
Take note of the public IP address from your output. To login into the new
|CL| VM, run the :command:`ssh` command with the public IP address listed as
shown:
.. code-block:: console
$ ssh 13.91.4.245
You may see the following message about the authenticity of the host. If this
appears, type `yes` to proceed connecting to your new |CL| VM.
.. code-block:: console
The authenticity of host '13.91.4.245 (13.91.4.245)' can't be established.
RSA key fingerprint is SHA256:{unique-number}.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added '13.91.4.245' (RSA) to the list of known hosts.
USER@ClearVM ~ $
You are now logged into your new |CL| VM as USER, where USER is your user
name. Let's check to see which software bundles have been included with this
image by running the :command:`swupd` command:
.. code-block:: console
USER@ClearVM ~ $ sudo swupd bundle-list
swupd-client bundle list 3.14.1
Copyright (C) 2012-2017 Intel Corporation
bootloader
editors
kernel-hyperv
network-basic
openssh-server
os-cloudguest-azure
os-core
os-core-update
perl-basic
python-basic
python3-basic
storage-utils
sysadmin-basic
Current OS version: 19600
USER@ClearVM ~ $
When you are finished using your new |CL| VM, type :command:`exit` to close
the terminal and logout.
Stop and deallocate the Clear Linux VM
**************************************
When you are finished using your new |CL| instance, you need to stop the VM
and deallocate the resources to stop incurring charges for this instance. At
your command prompt, enter the :command:`az vm stop...` command as follows:
.. code-block:: console
$ az vm stop --resource-group ClearResourceGroup --name ClearVM
This will stop the VM and then output text similar to what is shown below:
.. code-block:: console
{
"endTime": "2017-12-13T23:04:02.346676+00:00",
"error": null,
"name": "{unique-name}",
"startTime": "2017-12-13T23:03:59.018536+00:00",
"status": "Succeeded"
}
Once the VM has stopped, deallocate the VM resources to stop incurring charges
for the |CL| instance. Enter the following command:
.. code-block:: console
$ az vm deallocate --resource-group ClearResourceGroup --name ClearVM
Next steps
**********
Congratulations! You are up and running with |CL| on MS Azure using the Azure
CLI 2.0 command line tools. To see what you can do with your |CL| instance,
visit our :ref:`tutorials <tutorials>` section for examples on using your |CL|
system.
For additional information visit the Clear Linux
`Azure Partner Mini Case Study`_ and the `Azure Partner Datasheet`_.
To learn more about the MS Azure CLI 2.0 tool and options that are available,
visit the `MS Azure documentation and tutorials`_ website.
.. _`Azure Portal`:
https://portal.azure.com
.. _`MS Azure free account`:
https://azure.microsoft.com/en-us/free/
.. _`MS Azure documentation and tutorials`:
https://docs.microsoft.com/en-us/cli/azure/overview?view=azure-cli-latest
.. _`MS Azure Install Azure CLI tutorial`:
https://docs.microsoft.com/en-us/cli/azure/install-azure-cli?view=azure-cli-latest
.. _`Azure Resource Manager overview`:
https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-group-overview
.. _Azure Partner Datasheet:
http://download.microsoft.com/download/D/9/E/D9E22342-96D9-4455-BB15-99A1AF514DDD/Microsoft%20Azure%20Partner%20Datasheet%20-%20Intel%20Clear%20Linux.pdf
.. _Azure Partner Mini Case Study:
http://download.microsoft.com/download/D/9/E/D9E22342-96D9-4455-BB15-99A1AF514DDD/Microsoft%20Azure%20Partner%20Mini%20Case%20Study%20-%20Intel%20Clear%20Linux.pdf
source/clear-linux/tutorials/azure/azure.rst
+523
View File
@@ -0,0 +1,523 @@
.. _azure:
Run Clear Linux using Microsoft Azure CLI 2.0
#############################################
|CLOSIA| 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)`
* |CL| Basic - This SKU consists of a bare-bones system which can be used as a
starting point for those wanting to explore and build out a system with
additional software bundles of their choosing.
* |CL| Containers - This SKU comes with the containers-basic software bundle
already installed.
* |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.
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 for using the MS Azure CLI 2.0 on your |CL| system require you
to have the following installed on your system:
* Python 2.7 or later
* libffi
* OpenSSL 1.0.2
You can check to see what versions you have installed on your system by
running the individual commands as follows:
.. code-block:: console
$ python --version
python 2.7.12
$ openssl version
OpenSSL 1.0.2n 7 Dec 2017
$ls -l /usr/lib64/libffi*
lrwxrwxrwx 1 root root 15 Jan 12 2017 /usr/lib64/libffi.so.6 -> libffi.so.6.0.4
-rwxr-xr-x 1 root root 38792 Jan 12 2017 /usr/lib64/libffi.so.6.0.4
If you do not have these packages installed on your |CL| system, install the
sysadmin-basic software bundle using the :command:`swupd` command:
.. code-block:: console
$ sudo swupd bundle-add sysadmin-basic
.. note::
These instructions are for installing the MS Azure CLI 2.0 tools on a |CL|
system. If you are installing the CLI on another platform, follow the
instructions in the `MS Azure Install Azure CLI tutorial`_ for your
specific operating system.
Install MS Azure CLI 2.0 on Clear Linux
***************************************
#. To install the MS Azure CLI 2.0 on |CL|, use the :command:`curl` command as
shown:
.. code-block:: console
$ curl -L https://aka.ms/InstallAzureCli | bash
If you get an error message from :command:`curl` related to the -L
parameter, or an error message is generated that includes the text "Object
Moved", use the full URL instead of the aka.ms redirect address:
.. code-block:: console
$ curl https://azurecliprod.blob.core.windows.net/install | bash
#. The installation script begins and prompts you several times during
execution for information.
.. note::
Your current username will be substituted for the [user] variable in the
installation script prompts and output text to the console.
.. code-block:: console
===> 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.
.. 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.
#. The installation downloads and builds all required tools and when complete
prompts you with:
.. code-block:: console
===> Modify profile to update your $PATH and enable shell/tab completion now? (Y/n): Y
Type :kbd:`y` and press the :kbd:`Enter` key to allow this modification.
.. code-block:: console
===> Enter a path to an rc file to update (leave blank to use '/home/[user]/.bashrc'):
Press the :kbd:`Enter` key to accept the default or enter the pathname to
your :file:`.bashrc` file. The installation completes with the final output
shown below:
.. code-block:: console
-- Backed up '/home/[user].bashrc' to '/home/[user]/.bashrc.backup'
-- Tab completion set up complete.
-- If tab completion is not activated, verify that '/home/[user]/.bashrc' is sourced by your shell.
--
-- ** Run `exec -l $SHELL` to restart your shell. **
--
-- Installation successful.
-- Run the CLI with /home/[user]/bin/az --help
#. The installation program finishes and you need to restart your shell for
the changes to take effect. If the installation is successful, run the
following command to restart your shell.
.. code-block:: console
$ exec -l $SHELL
With the MS Azure CLI 2.0 executable successfully built and installed, run
the :command:`az` command.
.. code-block:: console
$ az
The output from the :command:`az` command is shown below:
.. code-block:: console
/\
/ \ _____ _ _ __ ___
/ /\ \ |_ / | | | \'__/ _ \
/ ____ \ / /| |_| | | | __/
/_/ \_\/___|\__,_|_| \___|
Welcome to the cool new Azure CLI!
Here are the base commands:
account : Manage Azure subscription information.
acr : Manage Azure Container Registries.
acs : Manage Azure Container Services.
ad : Synchronize on-premises directories and manage Azure Active Directory
resources.
advisor : (PREVIEW) Manage Azure Advisor.
aks : Manage Kubernetes clusters.
appservice : Manage App Service plans.
backup : Commands to manage Azure Backups.
batch : Manage Azure Batch.
batchai : Batch AI.
billing : Manage Azure Billing.
cdn : Manage Azure Content Delivery Networks (CDNs).
cloud : Manage registered Azure clouds.
cognitiveservices: Manage Azure Cognitive Services accounts.
configure : Display and manage the Azure CLI 2.0 configuration. This command is
interactive.
consumption : Manage consumption of Azure resources.
container : (PREVIEW) Manage Azure Container Instances.
cosmosdb : Manage Azure Cosmos DB database accounts.
disk : Manage Azure Managed Disks.
dla : (PREVIEW) Manage Data Lake Analytics accounts, jobs, and catalogs.
dls : (PREVIEW) Manage Data Lake Store accounts and filesystems.
eventgrid : Manage Azure Event Grid topics and subscriptions.
extension : Manage and update CLI extensions.
feature : Manage resource provider features.
feedback : Loving or hating the CLI? Let us know!
find : Find Azure CLI commands.
functionapp : Manage function apps.
group : Manage resource groups and template deployments.
image : Manage custom virtual machine images.
interactive : Start interactive mode.
iot : (PREVIEW) Manage Internet of Things (IoT) assets.
keyvault : Safeguard and maintain control of keys, secrets, and certificates.
lab : Manage Azure DevTest Labs.
lock : Manage Azure locks.
login : Log in to Azure.
logout : Log out to remove access to Azure subscriptions.
managedapp : Manage template solutions provided and maintained by Independent Software
Vendors (ISVs).
monitor : Manage the Azure Monitor Service.
mysql : Manage Azure Database for MySQL servers.
network : Manage Azure Network resources.
policy : Manage resource policies.
postgres : Manage Azure Database for PostgreSQL servers.
provider : Manage resource providers.
redis : Access to a secure, dedicated Redis cache for your Azure applications.
reservations : Manage Azure Reservations.
resource : Manage Azure resources.
role : Manage user roles for access control with Azure Active Directory and service
principals.
sf : Manage and administer Azure Service Fabric clusters.
snapshot : Manage point-in-time copies of managed disks, native blobs, or other
snapshots.
sql : Manage Azure SQL Databases and Data Warehouses.
storage : Manage Azure Cloud Storage resources.
tag : Manage resource tags.
vm : Provision Linux or Windows virtual machines.
vmss : Manage groupings of virtual machines in an Azure Virtual Machine Scale Set
(VMSS).
webapp : Manage web apps.
Log into your Microsoft Azure account
*************************************
#. With the :command:`az` command properly installed and functional, login to
your MS Azure account using the :command:`az login` command shown below:
.. code-block:: console
$ az login
The output from this command is:
.. code-block:: console
To sign in, use a web browser to open the page https://aka.ms/devicelogin and enter the code BQ9MG442B to authenticate.
#. Open your browser and enter the page `https://aka.ms/devicelogin` as shown
in figure 1:
.. figure:: figures/azure-1.png
:scale: 50 %
:alt: Microsoft Device Login
Figure 1: :guilabel:`Microsoft Device Login`
#. Enter the code `BQ9MG442B` to authenticate your device as shown in figure
2. The code `BQ9MG442B` is a random authentication code generated for each
session login and will be different each time you log into MS Azure using
the :command:`az login` command.
.. figure:: figures/azure-2.png
:scale: 50 %
:alt: Microsoft Device Login - Azure CLI
Figure 2: :guilabel:`Microsoft Device Login - Azure CLI`
#. Once you enter the authentication code, the website changes to 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, telling you that you
have signed in to the Microsoft Cross-platform Command Line Interface
application on your device and you can close the window.
.. figure:: figures/azure-3.png
:scale: 50 %
:alt: Microsoft Azure Cross-platform CLI
Figure 3: :guilabel:`Microsoft Azure Cross-platform CLI`
The MS Azure CLI 2.0 interface is now active using your existing MS Azure
account credentials.
Create a MS Azure resource group
********************************
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 ...`
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.
.. code-block:: console
$ az group create -n ClearResourceGroup -l westus
#. When the command has completed, the output from this command is similar to
the following:
.. code-block:: console
{
"id": "/subscriptions/{unique-id}/resourceGroups/ClearResourceGroup",
"location": "westus",
"managedBy": null,
"name": "ClearResourceGroup",
"properties": {
"provisioningState": "Succeeded"
},
"tags": null
}
Create and log into the Clear Linux virtual machine
***************************************************
For this tutorial, we are using the |CL| Basic SKU for our VM.
#. To locate the available clear linux Basic VM SKU images in the MS Azure
marketplace, run the :command:`az vm image ...` command:
.. code-block:: console
$ az vm image list --offer clear-linux --sku basic --all --output table
This command may take some time to finish. The output lists all available
|CL| Basic images available in the Microsoft Azure marketplace as shown
below:
.. code-block:: console
Offer Publisher Sku Urn Version
-------------- ------------------- ---------------- ------------------------------------------------------------- ---------
clear-linux-os clear-linux-project basic clear-linux-project:clear-linux-os:basic:15780.0.0 15780.0.0
clear-linux-os clear-linux-project basic clear-linux-project:clear-linux-os:basic:15960.0.0 15960.0.0
clear-linux-os clear-linux-project basic clear-linux-project:clear-linux-os:basic:16050.0.0 16050.0.0
clear-linux-os clear-linux-project basic clear-linux-project:clear-linux-os:basic:16150.0.0 16150.0.0
clear-linux-os clear-linux-project basic clear-linux-project:clear-linux-os:basic:16500.0.0 16500.0.0
clear-linux-os clear-linux-project basic clear-linux-project:clear-linux-os:basic:16810.0.0 16810.0.0
clear-linux-os clear-linux-project basic clear-linux-project:clear-linux-os:basic:18080.0.0 18080.0.0
clear-linux-os clear-linux-project basic clear-linux-project:clear-linux-os:basic:18620.0.0 18620.0.0
clear-linux-os clear-linux-project basic clear-linux-project:clear-linux-os:basic:18860.0.0 18860.0.0
.. note::
The output list shows current offerings and new versions are being
added to the MS Azure marketplace all the time. To reference the latest
version of an 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
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. For the version, use the label
`latest` instead of referencing a specific version.
#. Create the new |CL| Basic VM by running the :command:`az vm create ...`
command using the URN `:clear-linux-project:clear-linux-os:basic:latest`
that we located earlier.
.. code-block:: console
$ az vm create --resource-group ClearResourceGroup --name ClearVM --image clear-linux-project:clear-linux-os:basic:latest --generate-ssh-keys
.. note::
If you have already defined your public/private SSH key pair and they
are stored in your :file:`$HOME/.ssh` directory, you do not need to
include the :parameter:`--generate-ssh-keys` parameter.
Your output from this command will look similar to this output, where
[user] is your user name:
.. code-block:: console
SSH key files '/home/[user]/.ssh/id_rsa' and '/home/[user]/.ssh/id_rsa.pub' have been generated under ~/.ssh to allow SSH access to the VM. If using machines without permanent storage, back up your keys to a safe location.
running...
{
"fqdns": "",
"id": "/subscriptions/{unique-id}/resourceGroups/ClearResourceGroup/providers/Microsoft.Compute/virtualMachines/ClearVM",
"location": "westus",
"macAddress": "00-0D-3A-37-C7-59",
"powerState": "VM running",
"privateIpAddress": "10.0.0.4",
"publicIpAddress": "13.91.4.245",
"resourceGroup": "ClearResourceGroup",
"zones": ""
}
Take note of the public IP address from your output.
#. Login into the new |CL| Basic VM, run the :command:`ssh` command with the
public IP address listed as shown:
.. code-block:: console
$ ssh [user]@13.91.4.245
You may see the following message about the authenticity of the host. If
this appears, type `yes` to proceed connecting to your new |CL| VM.
.. code-block:: console
The authenticity of host '13.91.4.245 (13.91.4.245)' can't be established.
RSA key fingerprint is SHA256:{unique-number}.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added '13.91.4.245' (RSA) to the list of known hosts.
[user]@ClearVM ~ $
You are now logged into your new |CL| VM as [user], where [user] is your
user name. To check to see which software bundles have been included with
this image, run the :command:`swupd bundle-list` command:
.. code-block:: console
[user]@ClearVM ~ $ sudo swupd bundle-list
swupd-client bundle list 3.14.1
Copyright (C) 2012-2017 Intel Corporation
bootloader
editors
kernel-hyperv
network-basic
openssh-server
os-cloudguest-azure
os-core
os-core-update
perl-basic
python-basic
python3-basic
storage-utils
sysadmin-basic
Current OS version: 19600
[user]@ClearVM ~ $
When you are finished using your new |CL| VM, type :command:`exit` to close
the :command:`SSH` terminal and logout.
Stop and deallocate the Clear Linux VM and resources
****************************************************
When you are finished using your new |CL| instance, you need to stop the VM
and deallocate the resources in your resource group. If you only stop a VM,
the OS image will shut down but the resources associated with it in your
resource group will still be allocated and incurring charges. For instance, if
you stop and then later start the VM using the :command:`az vm start...`
without deallocating the resources, the IP address will be retained and you
will be able to access the VM using that same IP address. To release the
resources associated with the VM and stop incurring charges for them, you will
need to deallocate the resources as well.
#. At the command prompt, enter the :command:`az vm stop...` command as
follows:
.. code-block:: console
$ az vm stop --resource-group ClearResourceGroup --name ClearVM
This will stop the VM and then output text similar to what is shown below:
.. code-block:: console
{
"endTime": "2017-12-13T23:04:02.346676+00:00",
"error": null,
"name": "{unique-name}",
"startTime": "2017-12-13T23:03:59.018536+00:00",
"status": "Succeeded"
}
#. Once the VM has stopped, deallocate the VM resources to stop incurring
charges for the |CL| instance. Enter the following command:
.. code-block:: console
$ az vm deallocate --resource-group ClearResourceGroup --name ClearVM
Next steps
**********
Congratulations! You are up and running with |CL| on MS Azure using the Azure
CLI 2.0 command line tools. To see what you can do with your |CL| instance,
visit our :ref:`tutorials <tutorials>` section for examples on using your |CL|
system.
For additional information visit the Clear Linux
`Azure Partner Mini Case Study`_ and the `Azure Partner Datasheet`_.
To learn more about the MS Azure CLI 2.0 tool and options that are available,
visit the `MS Azure documentation and tutorials`_ website.
.. _`Azure Portal`:
https://portal.azure.com
.. _`MS Azure free account`:
https://azure.microsoft.com/en-us/free/
.. _`MS Azure documentation and tutorials`:
https://docs.microsoft.com/en-us/cli/azure/overview?view=azure-cli-latest
.. _`MS Azure Install Azure CLI tutorial`:
https://docs.microsoft.com/en-us/cli/azure/install-azure-cli?view=azure-cli-latest
.. _`Azure Resource Manager overview`:
https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-group-overview
.. _Azure Partner Datasheet:
http://download.microsoft.com/download/D/9/E/D9E22342-96D9-4455-BB15-99A1AF514DDD/Microsoft%20Azure%20Partner%20Datasheet%20-%20Intel%20Clear%20Linux.pdf
.. _Azure Partner Mini Case Study:
http://download.microsoft.com/download/D/9/E/D9E22342-96D9-4455-BB15-99A1AF514DDD/Microsoft%20Azure%20Partner%20Mini%20Case%20Study%20-%20Intel%20Clear%20Linux.pdf
source/clear-linux/tutorials/azure/figures/azure-1.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 116 KiB

source/clear-linux/tutorials/azure/figures/azure-2.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 133 KiB

source/clear-linux/tutorials/azure/figures/azure-3.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 128 KiB