Chapter 3. Using Red Hat Gold Images

Red Hat Gold Images make it fast and easy to deploy instances using your Red Hat Enterprise Linux subscriptions in AWS. These pre-built, certified images are provided to you in your console or CLI and can be deployed in just a few clicks.

3.1. Red Hat Gold Image basics

Red Hat Gold Images receive updates via the Red Hat Update Infrastructure (RHUI), so they do not need to check in to Red Hat Subscription Management or Satellite in order to receive update content. However, they still consume entitlements.

If you copy or modify the Gold Image, the resulting image snapshot will no longer connect to RHUI when it is deployed on future instances, and will need to connect to Red Hat Subscription Management, Satellite, or another subscription management tool in order to receive updates and support.

When Red Hat and the CCSP publish new Gold Images, these will be made available in your CCSP accounts. You do not need to take any action to receive access to future versions of Gold Images.

3.1.1. Naming and identifying Red Hat Gold Images in AWS

There are multiple ways to search for and launch Red Hat Enterprise Linux AMIs in AWS. This includes the EC2 Management Console, AWS CLI, and PowerShell Cmdlet. The naming convention for the Red Hat AMIs in AWS is as follows:

  • Initial GA AMI release: [Red Hat Product]-[Version]-[Virtualization Type]_[Red Hat Release Type]-[Release Date]-[Minor Version Release AMI Iteration]-[Subscription Model]-[EBS Volume Type]
  • After the initial GA AMI release: [Red Hat Product]-[Version]-[Virtualization Type]-[Release Date]-[Minor Version Release AMI Iteration]-[Subscription Model]-[EBS Volume Type]
  • The Red Hat Gold Images will have the designation of Access in the AMI Name representing the subscription model.

Red Hat Gold Images are published under the Owner ID 309956199498. You can ensure that you are using official Red Hat Gold Images by looking for this owner ID when you choose an image.

3.1.2. Locating Red Hat Gold Images in the AWS EC2 Management Console

When working in the EC2 Management Console there is a menu item for AMIs under the IMAGES section within the left-side navigation pane. In this view, using the designation of Private images will display the Red Hat Gold Images which have been shared with the AWS account provided during enrollment. * When in this section of the EC2 Management Console, it is possible to add a filter of Owner : 309956199498 which will limit the displayed AMIs to those which were shared with the AWS account after enrolling in Cloud Access. * It is also possible to further filter the list of displayed AMIs by adding an additional filter representing different aspects of the AMI Name which Red Hat uses such as AMI Name : RHEL, AMI Name : RHEL-Atomic, AMI Name : 7.3.

If the Launch Instance button is used from the EC2 Dashboard section of the EC2 Management Console, and after selecting My AMIs, the filter Shared with me will filter the listed AMIs to show the Red Hat Gold Images which have been shared with the AWS account provided during enrollment.

If the Launch Instance button is used from the EC2 Dashboard section of the EC2 Management Console, and after selecting My AMIs, the filter Shared with me will filter the listed AMIs to show the Red Hat Gold Images which have been shared with the AWS account provided during enrollment.

3.1.3. Locating Red Hat Gold Images in the AWS command line interface

This example command will display all of the RHEL 7.3 AMIs in the US-East-1 region which were shared with the AWS account provided during enrollment in Cloud Access using the AWS CLI. The AWS CLI Command Reference provides additional documentation regarding available options, commands, subcommands, and parameters.

$ aws ec2 describe-images --owners 309956199498 \
> --filters "Name=is-public,Values=false" \
> "Name=name,Values=RHEL*7.3*GA*Access*" \
> --region us-east-1

3.1.4. Locating Red Hat Gold Images in the AWS PowerShell Cmdlet

This example command will display all of the RHEL 7.3 AMIs in the US-East-1 region which were shared with the AWS account provided during enrollment in Cloud Access using the AWS Tools for Cmdlet. The AWS Tools for Cmdlet Reference provides additional documentation on the PowerShell cmdlets.

PS > Get-EC2Image -Region us-east-1 `
>> -Owner 309956199498 -Filter `
>> @{ Name="name" ; Values="RHEL*7.3*GA*Access*" }

3.1.5. Additional Resources for Gold Images with AWS

3.2. Red Hat Gold Images on Microsoft Azure

