Procedure

1. Access Hybrid Cloud Console.
2. Click Services > Observe > RHEL > Repositories.
3. Click Add repositories. The Add custom repositories wizard opens.

4. Enter the following information:

   1. NAME - mandatory.
   2. URL - mandatory.
   3. In the Restrict architecture drop-down menu, select an architecture. You can allow all the architectures or restrict one to your system architecture to prevent incorrect repositories availability.
   4. In the Restrict OS version drop-down menu select an operating system (OS). You can allow all the RHEL versions or select one for your system version to prevent incorrect repositories being available.
   5. GPG key - upload the .txt file with a GPG key or paste the URL or value of an existing GPG key. The GPG key verifies the signed packages of a repository. If you do not provide the GPG key for a repository, your system cannot perform the verification.
5. If you want to add another repository, click the + Add another repository button and repeat step 3.
6. Click Save. The Red Hat Hybrid Cloud Console validates the project status. If your repository is marked as Invalid, check the repository URL that you added. For details about the repository status, see Repository status section.

Procedure

1. Access Hybrid Cloud Console.
2. Click Services > Observe > RHEL > Repositories.
3. Find a repository you want to modify and click Edit in the Options menu.
4. In the Edit custom repository wizard, modify the information you need. Click Save changes.

Procedure

1. Access Hybrid Cloud Console.
2. Click Services > Observe > RHEL > Repositories.
3. Find a repository to delete and click Delete in the Options menu.

Procedure

1. Access Hybrid Cloud Console.
2. Click Services > Observe > RHEL > Repositories.
3. On the Custom repositories page click the Popular repositories tab.
4. Search for the repository you want to add and click Add.

Procedure

1. Access Hybrid Cloud Console.
2. Click Services > Observe > RHEL > Repositories.
3. Find a repository you want to modify and click Introspect Now in the Options menu.

4. The status of that repository changes to In progress that indicates the Hybrid Cloud Console is connecting to the repository and checking for changes.

   The Red Hat Hybrid Cloud Console checks the status of the repositories every 24 hours and again every 8 hours if the status check fails.

Procedure

1. Access Hybrid Cloud Console.
2. Click the Settings icon, then click Settings > Integrations.
3. Click Add integration. The Add integrations wizard opens.
4. Select Amazon Web Service in the Select integration type page and click Next.
5. On the Integration name page, name the integration for your AWS account in the Name field and click Next.

6. On the Select configuration page, choose between the following two options:

   1. If you select Account authorization, provide your Access key ID and Secret access key for your ID from your AWS account. Click Next and complete the following steps:

      1. On the Select application page, select the Launch images option. Click Next.
      2. On the Review details page, verify the details about your AWS account and click Add. The console connects to your AWS account with the credentials you provided and creates an Identity and Access Management (IAM) role with necessary permissions in your AWS account.

   2. If you select Manual configuration, click Next and complete the following steps:

      1. On the Select application page, select the Launch images option. Click Next.
      2. On the Create IAM policy page in Enable account access, copy the command with the Copy to clipboard and run it in your terminal. Click Next.
      3. On the Create IAM role page in Enable account access, follow the instructions on the wizard window. Click Next.
      4. On the Enter ARN page in Enable account access, fill the ARN into the text field. Click Next.
7. On the Review details page, verify the details about your AWS account and click Add to finish adding it to the Integrations.

Procedure

1. Access Hybrid Cloud Console.
2. Click the Settings icon, then click Settings > Integrations.
3. Click Add Integration. The Add integration wizard opens.
4. Select Microsoft Azure in the Select integration type page and click Next.
5. On the Name integration page, name the integration for your Microsoft Azure account in the Integration name field and click Next.
6. On the Select application page, select the Launch images option and click Next.
7. On the Configure Azure Lighthouse page, click Take me to Lighthouse and complete configuration steps in Azure Lighthouse according to the Microsoft instructions. Return to the Add integation wizard and click Next.
8. On the Set subscription ID page, fill in the Subscription ID field and click Next.
9. On the Review details page, verify the details about your Microsoft Azure account and click Add to finish adding it to the Integrations.

Procedure

1. Access Hybrid Cloud Console.
2. Click the Settings icon, then click Settings > Integrations.
3. Click Add integration. The Add integration wizard opens.
4. Select Google Cloud in the Select integration type page and click Next.
5. On the Integration name page, name the integration for your GCP project in the Name field and click Next.
6. On the Select application page, select the Launch images option and click Next.

7. On the Enable account access page:

   1. On the Enter Project ID page, fill in your GCP project name that you want to add in the Project field. Click Next.
   2. On the Create custom role page, follow the instructions on the page. Click Next.
8. On the Review details page, verify the details about your GCP project and click Add to finish adding it to the Integrations.

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 wizard opens.

4. On the Image output page, select the following:

   1. From the Release list, select the release that you want to use.
   2. From the Architecture list, select the architecture that you want to use.
   3. From the Select target environments option, select Amazon Web Services.
   4. Click Next.

5. On the Target Environment - Amazon Web Service page, perform the following actions:

   1. Select one of the share methods to share your Red Hat image with your AWS account:

      • Use an account configured from Source
      • Manually enter an account ID

   2. For the Use an account configured from Source sharing method:

      1. From the Source Name dropdown menu, select the source you want.
      2. The Default region fields and Associated Account ID are filled automatically after you select the source. If the source is unavailable, you can enter the AWS account ID manually or try again later.
   3. Click Next.

   4. For the Manually enter an account ID sharing method:

      1. Enter the AWS account ID. The Default region is us-east-1 and you can copy the image to different regions later. See Sharing AWS images to other regions.
      2. Click Next.

