Chapter 5. Building customized RHEL images

Procedure

1. From the list of Public images, select the image you want to copy.
2. On the top of the panel, click Actions.
3. From the dropdown menu, choose Copy AMI. A popup window appears.

4. Choose the Destination region and click Copy AMI.

   After the copying process is complete, you are provided with the new AMI ID. You can launch a new instance in the new region.

   Note

   When you copy an image to a different region, it results in a separate and new AMI in the destination region, with a unique AMI ID.

Procedure

1. Access Hybrid Cloud Console.

2. Click Red Hat Insights > RHEL > Inventory > Images.

   The Insights Images dashboard appears.

3. Click Create image.

   The Create image dialog wizard opens.

1. From the Release list, select the release that you want to use.

2. From the Select target environments option, select Microsoft Azure.

   Click Next.

   1. On the Target Environment - Microsoft Azure window, to add Image Builder as an authorized application, complete the following steps:

3. Insert your Tenant GUID.

   Images checks if your Tenant GUID is correctly formatted and the Authorize image builder button becomes available.

4. Click Authorize image builder to authorize Insights Images to push images to the Microsoft Azure cloud.

   This redirects you to the Microsoft Azure portal.

   1. Login with your credentials.
   2. Click Accept the Permission requested.

5. Confirm that Image Builder is authorized for your tenant.

   1. Search for Azure Active Directory and choose Enterprise applications, from the left menu.
   2. Search for Image Builder and confirm it is authorized.

6. Add the Enterprise application as a contributor to your Resource Group.

   1. In the search bar, type Resource Groups and select the first entry under Services. This redirects you to the Resource Groups dashboard.
   2. Select your Resource Group.
   3. On the left menu, click Access control (IAM) to add a permission so the Image Builder application can access your resource group.
   4. From the menu, click the tab Role assignments.
   5. Click +Add.
   6. From the dropdown menu, choose Add role assignment. A menu appears on the left side.

   7. Enter the following details:

      1. Role: Assign the Contributor role
      2. Assign access to: User, group, service principal. Add members: Click +Select members and type Red Hat in the search bar. Click enter.
      3. Select: Image Builder application

Procedure

1. From the Images dashboard, copy the UUID image of the image you created.
2. Access /composes/{composeId} API endpoint.
3. Click the Try it Out button to activate the composeId string path.
4. Enter the UUID into the composes/{composeId} field in the API endpoint.

5. Click Execute. The API endpoint generates a response in the Response body, for example:

   {
     "image_status": {
       "status": "success",
       "upload_status": {
         "options": {
           "image_name": "composer-api-03f0e19c-0050-4c8a-a69e-88790219b086",
           "project_id": "red-hat-image-builder"
         },
         "status": "success",
         "type": "gcp"
       }
     }
   }

6. From the Response body field, copy the image_name and project_id to access the image from the Google Cloud Platform environment. From the Response body:

   "image_name": "composer-api-03f0e19c-0050-4c8a-a69e-88790219b086",
   "project_id": "red-hat-image-builder"

7. From your browser, access Google Cloud Shell.

8. Set your Google Cloud Platform Project ID as the default GCP project. You can find the Product ID of your project by accessing the Google Cloud Platform dashboard.

   $ gcloud config set project PROJECT_ID

9. In the Authorize Cloud Shell window prompt, click Authorize to allow this and future calls that require your credentials.

10. Copy the image to your project by using the gcloud command:

    $ gcloud compute images create MY_IMAGE_NAME \
      --source-image-project red-hat-image-builder \
      --source-image IMAGE_NAME

    Where:

    • MY_IMAGE_NAME is the name you give to your instance;
    • red-hat-image-builder is the project_id generated by Response body;
    • IMAGE_NAME is the image_name generated by Response body;

Procedure

1. From the Images dashboard, select the image from which you want to create your customized image.

2. Click the Node options menu (⫶) and select Re-create image. The Create image wizard opens.

   Note

   If the image status is Expired, click the Re-create image button.

   1. Optional: You can customize the new image by using the Navigation panel to open a step and making changes. Click Next.
   2. On the Review page, click Create image.

Procedure

1. From the Images table, select the image you want to share with other regions.
2. From the Node options menu (⫶), select Share to new region. The Share to new region wizard opens.

3. From the Select region dropdown menu, select the region to share the image.

   You can choose more than one region to share your image with.

4. Click Share.

   Your image is built, uploaded to AWS, and shared to the regions you selected.

   Note

   The shared image expires in 14 days.

5. To ensure that you can access the image permanently, copy the Red Hat image to your own AWS account.

Procedure

1. From the Images table, select the image that you want to download as a .json compose request.

2. Click the Node options (⫶) menu and select Download compose request (.json).

   The .json compose request is now saved to your host server. To use the image builder API, see Using hosted image builder via its API.