Skip to content

Commit 33275cc

Browse files
GitHubber17GitHubber17
authored
Merge pull request #75260 from cynthn/portal-ga
SIG Portal Pre-Release
2 parents 1f277c5 + 9a0f3e7 commit 33275cc

File tree

5 files changed

+247
-3
lines changed

5 files changed

+247
-3
lines changed

‎articles/virtual-machines/linux/shared-images-portal.md

Lines changed: 84 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,84 @@
1+
---
2+
title: Create shared Azure Virtual Machine images for Linux using the portal | Microsoft Docs
3+
description: Learn how to use Azure portal to create and share virtual machine images.
4+
services: virtual-machines-linux
5+
documentationcenter: virtual-machines
6+
author: cynthn
7+
manager: jeconnoc
8+
editor: tysonn
9+
tags: azure-resource-manager
10+
11+
ms.assetid:
12+
ms.service: virtual-machines-linux
13+
ms.devlang: na
14+
ms.topic: article
15+
ms.tgt_pltfrm: vm-linux
16+
ms.workload: infrastructure
17+
ms.date: 04/25/2019
18+
ms.author: cynthn
19+
ms.custom:
20+
21+
#Customer intent: As an IT administrator, I want to learn about how to create shared VM images to minimize the number of post-deployment configuration tasks.
22+
---
23+
24+
# Create a shared image gallery using the Azure portal
25+
26+
A [Shared Image Gallery](shared-image-galleries.md) simplifies custom image sharing across your organization. Custom images are like marketplace images, but you create them yourself. Custom images can be used to bootstrap deployment tasks like preloading applications, application configurations, and other OS configurations.
27+
28+
The Shared Image Gallery lets you share your custom VM images with others in your organization, within or across regions, within an AAD tenant. Choose which images you want to share, which regions you want to make them available in, and who you want to share them with. You can create multiple galleries so that you can logically group shared images.
29+
30+
The gallery is a top-level resource that provides full role-based access control (RBAC). Images can be versioned, and you can choose to replicate each image version to a different set of Azure regions. The gallery only works with Managed Images.
31+
32+
The Shared Image Gallery feature has multiple resource types. We will be using or building these in this article:
33+
34+
| Resource | Description|
35+
|----------|------------|
36+
| **Managed image** | This is a basic image that can be used alone or used to create an **image version** in an image gallery. Managed images are created from generalized VMs. A managed image is a special type of VHD that can be used to make multiple VMs and can now be used to create shared image versions. |
37+
| **Image gallery** | Like the Azure Marketplace, an **image gallery** is a repository for managing and sharing images, but you control who has access. |
38+
| **Image definition** | Images are defined within a gallery and carry information about the image and requirements for using it internally. This includes whether the image is Windows or Linux, release notes, and minimum and maximum memory requirements. It is a definition of a type of image. |
39+
| **Image version** | An **image version** is what you use to create a VM when using a gallery. You can have multiple versions of an image as needed for your environment. Like a managed image, when you use an **image version** to create a VM, the image version is used to create new disks for the VM. Image versions can be used multiple times. |
40+
41+
42+
## Before you begin
43+
44+
To complete the example in this article, you must have an existing managed image. You can follow [Tutorial: Create a custom image of an Azure VM with Azure PowerShell](tutorial-custom-images.md) to create one if needed. When working through this article, replace the resource group and VM names where needed.
45+
46+
47+
[!INCLUDE [virtual-machines-common-shared-images-portal](../../../includes/virtual-machines-common-shared-images-portal.md)]
48+
49+
## Create VMs from an image
50+
51+
Once the image version is complete, you can create one or more new VMs.
52+
53+
This example creates a VM named *myVMfromImage*, in the *myResourceGroup* in the *East US* datacenter.
54+
55+
1. On the page for your image version, select **Create VM** from the menu at the top of the page.
56+
1. For **Resource group**, select **Create new** and type *myResourceGroup* for the name.
57+
1. In **Virtual machine name**, type *myVM*.
58+
1. For **Region**, select *East US*.
59+
1. For **Availability options**, leave the default of *No infrastructure redundancy required*.
60+
1. The value for **Image** should be automatically filled in if you started from the page for the image version.
61+
1. For **Size**, choose a VM size from the list of available sizes and then click "Select".
62+
1. Under **Administrator account**, select **Password** or **SSH public key**, then enter your information.
63+
1. If you want to allow remote access to the VM, under **Public inbound ports**, choose **Allow selected ports** and then select **SSH (22)** from the drop-down. If you don't want to allow remote access to the VM, leave **None** selected for **Public inbound ports**.
64+
1. When you are finished, select the **Review + create** button at the bottom of the page.
65+
1. After the VM passes validation, select **Create** at the bottom of the page to start the deployment.
66+
67+
68+
## Clean up resources
69+
70+
When no longer needed, you can delete the resource group, virtual machine, and all related resources. To do so, select the resource group for the virtual machine, select **Delete**, then confirm the name of the resource group to delete.
71+
72+
If you want to delete individual resources, you need to delete them in reverse order. For example, to delete an image definition, you need to delete all of the image versions created from that image.
73+
74+
## Next steps
75+
76+
You can also create Shared Image Gallery resource using templates. There are several Azure Quickstart Templates available:
77+
78+
- [Create a Shared Image Gallery](https://azure.microsoft.com/resources/templates/101-sig-create/)
79+
- [Create an Image Definition in a Shared Image Gallery](https://azure.microsoft.com/resources/templates/101-sig-image-definition-create/)
80+
- [Create an Image Version in a Shared Image Gallery](https://azure.microsoft.com/resources/templates/101-sig-image-version-create/)
81+
- [Create a VM from Image Version](https://azure.microsoft.com/resources/templates/101-vm-from-sig/)
82+
83+
For more information about Shared Image Galleries, see the [Overview](shared-image-galleries.md). If you run into issues, see [Troubleshooting shared image galleries](troubleshooting-shared-images.md).
84+

‎articles/virtual-machines/linux/toc.yml

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@
2525
href: tutorial-custom-images.md
2626
- name: 5 - Highly available VMs
2727
href: tutorial-availability-sets.md
28-
- name: 6 - Create a VM scale set
28+
- name: 6 - Create a scale set
2929
href: tutorial-create-vmss.md
3030
- name: 7 - Load balance VMs
3131
href: tutorial-load-balancer.md
@@ -219,7 +219,7 @@
219219
href: ../../active-directory-domain-services/active-directory-ds-join-centos-linux-vm.md
220220
- name: Ubuntu
221221
href: ../../active-directory-domain-services/active-directory-ds-join-ubuntu-linux-vm.md
222-
- name: Log in with Azure Active Directory credentials
222+
- name: Sign in with Azure Active Directory credentials
223223
href: login-using-aad.md
224224
- name: Updates and patches
225225
items:
@@ -259,6 +259,8 @@
259259
href: shared-image-galleries.md
260260
- name: Create shared images using CLI
261261
href: shared-images.md
262+
- name: Portal
263+
href: shared-images-portal.md
262264
- name: Troubleshoot shared images
263265
href: troubleshooting-shared-images.md
264266
- name: Find and use images

‎articles/virtual-machines/windows/shared-images-portal.md

Lines changed: 84 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,84 @@
1+
---
2+
title: Create shared Azure Virtual Machine images for Windows using portal | Microsoft Docs
3+
description: Learn how to use Azure portal to create and share virtual machine images.
4+
services: virtual-machines-windows
5+
documentationcenter: virtual-machines
6+
author: cynthn
7+
manager: jeconnoc
8+
editor: tysonn
9+
tags: azure-resource-manager
10+
11+
ms.assetid:
12+
ms.service: virtual-machines-windows
13+
ms.devlang: na
14+
ms.topic: article
15+
ms.tgt_pltfrm: vm-windows
16+
ms.workload: infrastructure
17+
ms.date: 04/25/2019
18+
ms.author: cynthn
19+
ms.custom:
20+
21+
#Customer intent: As an IT administrator, I want to learn about how to create shared VM images to minimize the number of post-deployment configuration tasks.
22+
---
23+
24+
# Create a shared image gallery using the Azure portal
25+
26+
A [Shared Image Gallery](shared-image-galleries.md) simplifies custom image sharing across your organization. Custom images are like marketplace images, but you create them yourself. Custom images can be used to bootstrap deployment tasks like preloading applications, application configurations, and other OS configurations.
27+
28+
The Shared Image Gallery lets you share your custom VM images with others in your organization, within or across regions, within an AAD tenant. Choose which images you want to share, which regions you want to make them available in, and who you want to share them with. You can create multiple galleries so that you can logically group shared images.
29+
30+
The gallery is a top-level resource that provides full role-based access control (RBAC). Images can be versioned, and you can choose to replicate each image version to a different set of Azure regions. The gallery only works with Managed Images.
31+
32+
The Shared Image Gallery feature has multiple resource types. We will be using or building these in this article:
33+
34+
| Resource | Description|
35+
|----------|------------|
36+
| **Managed image** | This is a basic image that can be used alone or used to create an **image version** in an image gallery. Managed images are created from generalized VMs. A managed image is a special type of VHD that can be used to make multiple VMs and can now be used to create shared image versions. |
37+
| **Image gallery** | Like the Azure Marketplace, an **image gallery** is a repository for managing and sharing images, but you control who has access. |
38+
| **Image definition** | Images are defined within a gallery and carry information about the image and requirements for using it internally. This includes whether the image is Windows or Linux, release notes, and minimum and maximum memory requirements. It is a definition of a type of image. |
39+
| **Image version** | An **image version** is what you use to create a VM when using a gallery. You can have multiple versions of an image as needed for your environment. Like a managed image, when you use an **image version** to create a VM, the image version is used to create new disks for the VM. Image versions can be used multiple times. |
40+
41+
42+
## Before you begin
43+
44+
To complete the example in this article, you must have an existing managed image. You can follow [Tutorial: Create a custom image of an Azure VM with Azure PowerShell](tutorial-custom-images.md) to create one if needed. When working through this article, replace the resource group and VM names where needed.
45+
46+
47+
[!INCLUDE [virtual-machines-common-shared-images-portal](../../../includes/virtual-machines-common-shared-images-portal.md)]
48+
49+
## Create VMs from an image
50+
51+
Once the image version is complete, you can create one or more new VMs.
52+
53+
This example creates a VM named *myVMfromImage*, in the *myResourceGroup* in the *East US* datacenter.
54+
55+
1. On the page for your image version, select **Create VM** from the menu at the top of the page.
56+
1. For **Resource group**, select **Create new** and type *myResourceGroup* for the name.
57+
1. In **Virtual machine name**, type *myVM*.
58+
1. For **Region**, select *East US*.
59+
1. For **Availability options**, leave the default of *No infrastructure redundancy required*.
60+
1. The value for **Image** should be automatically filled in if you started from the page for the image version.
61+
1. For **Size**, choose a VM size from the list of available sizes and then click "Select".
62+
1. Under **Administrator account**, provide a username, such as *azureuser* and a password. The password must be at least 12 characters long and meet the [defined complexity requirements](faq.md#what-are-the-password-requirements-when-creating-a-vm).
63+
1. If you want to allow remote access to the VM, under **Public inbound ports**, choose **Allow selected ports** and then select **RDP (3389)** from the drop-down. If you don't want to allow remote access to the VM, leave **None** selected for **Public inbound ports**.
64+
1. When you are finished, select the **Review + create** button at the bottom of the page.
65+
1. After the VM passes validation, select **Create** at the bottom of the page to start the deployment.
66+
67+
68+
## Clean up resources
69+
70+
When no longer needed, you can delete the resource group, virtual machine, and all related resources. To do so, select the resource group for the virtual machine, select **Delete**, then confirm the name of the resource group to delete.
71+
72+
If you want to delete individual resources, you need to delete them in reverse order. For example, to delete an image definition, you need to delete all of the image versions created from that image.
73+
74+
## Next steps
75+
76+
You can also create Shared Image Gallery resource using templates. There are several Azure Quickstart Templates available:
77+
78+
- [Create a Shared Image Gallery](https://azure.microsoft.com/resources/templates/101-sig-create/)
79+
- [Create an Image Definition in a Shared Image Gallery](https://azure.microsoft.com/resources/templates/101-sig-image-definition-create/)
80+
- [Create an Image Version in a Shared Image Gallery](https://azure.microsoft.com/resources/templates/101-sig-image-version-create/)
81+
- [Create a VM from Image Version](https://azure.microsoft.com/resources/templates/101-vm-from-sig/)
82+
83+
For more information about Shared Image Galleries, see the [Overview](shared-image-galleries.md). If you run into issues, see [Troubleshooting shared image galleries](troubleshooting-shared-images.md).
84+

‎articles/virtual-machines/windows/toc.yml

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@
2525
href: tutorial-custom-images.md
2626
- name: 5 - Highly available VMs
2727
href: tutorial-availability-sets.md
28-
- name: 6 - Create a VM scale set
28+
- name: 6 - Create a scale set
2929
href: tutorial-create-vmss.md
3030
- name: 7 - Load balance VMs
3131
href: tutorial-load-balancer.md
@@ -251,6 +251,8 @@
251251
href: shared-images.md
252252
- name: Create shared images using CLI
253253
href: ../linux/shared-images.md
254+
- name: Portal
255+
href: shared-images-portal.md
254256
- name: Troubleshoot shared images
255257
href: troubleshooting-shared-images.md
256258
- name: Find and use images

‎includes/virtual-machines-common-shared-images-portal.md

Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
1+
---
2+
title: include file
3+
description: include file
4+
services: virtual-machines
5+
author: cynthn
6+
ms.service: virtual-machines
7+
ms.topic: include
8+
ms.date: 04/25/2019
9+
ms.author: cynthn
10+
ms.custom: include file
11+
---
12+
13+
## Sign in to Azure
14+
15+
Sign in to the Azure portal at https://portal.azure.com.
16+
17+
> [!NOTE]
18+
> If you registered to use Shared Image Galleries during the preview, you might need to re-register the `Microsoft.Compute` provider. Open [Cloud Shell](https://shell.azure.com/bash) and type: `az provider register -n Microsoft.Compute`
19+
20+
## Create an image gallery
21+
22+
An image gallery is the primary resource used for enabling image sharing. Allowed characters for Gallery name are uppercase or lowercase letters, digits, dots, and periods. The gallery name cannot contain dashes. Gallery names must be unique within your subscription.
23+
24+
The following example creates a gallery named *myGallery* in the *myGalleryRG* resource group.
25+
26+
1. Select **Create a resource** in the upper left-hand corner of the Azure portal.
27+
1. Use the type **Shared image gallery** in the search box and select **Shared image gallery** in the results.
28+
1. In the **Shared image gallery** page, click **Create**.
29+
1. Select the correct subscription.
30+
1. In **Resource group**, select **Create new** and type *myGalleryRG* for the name.
31+
1. In **Name**, type *myGallery* for the name of the gallery.
32+
1. Leave the default for **Region**.
33+
1. You can type a short description of the gallery, like *My image gallery for testing.* and then click **Review + create**.
34+
1. After validation passes, select **Create**.
35+
1. When the deployment is finished, select **Go to resource**.
36+
37+
## Create an image definition
38+
39+
Image definitions create a logical grouping for images. They are used to manage information about the image versions that are created within them. Image definition names can be made up of uppercase or lowercase letters, digits, dots, dashes and periods. For more information about the values you can specify for an image definition, see [Image definitions](https://docs.microsoft.com/azure/virtual-machines/windows/shared-image-galleries#image-definitions).
40+
41+
Create the gallery image definition inside of your gallery. In this example, the gallery image is named *myImageDefinition*.
42+
43+
1. On the page for your new image gallery, select **Add a new image definition** from the top of the page.
44+
1. For **Image definition name**, type *myImageDefinition*.
45+
1. For **Operating system**, select the correct option based on your source image.
46+
1. For **Publisher**, type *myPublisher*.
47+
1. For **Offer**, type *myOffer*.
48+
1. For **SKU**, type *mySKU*.
49+
1. Make sure **Yes** us selected for **Enable** and then select **Review + create**.
50+
1. After the image definition passes validation, select **Create**.
51+
1. When the deployment is finished, select **Go to resource**.
52+
53+
54+
55+
## Create an image version
56+
57+
Create an image version from a managed image. In this example, the image version is *1.0.0* and it's replicated to both *West Central US* and *South Central US* datacenters. When choosing target regions for replication, remember that you also have to include the *source* region as a target for replication.
58+
59+
Allowed characters for image version are numbers and periods. Numbers must be within the range of a 32-bit integer. Format: *MajorVersion*.*MinorVersion*.*Patch*.
60+
61+
1. In the page for your image definition, select **Add version** from the top of the page.
62+
1. In **Region**, select the region where your managed image is stored. Image versions need to be created in the same region as the managed image they are created from.
63+
1. For **Name**, type *1.0.0*. The image version name should follow *major*.*minor*.*patch* format using integers.
64+
1. In **Source image**, select your source managed image from the drop-down.
65+
1. In **Exclude from latest**, leave the default value of *No*.
66+
1. For **End of life date**, select a date from the calendar that is a couple of months in the future.
67+
1. In **Replication**, leave the **Default replica count** as 1. You need to replicate to the source region, so leave the first replica as the default and then pick a second replica region to be *East US*.
68+
1. When you are done, select **Review + create**. Azure will validate the configuration.
69+
1. When image version passes validation, select **Create**.
70+
1. When the deployment is finished, select **Go to resource**.
71+
72+
It can take a while to replicate the image to all of the target regions.

0 commit comments

Comments
 (0)