6. On the Register page, select one of the registration methods: Automatically register and enable advanced capabilities or Register later.

   If you choose the Automatically register and enable advanced capabilities option, customize it further.

   1. Click the Show additional connection options button.

      The Monitor & manage subscriptions and access to Red Hat content radio button enables the following option:

      • Enable predictive analytics and management capabilities - to provide actionable intelligence about your Red Hat Enterprise Linux environments, helping to identify and address operational and vulnerability risks before an issue results in downtime.
      • Enable remote remediations and system management with automation - Red Hat connector (rhc) enables Red Hat Enterprise Linux hosts to connect to Red Hat Insights to use Red Hat Insights Remediations service.
   2. Check or uncheck the checkboxes according to your preferences.

   3. From the dropdown menu, choose an activation key to use for the image. See Creating an activation key.

      1. No activation keys found - If you do not have an activation key, you can choose the default activation key by completing the following step:

         1. Click the Create activation key button. The Select activation key dropdown menu enables the activation-key-default. It is a preset key with the basic configuration. You can manage the activation key by accessing Activation keys.
   4. Click Next.

7. On the File system configuration page, select the recommended Use automatic partitioning or Manually configure partitions for your image file system.

   1. To configure your partitions manually, click the Manually configure partitioning radio button.

      The Configure partitions section opens, showing the configuration based on Red Hat standards and security guides.

   2. From the drop-down menu, provide details to configure the partitions:

   3. For the Mount point field, select one mount point type option

      You can also add an additional path to the Mount point, such as /tmp. For example: /var as a prefix and /tmp as an additional path results in /var/tmp.

      Note

      Depending on the Mount point type you choose, the file system type changes to xfs, and so on.

   4. For the Minimum size partition field of the file system, enter the desired minimum partition size. In the Minimum size drop-down menu, you can use common size units such as GiB, MiB, or KiB. The default unit is GiB.

   5. To add more partitions, click Add partition and repeat the steps for each added partition.

      Click Next.

8. Optional: On the Content page, complete the following steps to add additional packages to your image:

   1. On the Additional Red Hat packages step:

      1. On the Available packages search field, enter the package name and click the → button.
      2. Click the >> button to add all packages shown in the package search results to the Chosen packages dual list box. Optionally, you can click the > button to add only one selected package at a time.

   2. On the Custom repositories page, click Repositories.

      The Custom Repositories page opens in a new browser tab. Go to the new page.

      1. Click Add repositories. Enter the following information:

         1. Name
         2. URL
         3. Restrict architecture: from the drop-down menu, select an architecture. Either mark all the architectures or select one to restrict to your system architecture to prevent incorrect repositories availability.
         4. Restrict OS version: from the drop-down menu, select an operating system (OS). Either allow all RHEL versions or select a version for your system, to prevent incorrect repositories availability.

         5. GPG key: Either upload a file with a GPG key or paste the URL of an existing GPG key.

            Note

            If you do not provide the GPG key for a repository, your system cannot perform the GPG key verification for signed packages in a repository.

         6. Click Save to validate the repository status.
   3. Return to the Create image dashboard and click Next.
9. Optional: On the Name image page, enter a name for the image. Each image has a unique Universally Unique Identifier (UUID). Click Next.

10. On the Review page, verify the image details about the image creation and click Create image.

    The system verifies the build manifest of the image. After it reaches 100%, the image is added to the build queue.

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. Access Hybrid Cloud Console.

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

   The Insights Images dashboard appears.

3. Click Create image.

   The Images wizard opens.

1. From the Release list, select the release that you want to use.
2. From the Select target environments option, select the target environment you want.
3. Click Next.
4. From the Target Environment - Microsoft Azure page, complete the following steps:

5. Select one of the share methods to share your Red Hat image with your Azure account:

   Use an account configured from Sources to import the account directly from the cloud provider.

   Manually enter an account ID to enter the account manually.

6. For the Use an account configured from Source sharing method:

   1. From the Source Name drop-down menu, select the source you want.

      The Azure Tenant GUID and your Subscription ID are filled automatically. Insights Images checks if your Azure Tenant GUID is correct and the Authorize Image Builder button becomes available.

   2. Click Authorize Image Builder to authorize Insights Images to push images to the Microsoft Azure portal. See Authorizing image builder to push images to Microsoft Azure Cloud to learn how to authorize Image Builder as a tenant.
   3. From the dropdown menu, select your Resource group.
   4. Click Next.

7. For the Manually enter an account ID sharing method:

   1. Enter your Azure Tenant GUID. You can find your Tenant ID in the Azure Active Directory application in Microsoft Azure Portal. Insights Images checks if your Azure Tenant GUID is correct and the Authorize Image Builder button becomes available.
   2. Click Authorize Image Builder to authorize Insights Images to push images to the Microsoft Azure portal. See Authorizing image builder to push images to Microsoft Azure Cloud to learn how to authorize Image Builder as a tenant.
   3. Enter your Subscription ID: you can find your Subscription ID account by accessing the Microsoft Azure console.

   4. Enter your Resource group: it is the name of your Resource Group in Microsoft Azure Portal.

      Note

      By default, Images creates Microsoft Azure images with support for generation 1 VMs. See Support for generation 2 VMs on Azure.

