Skip to content

Commit 460fcb9

Browse files
authored
Merge pull request #226881 from cynthn/2023-ubuntu
Ubuntu image references
2 parents 7a1a70d + ec6d04a commit 460fcb9

File tree

2 files changed

+51
-42
lines changed

2 files changed

+51
-42
lines changed

articles/virtual-machines/linux/cli-ps-findimage.md

Lines changed: 30 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Learn how to use the Azure CLI to find image URNs and purchase plan
44
ms.service: virtual-machines
55
ms.subservice: imaging
66
ms.topic: how-to
7-
ms.date: 12/9/2022
7+
ms.date: 02/09/2023
88
author: ebolton-cyber
99
ms.author: mattmcinnes
1010
ms.collection: linux
@@ -44,24 +44,22 @@ az vm image list --output table
4444
The output includes the image URN. You can also use the *UrnAlias*, which is a shortened version created for popular images like *UbuntuLTS*.
4545

4646
```output
47-
Offer Publisher Sku Urn UrnAlias Version
48-
---------------------------- ---------------------- ---------------------------------- ------------------------------------------------------------------------------ ----------------------- ---------
49-
CentOS OpenLogic 7.5 OpenLogic:CentOS:7.5:latest
50-
CentOS latest
51-
debian-10 Debian 10 Debian:debian-10:10:latest
52-
Debian latest
53-
flatcar-container-linux-free kinvolk stable kinvolk:flatcar-container-linux-free:stable:latest Flatcar latest
54-
opensuse-leap-15-3 SUSE gen2 SUSE:opensuse-leap-15-3:gen2:latest openSUSE-Leap latest
55-
RHEL RedHat 7-LVM RedHat:RHEL:7-LVM:latest RHEL latest
56-
sles-15-sp3 SUSE gen2 SUSE:sles-15-sp3:gen2:latest SLES latest
57-
UbuntuServer Canonical 18.04-LTS Canonical:UbuntuServer:18.04-LTS:latest UbuntuLTS latest
58-
WindowsServer MicrosoftWindowsServer 2022-Datacenter MicrosoftWindowsServer:WindowsServer:2022-Datacenter:latest Win2022Datacenter latest
59-
WindowsServer MicrosoftWindowsServer 2022-datacenter-azure-edition-core MicrosoftWindowsServer:WindowsServer:2022-datacenter-azure-edition-core:latest Win2022AzureEditionCore latest
60-
WindowsServer MicrosoftWindowsServer 2019-Datacenter MicrosoftWindowsServer:WindowsServer:2019-Datacenter:latest Win2019Datacenter latest
61-
WindowsServer MicrosoftWindowsServer 2016-Datacenter MicrosoftWindowsServer:WindowsServer:2016-Datacenter:latest Win2016Datacenter latest
62-
WindowsServer MicrosoftWindowsServer 2012-R2-Datacenter MicrosoftWindowsServer:WindowsServer:2012-R2-Datacenter:latest Win2012R2Datacenter latest
63-
WindowsServer MicrosoftWindowsServer 2012-Datacenter MicrosoftWindowsServer:WindowsServer:2012-Datacenter:latest Win2012Datacenter latest
64-
WindowsServer MicrosoftWindowsServer 2008-R2-SP1 MicrosoftWindowsServer:WindowsServer:2008-R2-SP1:latest Win2008R2SP1 latest
47+
Architecture Offer Publisher Sku Urn UrnAlias Version
48+
-------------- ---------------------------- ---------------------- ---------------------------------- ------------------------------------------------------------------------------ ----------------------- ---------
49+
x64 CentOS OpenLogic 7.5 OpenLogic:CentOS:7.5:latest CentOS latest
50+
x64 debian-10 Debian 10 Debian:debian-10:10:latest Debian latest
51+
x64 flatcar-container-linux-free kinvolk stable kinvolk:flatcar-container-linux-free:stable:latest Flatcar latest
52+
x64 opensuse-leap-15-3 SUSE gen2 SUSE:opensuse-leap-15-3:gen2:latest openSUSE-Leap latest
53+
x64 RHEL RedHat 7-LVM RedHat:RHEL:7-LVM:latest RHEL latest
54+
x64 sles-15-sp3 SUSE gen2 SUSE:sles-15-sp3:gen2:latest SLES latest
55+
x64 UbuntuServer Canonical 18.04-LTS Canonical:UbuntuServer:18.04-LTS:latest UbuntuLTS latest
56+
x64 WindowsServer MicrosoftWindowsServer 2022-Datacenter MicrosoftWindowsServer:WindowsServer:2022-Datacenter:latest Win2022Datacenter latest
57+
x64 WindowsServer MicrosoftWindowsServer 2022-datacenter-azure-edition-core MicrosoftWindowsServer:WindowsServer:2022-datacenter-azure-edition-core:latest Win2022AzureEditionCore latest
58+
x64 WindowsServer MicrosoftWindowsServer 2019-Datacenter MicrosoftWindowsServer:WindowsServer:2019-Datacenter:latest Win2019Datacenter latest
59+
x64 WindowsServer MicrosoftWindowsServer 2016-Datacenter MicrosoftWindowsServer:WindowsServer:2016-Datacenter:latest Win2016Datacenter latest
60+
x64 WindowsServer MicrosoftWindowsServer 2012-R2-Datacenter MicrosoftWindowsServer:WindowsServer:2012-R2-Datacenter:latest Win2012R2Datacenter latest
61+
x64 WindowsServer MicrosoftWindowsServer 2012-Datacenter MicrosoftWindowsServer:WindowsServer:2012-Datacenter:latest Win2012Datacenter latest
62+
x64 WindowsServer MicrosoftWindowsServer 2008-R2-SP1 MicrosoftWindowsServer:WindowsServer:2008-R2-SP1:latest Win2008R2SP1 latest
6563
```
6664