Red Hat Gold Images on Azure are deployable images published by Microsoft and certified by Red Hat. They are available directly from your Azure CLI or Portal, without the need to build and upload an image manually.

In order to use Red Hat Gold Images on Azure, you must have active Red Hat subscriptions that meet the eligibility criteria for Red Hat Cloud Access. Additionally, this offer is only available in regions where the Azure Marketplace is available. You can learn more about Azure Marketplace availability at Microsoft.

When new versions of enabled Red Hat products are available as Gold Images, these images will automatically be visible to your enabled Azure Subscription IDs, provided that your active Red Hat subscriptions meet the eligibility criteria.

3.2.1. Gaining access to Red Hat Gold Images on Azure

Red Hat and Microsoft have fully automated the process of accessing Gold Images on Azure, so you can start to deploy these images. Depending on your historical use of Red Hat Cloud Access with Azure, you will need to complete a few short, simple steps.

3.2.1.1. Enabling Red Hat subscriptions for Microsoft Azure for the first time

If this is your first time using Red Hat subscriptions on Azure, you’ll need to enable those subscriptions for Red Hat Cloud Access in order to gain access to the Gold Images. You can also find instructions for enabling your subscriptions for the first time.

3.2.1.2. Enabling existing Red Hat subscriptions for Microsoft azure

If you have previously enabled Red Hat subscriptions on Azure, Red Hat has already migrated that data into the new tooling. However, you do need to submit your Azure Subscription ID so that Red Hat can grant your Azure Subscription IDs access to Gold Images.

Procedure

  1. Log in to Red Hat Subscription Management.
  2. Navigate to the Cloud Access Dashboard from the top menu bar.
  3. Find Azure from your list of enabled Certified Cloud and Service Providers (CCSPs). If you do not use multiple CCSPs, Azure may be the only provider listed.
  4. Click on the Microsoft Azure Subscriptions tab.
  5. Click the three horizontal dot (kebab) icon next to the Azure Subscription ID that you want to grant access to Red Hat Gold Images.
  6. Click Activate Red Hat Gold Images.

Once activated, Red Hat Gold Images are typically available in your Azure Subscription IDs within three hours. If you do not see Red Hat Gold Images in your Azure Subscription IDs after three hours, please double check that the correct Azure Subscription IDs have been added to Red Hat Cloud Access. If the problem persists, contact Red Hat support for assistance.

3.2.1.3. Adding additional Azure subscription IDs to Cloud Access in order to gain access to Red Hat Gold Images

If you have additional Azure Subscription IDs which need access to Red Hat Gold Images, or if the Azure Subscription IDs you see in the Azure Subscriptions tab are inaccurate or out-of-date, you can add the correct subscriptions instead.

In the coming weeks, Red Hat will add the ability to update or delete existing Azure Subscription IDs. In the meantime, add additional subscriptions if any of the displayed information is incorrect.

Procedure

  1. Log in to Red Hat Subscription Management.
  2. Navigate to the Cloud Access Dashboard from the top menu bar.
  3. Click on the Microsoft Azure Subscriptions tab.
  4. Click Add Subscriptions.
  5. Enter your Azure subscription information including the Subscription ID. You can enter up to 10 Subscription IDs at a time.
  6. Click Add.

Once added, Red Hat Gold Images are typically available in your Azure Subscription IDs within three hours.

3.2.2. Locating and using Red Hat Gold Images on Azure

After enabling a subscription for Cloud Access on Azure, a set of production-ready, private Red Hat Enterprise Linux images are shared with the Subscription IDs that you added to Cloud Access. When new versions of Red Hat Enterprise Linux Gold Images are created, they will automatically become available to your Azure Subscription IDs.

3.2.3. Naming conventions for Red Hat Gold Images on azure

Red Hat Gold Images for Azure are published under the following metadata. You should confirm that images match the publisher and offer to ensure that the official images are deployed in your environment.

Table 3.1. Images for Cloud Access

Publisher

Offer

RedHat

rhel-byos

Image URNs follow a specific naming convention: '[publisher]:[offering]:[product-version]:[buildversion]' The latest build of a product can be identified by replacing the '[buildversion]' with latest.

3.2.4. Additional resources for Gold Images with azure