8. Click Next.

   1. On the Register page, select one of the registration methods: Automatically register and enable advanced capabilities or Register later.

      If you choose the Automatically register and enable advanced capabilities option, customize it further.

9. Click the Show additional connection options button.

   The Monitor & manage subscriptions and access to Red Hat content radio button enables the following option:

   • Enable predictive analytics and management capabilities - to provide actionable intelligence about your Red Hat Enterprise Linux environments, helping to identify and address operational and vulnerability risks before an issue results in downtime.
   • Enable remote remediations and system management with automation - Red Hat connector (rhc) enables Red Hat Enterprise Linux hosts to connect to Red Hat Insights to use Red Hat Insights Remediations service.
10. Check or uncheck the checkboxes according to your preferences.

11. From the dropdown menu, choose an activation key to use for the image. See Creating an activation key.

    1. No activation keys found - If you do not have an activation key, you can choose the default activation key by completing the following step:

       1. Click the Create activation key button. The Select activation key dropdown menu enables the activation-key-default. It is a preset key with the basic configuration. You can manage the activation key by accessing Activation keys.

12. Click Next.

    1. On the File system configuration page, select the recommended Use automatic partitioning or Manually configure partitions for your image file system.

13. To configure your partitions manually, click the Manually configure partitioning radio button.

    The Configure partitions section opens, showing the configuration based on Red Hat standards and security guides.

14. From the drop-down menu, provide details to configure the partitions:

15. For the Mount point field, select one mount point type option

    You can also add an additional path to the Mount point, such as /tmp. For example: /var as a prefix and /tmp as an additional path results in /var/tmp.

    Note

    Depending on the Mount point type you choose, the file system type changes to xfs, and so on.

16. For the Minimum size partition field of the file system, enter the desired minimum partition size. In the Minimum size drop-down menu, you can use common size units such as GiB, MiB, or KiB. The default unit is GiB.

17. To add more partitions, click Add partition and repeat the steps for each added partition.

    Click Next.

    1. Optional: On the Content page, complete the following steps to add additional packages to your image:

18. On the Additional Red Hat packages step:

    1. On the Available packages search field, enter the package name and click the → button.
    2. Click the >> button to add all packages shown in the package search results to the Chosen packages dual list box. Optionally, you can click the > button to add only one selected package at a time.

19. On the Custom repositories page, click Repositories.

    The Custom Repositories page opens in a new browser tab. Go to the new page.

    1. Click Add repositories. Enter the following information:

       1. Name
       2. URL
       3. Restrict architecture: from the drop-down menu, select an architecture. Either mark all the architectures or select one to restrict to your system architecture to prevent incorrect repositories availability.
       4. Restrict OS version: from the drop-down menu, select an operating system (OS). Either allow all RHEL versions or select a version for your system, to prevent incorrect repositories availability.

       5. GPG key: Either upload a file with a GPG key or paste the URL of an existing GPG key.

          Note

          If you do not provide the GPG key for a repository, your system cannot perform the GPG key verification for signed packages in a repository.

       6. Click Save to validate the repository status.

20. Return to the Create image dashboard and click Next.

    1. Optional: On the Name image page, enter a name for the image. Each image has a unique Universally Unique Identifier (UUID). Click Next.

    2. On the Review page, verify the image details about the image creation and click Create image.

       The system verifies the build manifest of the image. After it reaches 100%, the image is added to the build queue.

Procedure

1. Access Hybrid Cloud Console.

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

   The Insights Images dashboard appears.

3. Click Create image.

   The Images wizard opens.

4. On the Image output page, complete the following steps:

   1. From the dropdown menu, select the Release: Red Hat Enterprise Linux (RHEL).

   2. From the Select target environments option, select Google Cloud Platform.

      Click Next.

5. On the Target environment - Google Cloud Platform page, select a valid account type to share your image with:

   • Google account: A Google account which interacts with Google Cloud, for example: user@gmail.com.
   • Service account: An application account, for example: myapp@appspot.gserviceaccount.com.
   • Google group: A named collection of Google accounts and service accounts, for example: admins@example.com.
   • Google workspace domain/Cloud identity domain: A virtual group of all the Google accounts in a named organization. For example, the domain name mycompany.com.

6. Enter the account email address or domain name, depending on the type of target environment you chose.

   Click Next.

7. On the Register page, select one of the registration methods: Automatically register and enable advanced capabilities or Register later.

   If you choose the Automatically register and enable advanced capabilities option, customize it further.

   1. Click the Show additional connection options button.

      The Monitor & manage subscriptions and access to Red Hat content radio button enables the following option:

      • Enable predictive analytics and management capabilities - to provide actionable intelligence about your Red Hat Enterprise Linux environments, helping to identify and address operational and vulnerability risks before an issue results in downtime.
      • Enable remote remediations and system management with automation - Red Hat connector (rhc) enables Red Hat Enterprise Linux hosts to connect to Red Hat Insights to use Red Hat Insights Remediations service.
   2. Check or uncheck the checkboxes according to your preferences.

   3. From the dropdown menu, choose an activation key to use for the image. See Creating an activation key.

      1. No activation keys found - If you do not have an activation key, you can choose the default activation key by completing the following step:

         1. Click the Create activation key button. The Select activation key dropdown menu enables the activation-key-default. It is a preset key with the basic configuration. You can manage the activation key by accessing Activation keys.
   4. Click Next.