6765
## Find specific images
@@ -85,29 +83,33 @@ Another way to find an image in a location is to run the [az vm image list-publi
8583
az vm image list-publishers --location westus --output table
8684
```
8785
88-
1. For a given publisher, list their offers. In this example, we add *Canonical* as the publisher.
86+
1. For a given publisher, list their offers. In this example, we add *RedHat* as the publisher.
8987
9088
```azurecli
91-
az vm image list-offers --location westus --publisher Canonical --output table
89+
az vm image list-offers --location westus --publisher RedHat --output table
9290
```
9391
94-
1. For a given offer, list their SKUs. In this example, we add *UbuntuServer* as the offer.
92+
1. For a given offer, list their SKUs. In this example, we add *RHEL* as the offer.
9593
```azurecli
96-
az vm image list-skus --location westus --publisher Canonical --offer UbuntuServer --output table
94+
az vm image list-skus --location westus --publisher RedHat --offer RHEL --output table
9795
```
9896
99-
1. For a given publisher, offer, and SKU, show all of the versions of the image. In this example, we add *18.04-LTS* as the SKU.
97+
> [!NOTE]
98+
> Canonical has changed the **Offer** names they use for the most recent versions. Before Ubuntu 20.04, the **Offer** name is UbuntuServer. For Ubuntu 20.04 the **Offer** name is `0001-com-ubuntu-server-focal` and for Ubuntu 22.04 it's `0001-com-ubuntu-server-jammy`.
99+
100+
101+
1. For a given publisher, offer, and SKU, show all of the versions of the image. In this example, we add *9_1* as the SKU.
100102
101103
```azurecli
102104
az vm image list \
103105
--location westus \
104-
--publisher Canonical \
105-
--offer UbuntuServer \
106-
--sku 18.04-LTS \
106+
--publisher RedHat \
107+
--offer RHEL \
108+
--sku 9_1 \
107109
--all --output table
108110
```
109111
110-
Pass this value of the URN column with the `--image` parameter when you create a VM with the [az vm create](/cli/azure/vm) command. You can also replace the version number in the URN with "latest", to use the latest version of the image.
112+
Pass this value of the URN column with the `--image` parameter when you create a VM with the [az vm create](/cli/azure/vm) command. You can also replace the version number in the URN with "latest", to use the latest version of the image.
111113
112114
If you deploy a VM with a Resource Manager template, you set the image parameters individually in the `imageReference` properties. See the [template reference](/azure/templates/microsoft.compute/virtualmachines).
113115

articles/virtual-machines/linux/tutorial-manage-vm.md

Lines changed: 21 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -87,7 +87,7 @@ exit
8787

8888
## Understand VM images
8989

90-
The Azure marketplace includes many images that can be used to create VMs. In the previous steps, a virtual machine was created using an Ubuntu image. In this step, the Azure CLI is used to search the marketplace for a CentOS image, which is then used to deploy a second virtual machine.
90+
The Azure Marketplace includes many images that can be used to create VMs. In the previous steps, a virtual machine was created using an Ubuntu image. In this step, the Azure CLI is used to search the marketplace for a CentOS image, which is then used to deploy a second virtual machine.
9191

9292
To see a list of the most commonly used images, use the [az vm image list](/cli/azure/vm/image) command.
9393

@@ -98,19 +98,22 @@ az vm image list --output table
9898
The command output returns the most popular VM images on Azure.
9999

100100
```output
101-
Offer Publisher Sku Urn UrnAlias Version
102-
------------- ---------------------- ------------------ -------------------------------------------------------------- ------------------- ---------
103-
WindowsServer MicrosoftWindowsServer 2016-Datacenter MicrosoftWindowsServer:WindowsServer:2016-Datacenter:latest Win2016Datacenter latest
104-
WindowsServer MicrosoftWindowsServer 2012-R2-Datacenter MicrosoftWindowsServer:WindowsServer:2012-R2-Datacenter:latest Win2012R2Datacenter latest
105-
WindowsServer MicrosoftWindowsServer 2008-R2-SP1 MicrosoftWindowsServer:WindowsServer:2008-R2-SP1:latest Win2008R2SP1 latest
106-
WindowsServer MicrosoftWindowsServer 2012-Datacenter MicrosoftWindowsServer:WindowsServer:2012-Datacenter:latest Win2012Datacenter latest
107-
UbuntuServer Canonical 16.04-LTS Canonical:UbuntuServer:16.04-LTS:latest UbuntuLTS latest
108-
CentOS OpenLogic 7.3 OpenLogic:CentOS:7.3:latest CentOS latest
109-
openSUSE-Leap SUSE 42.2 SUSE:openSUSE-Leap:42.2:latest openSUSE-Leap latest
110-
RHEL RedHat 7.3 RedHat:RHEL:7.3:latest RHEL latest
111-
SLES SUSE 12-SP2 SUSE:SLES:12-SP2:latest SLES latest
112-
Debian credativ 8 credativ:Debian:8:latest Debian latest
113-
CoreOS CoreOS Stable CoreOS:CoreOS:Stable:latest CoreOS latest
101+
Architecture Offer Publisher Sku Urn UrnAlias Version
102+
-------------- ---------------------------- ---------------------- ---------------------------------- ------------------------------------------------------------------------------ ----------------------- ---------
103+
x64 CentOS OpenLogic 7.5 OpenLogic:CentOS:7.5:latest CentOS latest
104+
x64 debian-10 Debian 10 Debian:debian-10:10:latest Debian latest
105+
x64 flatcar-container-linux-free kinvolk stable kinvolk:flatcar-container-linux-free:stable:latest Flatcar latest
106+
x64 opensuse-leap-15-3 SUSE gen2 SUSE:opensuse-leap-15-3:gen2:latest openSUSE-Leap latest
107+
x64 RHEL RedHat 7-LVM RedHat:RHEL:7-LVM:latest RHEL latest
108+
x64 sles-15-sp3 SUSE gen2 SUSE:sles-15-sp3:gen2:latest SLES latest
109+
x64 UbuntuServer Canonical 18.04-LTS Canonical:UbuntuServer:18.04-LTS:latest UbuntuLTS latest
110+
x64 WindowsServer MicrosoftWindowsServer 2022-Datacenter MicrosoftWindowsServer:WindowsServer:2022-Datacenter:latest Win2022Datacenter latest
111+
x64 WindowsServer MicrosoftWindowsServer 2022-datacenter-azure-edition-core MicrosoftWindowsServer:WindowsServer:2022-datacenter-azure-edition-core:latest Win2022AzureEditionCore latest
112+
x64 WindowsServer MicrosoftWindowsServer 2019-Datacenter MicrosoftWindowsServer:WindowsServer:2019-Datacenter:latest Win2019Datacenter latest
113+
x64 WindowsServer MicrosoftWindowsServer 2016-Datacenter MicrosoftWindowsServer:WindowsServer:2016-Datacenter:latest Win2016Datacenter latest
114+
x64 WindowsServer MicrosoftWindowsServer 2012-R2-Datacenter MicrosoftWindowsServer:WindowsServer:2012-R2-Datacenter:latest Win2012R2Datacenter latest
115+
x64 WindowsServer MicrosoftWindowsServer 2012-Datacenter MicrosoftWindowsServer:WindowsServer:2012-Datacenter:latest Win2012Datacenter latest
116+
x64 WindowsServer MicrosoftWindowsServer 2008-R2-SP1 MicrosoftWindowsServer:WindowsServer:2008-R2-SP1:latest Win2008R2SP1 latest
114117
```
115118

116119
A full list can be seen by adding the `--all` parameter. The image list can also be filtered by `--publisher` or `–-offer`. In this example, the list is filtered for all images with an offer that matches *CentOS*.
@@ -132,6 +135,10 @@ CentOS OpenLogic 6.5 OpenLogic:CentOS:6.5:6.5.20160309
132135
CentOS OpenLogic 6.5 OpenLogic:CentOS:6.5:6.5.20170207 6.5.20170207
133136
```
134137

138+
139+
> [!NOTE]
140+
> Canonical has changed the **Offer** names they use for the most recent versions. Before Ubuntu 20.04, the **Offer** name is UbuntuServer. For Ubuntu 20.04 the **Offer** name is `0001-com-ubuntu-server-focal` and for Ubuntu 22.04 it's `0001-com-ubuntu-server-jammy`.
141+
135142
To deploy a VM using a specific image, take note of the value in the *Urn* column, which consists of the publisher, offer, SKU, and optionally a version number to [identify](cli-ps-findimage.md#terminology) the image. When specifying the image, the image version number can be replaced with `latest`, which selects the latest version of the distribution. In this example, the `--image` parameter is used to specify the latest version of a CentOS 6.5 image.
136143

137144
```azurecli-interactive

0 commit comments

Comments
 (0)