8. On the File system configuration page, select the recommended Use automatic partitioning or Manually configure partitions for your image file system.

   1. To configure your partitions manually, click the Manually configure partitioning radio button.

      The Configure partitions section opens, showing the configuration based on Red Hat standards and security guides.

   2. From the drop-down menu, provide details to configure the partitions:

   3. For the Mount point field, select one mount point type option

      You can also add an additional path to the Mount point, such as /tmp. For example: /var as a prefix and /tmp as an additional path results in /var/tmp.

      Note

      Depending on the Mount point type you choose, the file system type changes to xfs, and so on.

   4. For the Minimum size partition field of the file system, enter the desired minimum partition size. In the Minimum size drop-down menu, you can use common size units such as GiB, MiB, or KiB. The default unit is GiB.

   5. To add more partitions, click Add partition and repeat the steps for each added partition.

      Click Next.

9. Optional: On the Content page, complete the following steps to add additional packages to your image:

   1. On the Additional Red Hat packages step:

      1. On the Available packages search field, enter the package name and click the → button.
      2. Click the >> button to add all packages shown in the package search results to the Chosen packages dual list box. Optionally, you can click the > button to add only one selected package at a time.

   2. On the Custom repositories page, click Repositories.

      The Custom Repositories page opens in a new browser tab. Go to the new page.

      1. Click Add repositories. Enter the following information:

         1. Name
         2. URL
         3. Restrict architecture: from the drop-down menu, select an architecture. Either mark all the architectures or select one to restrict to your system architecture to prevent incorrect repositories availability.
         4. Restrict OS version: from the drop-down menu, select an operating system (OS). Either allow all RHEL versions or select a version for your system, to prevent incorrect repositories availability.

         5. GPG key: Either upload a file with a GPG key or paste the URL of an existing GPG key.

            Note

            If you do not provide the GPG key for a repository, your system cannot perform the GPG key verification for signed packages in a repository.

         6. Click Save to validate the repository status.
   3. Return to the Create image dashboard and click Next.
10. Optional: On the Details page, enter a name for the image. Each image has a unique Universally Unique Identifier (UUID). Click Next.

11. On the Review page, verify the image details about the image creation and click Create image.

    The system verifies the build manifest of the image. After it reaches 100%, the image is added to the build queue.

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. Access Hybrid Cloud Console.

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

   The Insights Images dashboard appears.

3. Click Create image.

   The Images wizard opens.

4. On the Image output page, complete the following steps:

   1. From the Release list, select the Release that you want to use: for example, choose Red Hat Enterprise Linux (RHEL).
   2. From the Select target environments option, select VMware vSphere.

   3. Select one of the options:

      • Open virtualization format (.ova)

      • Virtual disk (.vmdk) format

        Click Next.

5. On the Register page, select one of the registration methods: Automatically register and enable advanced capabilities or Register later.

   If you choose the Automatically register and enable advanced capabilities option, customize it further.

   1. Click the Show additional connection options button.

      The Monitor & manage subscriptions and access to Red Hat content radio button enables the following option:

      • Enable predictive analytics and management capabilities - to provide actionable intelligence about your Red Hat Enterprise Linux environments, helping to identify and address operational and vulnerability risks before an issue results in downtime.
      • Enable remote remediations and system management with automation - Red Hat connector (rhc) enables Red Hat Enterprise Linux hosts to connect to Red Hat Insights to use Red Hat Insights Remediations service.
   2. Check or uncheck the checkboxes according to your preferences.

   3. From the dropdown menu, choose an activation key to use for the image. See Creating an activation key.

      1. No activation keys found - If you do not have an activation key, you can choose the default activation key by completing the following step:

         1. Click the Create activation key button. The Select activation key dropdown menu enables the activation-key-default. It is a preset key with the basic configuration. You can manage the activation key by accessing Activation keys.
   4. Click Next.

6. On the File system configuration page, select the recommended Use automatic partitioning or Manually configure partitions for your image file system.

   1. To configure your partitions manually, click the Manually configure partitioning radio button.

      The Configure partitions section opens, showing the configuration based on Red Hat standards and security guides.

   2. From the drop-down menu, provide details to configure the partitions:

   3. For the Mount point field, select one mount point type option

      You can also add an additional path to the Mount point, such as /tmp. For example: /var as a prefix and /tmp as an additional path results in /var/tmp.

      Note

      Depending on the Mount point type you choose, the file system type changes to xfs, and so on.

   4. For the Minimum size partition field of the file system, enter the desired minimum partition size. In the Minimum size drop-down menu, you can use common size units such as GiB, MiB, or KiB. The default unit is GiB.

   5. To add more partitions, click Add partition and repeat the steps for each added partition.

      Click Next.

7. Optional: On the Content page, complete the following steps to add additional packages to your image:

   1. On the Additional Red Hat packages step:

      1. On the Available packages search field, enter the package name and click the → button.
      2. Click the >> button to add all packages shown in the package search results to the Chosen packages dual list box. Optionally, you can click the > button to add only one selected package at a time.

   2. On the Custom repositories page, click Repositories.

      The Custom Repositories page opens in a new browser tab. Go to the new page.

      1. Click Add repositories. Enter the following information:

         1. Name
         2. URL
         3. Restrict architecture: from the drop-down menu, select an architecture. Either mark all the architectures or select one to restrict to your system architecture to prevent incorrect repositories availability.
         4. Restrict OS version: from the drop-down menu, select an operating system (OS). Either allow all RHEL versions or select a version for your system, to prevent incorrect repositories availability.

         5. GPG key: Either upload a file with a GPG key or paste the URL of an existing GPG key.

            Note

            If you do not provide the GPG key for a repository, your system cannot perform the GPG key verification for signed packages in a repository.

         6. Click Save to validate the repository status.
   3. Return to the Create image dashboard and click Next.
8. Optional: On the Details page, enter a name for the image. Each image has a unique Universally Unique Identifier (UUID). Click Next.

9. On the Review page, verify the image details about the image creation and click Create image.

   The system verifies the build manifest of the image. After it reaches 100%, the image is added to the build queue.

Procedure

1. Access Hybrid Cloud Console.

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

   The Insights Images dashboard appears.

3. Click Create image.

   The Images wizard opens.

4. On the Image output page, complete the following steps:

   1. From the Releases list, select the release of Red Hat Enterprise Linux (RHEL) that you want to use to create the image.
   2. From the Architecture list, select the architecture that you want to use.
   3. From the Select target environments options, select Virtualization - Guest image (.qcow2).
5. Click Next.

6. On the Register page, select one of the registration methods: Automatically register and enable advanced capabilities or Register later.

   If you choose the Automatically register and enable advanced capabilities option, customize it further.

   1. Click the Show additional connection options button.

      The Monitor & manage subscriptions and access to Red Hat content radio button enables the following option:

      • Enable predictive analytics and management capabilities - to provide actionable intelligence about your Red Hat Enterprise Linux environments, helping to identify and address operational and vulnerability risks before an issue results in downtime.
      • Enable remote remediations and system management with automation - Red Hat connector (rhc) enables Red Hat Enterprise Linux hosts to connect to Red Hat Insights to use Red Hat Insights Remediations service.
   2. Check or uncheck the checkboxes according to your preferences.

   3. From the dropdown menu, choose an activation key to use for the image. See Creating an activation key.

      1. No activation keys found - If you do not have an activation key, you can choose the default activation key by completing the following step:

         1. Click the Create activation key button. The Select activation key dropdown menu enables the activation-key-default. It is a preset key with the basic configuration. You can manage the activation key by accessing Activation keys.
   4. Click Next.

7. On the File system configuration page, select the recommended Use automatic partitioning or Manually configure partitions for your image file system.

   1. To configure your partitions manually, click the Manually configure partitioning radio button.

      The Configure partitions section opens, showing the configuration based on Red Hat standards and security guides.

   2. From the drop-down menu, provide details to configure the partitions:

   3. For the Mount point field, select one mount point type option

      You can also add an additional path to the Mount point, such as /tmp. For example: /var as a prefix and /tmp as an additional path results in /var/tmp.

      Note

      Depending on the Mount point type you choose, the file system type changes to xfs, and so on.

   4. For the Minimum size partition field of the file system, enter the desired minimum partition size. In the Minimum size drop-down menu, you can use common size units such as GiB, MiB, or KiB. The default unit is GiB.

   5. To add more partitions, click Add partition and repeat the steps for each added partition.

      Click Next.

8. Optional: On the Content page, complete the following steps to add additional packages to your image:

   1. On the Additional Red Hat packages step:

      1. On the Available packages search field, enter the package name and click the → button.
      2. Click the >> button to add all packages shown in the package search results to the Chosen packages dual list box. Optionally, you can click the > button to add only one selected package at a time.

   2. On the Custom repositories page, click Repositories.

      The Custom Repositories page opens in a new browser tab. Go to the new page.

      1. Click Add repositories. Enter the following information:

         1. Name
         2. URL
         3. Restrict architecture: from the drop-down menu, select an architecture. Either mark all the architectures or select one to restrict to your system architecture to prevent incorrect repositories availability.
         4. Restrict OS version: from the drop-down menu, select an operating system (OS). Either allow all RHEL versions or select a version for your system, to prevent incorrect repositories availability.

         5. GPG key: Either upload a file with a GPG key or paste the URL of an existing GPG key.

            Note

            If you do not provide the GPG key for a repository, your system cannot perform the GPG key verification for signed packages in a repository.

         6. Click Save to validate the repository status.
   3. Return to the Create image dashboard and click Next.
9. Optional: On the Name image page, enter a name for the image. Each image has a unique Universally Unique Identifier (UUID). Click Next.

10. On the Review page, verify the image details about the image creation and click Create image.

    The system verifies the build manifest of the image. After it reaches 100%, the image is added to the build queue.

    Note

    The .qcow2 images are available for 6 hours and expire after that. Ensure to download the image to avoid losing it.

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 wizard opens.

4. On the Image output page, select the release. Then, click Next

   1. From the Release list, select the release that you want to use.
   2. From the Architecture list, select the architecture that you want to use.
   3. From the Select target environments option, select Bare metal - Installer (.iso).
   4. Click Next.

5. On the Register page, select one of the registration methods: Automatically register and enable advanced capabilities or Register later.

   If you choose the Automatically register and enable advanced capabilities option, customize it further.

   1. Click the Show additional connection options button.

      The Monitor & manage subscriptions and access to Red Hat content radio button enables the following option:

      • Enable predictive analytics and management capabilities - to provide actionable intelligence about your Red Hat Enterprise Linux environments, helping to identify and address operational and vulnerability risks before an issue results in downtime.
      • Enable remote remediations and system management with automation - Red Hat connector (rhc) enables Red Hat Enterprise Linux hosts to connect to Red Hat Insights to use Red Hat Insights Remediations service.
   2. Check or uncheck the checkboxes according to your preferences.

   3. From the dropdown menu, choose an activation key to use for the image. See Creating an activation key.

      1. No activation keys found - If you do not have an activation key, you can choose the default activation key by completing the following step:

         1. Click the Create activation key button. The Select activation key dropdown menu enables the activation-key-default. It is a preset key with the basic configuration. You can manage the activation key by accessing Activation keys.
   4. Click Next.

6. On the File system configuration page, select the recommended Use automatic partitioning. The Installer (.iso) image type does not accept customized partitions. If you try to manually configure the filesystem customization, it will not be applied to any system built by the Installer (.iso) image.

   Click Next.

7. Optional: On the Content page, complete the following steps to add additional packages to your image:

   1. On the Additional Red Hat packages step:

      1. On the Available packages search field, enter the package name and click the → button.
      2. Click the >> button to add all packages shown in the package search results to the Chosen packages dual list box. Optionally, you can click the > button to add only one selected package at a time.

   2. On the Custom repositories page, click Repositories.

      The Custom Repositories page opens in a new browser tab. Go to the new page.

      1. Click Add repositories. Enter the following information:

         1. Name
         2. URL
         3. Restrict architecture: from the drop-down menu, select an architecture. Either mark all the architectures or select one to restrict to your system architecture to prevent incorrect repositories availability.
         4. Restrict OS version: from the drop-down menu, select an operating system (OS). Either allow all RHEL versions or select a version for your system, to prevent incorrect repositories availability.

         5. GPG key: Either upload a file with a GPG key or paste the URL of an existing GPG key.

            Note

            If you do not provide the GPG key for a repository, your system cannot perform the GPG key verification for signed packages in a repository.

         6. Click Save to validate the repository status.
   3. Return to the Create image dashboard and click Next.
8. Optional: On the Details page, enter a name for the image. Each image has a unique Universally Unique Identifier (UUID). Click Next.

9. On the Review page, verify the image details about the image creation and click Create image.

   The system verifies the build manifest of the image. After it reaches 100%, the image is added to the build queue.

Procedure

1. Log in to the Hybrid Cloud Console and turn on Preview mode by switching the Preview toggle to On in the menu bar.
2. Access Hybrid Cloud Console and log in.

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

   The Insights Images dashboard appears.

4. Click Create image.

   The Images wizard opens.

5. On the Image output page, complete the following steps:

   1. From the dropdown menu, select the Release: Red Hat Enterprise Linux (RHEL).
   2. From the Select target environments option, select Oracle Cloud Infrastructure.
   3. Click Next.

6. On the Target environment - Oracle Cloud Infrastructure page, enter the following mandatory details.

   1. User OCID: you can find it in the OCI console user details page.
   2. Private key.
7. Click Next.

8. On the Register page, select one of the registration methods:

   • Automatically register and enable advanced capabilities

   • Register later.

     If you choose the Automatically register and enable advanced capabilities option, customize it further.

     1. Click Show additional connection options.

        The Monitor & manage subscriptions and access to Red Hat content radio button enables the following option:

        • Enable predictive analytics and management capabilities - provides actionable intelligence about your Red Hat Enterprise Linux environments. This helps to identify and address operational and vulnerability risks before an issue results in downtime.
        • Enable remote remediations and system management with automation - Red Hat connector (rhc) enables RHEL hosts to connect to Red Hat Insights to use Red Hat Insights Remediations service.
     2. Select the checkboxes according to your preferences.

     3. From the dropdown menu, choose an activation key to use for the image. See Creating an activation key.

        1. No activation keys found - If you do not have an activation key, you can choose the default activation key by completing the following step:

           1. Click the Create activation key button. The Select activation key dropdown menu enables the activation-key-default. It is a preset key with the basic configuration. You can manage the activation key by accessing Activation keys.
     4. Click Next.

9. On the File system configuration page, select the recommended Use automatic partitioning or Manually configure partitions for your image file system.

   1. To configure your partitions manually, click the Manually configure partitioning radio button.

      The Configure partitions section opens and shows the configuration based on Red Hat standards and security guides.

   2. From the drop-down menu, provide details to configure the partitions:

   3. For the Mount point field, select one mount point type option.

      You can also add an additional path to the Mount point, such as /tmp. For example: /var as a prefix and /tmp as an additional path results in /var/tmp.

      Note

      Depending on the Mount point type you choose, the file system type changes accordingly.

   4. For the Minimum size partition field of the file system, configure the minimum partition size.

      In the Minimum size drop-down menu, you can use common size units such as GiB, MiB, or KiB. The default unit is GiB.

   5. To add more partitions, click Add partition and repeat the steps for each added partition.

      Click Next.

10. Optional: On the Content page, complete the following steps to add additional packages to your image:

    1. From the Additional Red Hat packages step:

       1. On the Available packages search field, enter the package name and click the → button.
       2. Click >> to add all packages shown in the package search results to the Chosen packages dual list box. Alternatively, you can click the > button to add only one selected package at a time.

    2. On the Custom repositories page, click Repositories.

       The Custom Repositories page opens in a new browser tab. Go to the new page.

       1. Click Add repositories and enter the following information:

          1. Name
          2. URL
          3. Restrict architecture: from the drop-down menu, select an architecture. Either mark all the architectures or select one for your system to prevent incorrect repositories availability.
          4. Restrict OS version: from the drop-down menu, select an operating system (OS). Either allow all RHEL versions or select a version for your system, to prevent incorrect repositories availability.

          5. GPG key: Either upload a file with a GPG key or paste the URL of an existing GPG key.

             Note

             Without a GPG key, your system cannot perform the verification for signed packages.

          6. Click Save to validate the repository status.
    3. Return to the Create image dashboard and click Next.

11. Optional: On the Details page, enter a name for the image.

    Each image has a unique Universally Unique Identifier (UUID).

12. Click Next.
13. On the Review page, verify the image details about the image creation.
14. Click Create image.

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.

Procedure

1. Access Hybrid Cloud Console.
2. Click Red Hat Insights > RHEL > Inventory > Images.
3. Find an image you want to launch in the public cloud environment and click Launch in the Instance column. The Launch wizard opens.

4. On the Account and customization page, complete the following steps:

   1. From the Select account drop-down menu, select the account you want to use.
   2. From the Select region drop-down menu, select the region to run the instance.

   3. Optionally: From the Select template drop-down menu, select the template you want to use.

      If you do not specify the template, you launch the image under the default security group. Ensure that the default security group allows SSH traffic.

   4. From the Select instance type drop-down menu, select the instance type configuration.

   5. In the Count field, select the number of images you want to launch. Click Next.

      The wizard notifies you if you try to launch too many images. Make sure you have enough resources in your AWS account.

      Note

      You must have the default Virtual Private Cloud (VPC) and Security Group on your AWS account. If you do not have them, contact the AWS support to re-create them.

5. On the SSH key authentication page, select one of the options:

   1. Select existing SSH public key. From the Select public key drop-down menu, add an existing SSH public key.
   2. Add and save a new SSH public key. Enter a name for your new SSH public key and drag or upload a new SSH public key file. Click Next.
6. On the Review page, review the details about the image launch process and click Launch.

Verification

1. The Launch wizard shows the green checkmark with a message System launched successfully.
2. To verify the instance is running, copy the ssh command displayed on the screen to your terminal and connect to the instance.

Procedure

1. Access Hybrid Cloud Console.
2. Click Red Hat Insights > RHEL > Inventory > Images.
3. Find an image you want to launch in the public cloud environment and click Launch in the Instance column. The Launch wizard opens.

4. On the Account and customization page, complete the following steps:

   1. From the Select account drop-down menu, select the account you want to use.

   2. From the Azure resource group drop-down menu, select the resource group in which you want to run your instance.

      This creates the resources in the same region that this resource group is located. You can leave this field empty to run the instance in the same resource group as the image.

   3. From the Select instance size drop-down menu, select the instance type configuration.

   4. In the Count field, select the number of images you want to launch. Click Next.

      The wizard notifies you if you try to launch too many images. Make sure you have enough quotas in your Microsoft Azure subscription when you are launching a large set of images.

5. On the SSH key authentication page, choose to use an existing SSH key or add a new SSH key:

   To select an existing SSH public key, follow the steps

   1. From the Select public key drop-down menu, choose an existing SSH public key.
   2. Click Next.

   To Add and save a new SSH public key, follow the steps

   1. In the Name field, enter a name for your new SSH public key.
   2. In the SSH public key, drag or upload a new SSH public key file.

   3. Click Next.

      Note

      Microsoft Azure does not support the ed25519 SSH keys.

6. On the Review page, review the details about the image launch process and click Launch.

Verification

1. The Launch wizard shows the green checkmark with a message System launched successfully.
2. To verify the instance is running, copy the ssh command displayed on the screen to your terminal and connect to the instance.

Procedure

1. Access Hybrid Cloud Console.
2. Click Red Hat Insights > RHEL > Inventory > Images.
3. Find the image you want to launch in the public cloud environment and click Launch in the Instance column. The Launch wizard opens.

4. On the Account and customization page, complete the following steps:

   1. From the Select account drop-down menu, select the account you want to use.

   2. Optionally: From the Select template drop-down menu, select the template you want to use.

      If you do not specify the template, you launch the image to the default Virtual Private Cloud (VPC) with its firewall rules.

   3. From the Select machine type drop-down menu, select the machine configuration.
   4. In the Count field, select the number of images you want to launch and click Next.

5. On the SSH key authentication page, select one of the options:

   1. Select existing SSH public key. From the Select public key drop-down menu, choose an existing SSH public key. Click Next.
   2. Add and save a new SSH public key. Enter a name for your new SSH public key and drag or upload a new SSH public key file. Click Next.
6. On the Review page, review the details about the image launch process and click Launch.

Verification

1. The Launch wizard shows the green checkmark with a message System launched successfully.
2. To verify the instance is running, copy the ssh command displayed on the screen to your terminal and connect to the instance.

Procedure

1. Access the directory where you downloaded your .vmdk image.

2. Create a file named metadata.yaml. Add the following information to this file:

   instance-id: cloud-vm
   local-hostname: vmname

3. Create a file named userdata.yaml. Add the following information to the file:

   #cloud-config
   users:
   - name: admin
     sudo: "ALL=(ALL) NOPASSWD:ALL"
     ssh_authorized_keys:
     - ssh-rsa AAA...fhHQ== your.email@example.com

   • ssh_authorized_keys is your SSH public key. You can find your SSH public key in ~/.ssh/id_rsa.pub.

4. Export the metadata.yaml and userdata.yaml files to the environment, compressed with gzip, encoded in base64 as follows. They will be used in further steps.

   export METADATA=$(gzip -c9 <metadata.yaml | { base64 -w0 2>/dev/null || base64; }) \
   USERDATA=$(gzip -c9 <userdata.yaml | { base64 -w0 2>/dev/null || base64; })

5. Launch the image on vSphere with the metadata.yaml and userdata.yaml files:

   1. Import the .vmdk image in to vSphere:

      $ govc import.vmdk ./composer-api.vmdk foldername

   2. Create the VM in vSphere without powering it on:

      govc vm.create \
      -net.adapter=vmxnet3 \
      -m=4096 -c=2 -g=rhel8_64Guest \
      -firmware=bios -disk=”foldername/composer-api.vmdk” \
      -disk.controller=ide -on=false \
       vmname

   3. Change the VM to add ExtraConfig variables, the cloud-init config:

      govc vm.change -vm vmname \
      -e guestinfo.metadata="${METADATA}" \
      -e guestinfo.metadata.encoding="gzip+base64" \
      -e guestinfo.userdata="${USERDATA}" \
      -e guestinfo.userdata.encoding="gzip+base64"

   4. Power-on the VM:

      govc vm.power -on vmname

   5. Retrieve the VM IP address:

      HOST=$(govc vm.ip vmname)

   6. Use SSH to log in to the VM, using the user-data specified in cloud-init file configuration:

      $ ssh admin@HOST

Procedure

1. In the vSphere Client, from the Actions menu, select Deploy OVF Template.
2. On the Deploy OVF Template page, complete the settings for each configuration option and click Next.

3. Click Finish. The .ova image starts to be deployed.

   After the image deployment is complete, you have a new virtual machine (VM) from the .ova image.

4. In the deployed image page, perform the following steps:

   1. From the Actions menu, select Edit Setting.

   2. On the Virtual Hardware tab, configure resources such as CPU, memory, add a new network adapter, between others of your choice.

      1. On the CD/DVD drive 1 option, attach a CD or DVD Drive that contains a cloud-init.iso, to provision a user on startup.

         The VM is now ready to boot with the username and password from the cloud-init.iso file.

Procedure

1. Access the directory where you downloaded your QCOW2 image.

2. Create a file named meta-data. Add the following information to this file:

   instance-id: nocloud
   local-hostname: vmname

3. Create a file named user-data. Add the following information to the file:

   #cloud-config
   user: admin
   password: password
   chpasswd: {expire: False}
   ssh_pwauth: True
   ssh_authorized_keys:
     - ssh-rsa AAA...fhHQ== your.email@example.com

   • ssh_authorized_keys is your SSH public key. You can find your SSH public key in ~/.ssh/id_rsa.pub.

4. Use the genisoimage command to create an ISO image that includes the user-data and meta-data files.

   # genisoimage -output cloud-init.iso -volid cidata -joliet -rock user-data meta-data
   
   I: -input-charset not specified, using utf-8 (detected in locale settings)
   Total translation table size: 0
   Total rockridge attributes bytes: 331
   Total directory bytes: 0
   Path table size(bytes): 10
   Max brk space used 0
   183 extents written (0 MB)

5. Create a new VM from the KVM Guest Image using the virt-install command. Include the ISO image you created on step 4 as an attachment to the VM image.

   # virt-install \
       --memory 4096 \
       --vcpus 4 \
       --name myvm \
       --disk composer-api.qcow2,device=disk,bus=virtio,format=qcow2 \
       --disk cloud-init.iso,device=cdrom \
       --os-variant rhel1-latest \
       --virt-type kvm \
       --graphics none \
       --import

   Where,

   • --graphics none - indicates that it is a headless RHEL Virtual Machine.
   • --vcpus 4 - indicates that it uses 4 virtual CPUs.
   • --memory 4096 - indicates that it uses 4096 MB RAM.

6. The VM installation starts:

   Starting install...
   Connected to domain myvm
   ...
   [  OK  ] Started Execute cloud user/final scripts.
   [  OK  ] Reached target Cloud-init target.
   
   Red Hat Enterprise Linux 1-latest (Ootpa)
   Kernel 4.18.0-221.el8.x86_64 on an x86_64

Procedure

1. Access the directory where you downloaded your ISO image.
2. Place the bootable ISO image file on a USB flash drive.
3. Connect the USB flash drive to the port of the computer you want to boot.
4. Boot the ISO image from the USB flash drive.

5. Perform the steps to install the customized bootable ISO image.

   The boot screen shows you the following options:

   • Install Red Hat Enterprise Linux 1-latest
   • Test this media & install Red Hat Enterprise Linux 1-latest

Procedure

1. In the Oracle Cloud UI dashboard, click Compute > Custom Images.
2. On the Custom Images dashboard, click Import image.

3. On the Import image window, set the following configuration:

   1. Select the Import from an object storage URL option.
   2. In the Object Storage URL field, paste the URL given by Insights Images into it.
   3. Choose the QCOW2 image type.
   4. Under Launch mode, select the Paravirtualized mode option.
4. Click Import Image.