Menu Close

Chapter 2. Managing the cluster lifecycle

You can use Red Hat OpenShift Cluster Manager to create and delete OpenShift clusters, and manage the cluster lifecycle.

2.1. Creating clusters

You can create different types of OpenShift clusters from OpenShift Cluster Manager.

2.1.1. Creating an OpenShift Container Platform cluster

OpenShift Container Platform clusters run on your own infrastructure. Using OpenShift Container Platform, you can create your clusters on a private or public cloud, or on bare metal, using the command-line installer.

Create your cluster using OpenShift Cluster Manager and the installer for your environment or cloud account.

After provisioning your cluster, configure your Red Hat subscription to get support for your cluster. See Subscribing an OpenShift Container Platform cluster for instructions and to learn more about subscription types available for clusters.

Prerequisites

  • A Red Hat login
  • Your own on-premises infrastructure. For example, a platform such as Red Hat Virtualization or Red Hat OpenStack; a cloud provider such as AWS; or a bare-metal Linux machine.

Procedure

  1. Go to OpenShift Cluster Manager and click Create cluster.
  2. Select the location where you want to install your cluster: in the public cloud (Cloud), in your datacenter (Datacenter), or on your laptop (Local).
  3. Download the provided openshift-install program.
  4. Download the pull secret.

    Important

    Do not share your pull secret. The pull secret should be treated like a password.

  5. Follow the instructions provided in the OpenShift Cluster Manager user interface to create your OpenShift cluster.

By default, your cluster automatically registers to the OpenShift Cluster Manager service the first time your cluster boots after installation and is connected to the Telemetry service. The cluster is registered with a 60-day evaluation subscription which does not include Red Hat support.

Verification steps

  • After your cluster is provisioned, you can view it in the Clusters list in OpenShift Cluster Manager.

Next steps

After creating your OpenShift Container Platform cluster, you can use the Red Hat Hybrid Cloud Console to:

  • Configure your Red Hat subscription to get support for your cluster from the Edit subscription settings menu in OpenShift Cluster Manager. You can subscribe your OpenShift Container Platform clusters to an Annual Red Hat subscription or an On-Demand subscription from the Red Hat Marketplace.

See Configuring OpenShift Container Platform cluster subscriptions for instructions and more information about subscription types for clusters.

Additional resources

2.1.2. Creating an OpenShift Dedicated cluster

OpenShift Dedicated clusters are managed by Red Hat and provisioned on Amazon Web Services (AWS) or Google Cloud Platform (GCP). They are referred to as managed clusters.

Using OpenShift Cluster Manager, you can create an OpenShift Dedicated cluster on AWS or GCP using as cloud account owned by Red Hat or with your own cloud account using the Customer Cloud Subscription (CCS) model.

When creating your OpenShift Dedicated cluster, you must also configure the Red Hat subscription type for the cluster to use. Your cluster is then automatically subscribed to your Red Hat subscriptions and comes with Premium-level support.

You can use the following types of Red Hat subscriptions to support your OpenShift Dedicated clusters:

You can view your quota and resource limits alongside cluster usage, based on your active OpenShift Dedicated clusters, from the Subscriptions area in OpenShift Cluster Manager.

Important

You cannot change the subscription type on an existing OpenShift Dedicated cluster, with the exception of upgrading a trial subscription. For detailed instructions about creating a new cluster, see Creating a cluster in the OpenShift Dedicated documentation.

Additional resources

2.1.2.1. Creating an OpenShift Dedicated cluster with an annual subscription

You can create an OpenShift Dedicated cluster using an annual (fixed capacity) Red Hat subscription on your own AWS or Google Cloud Platform cloud provider (Customer Cloud Subscription), or use Red Hat’s fully-managed cloud to run your OpenShift Dedicated clusters.

This is the traditional Red Hat subscription type and support is pre-purchased from Red Hat and billed annually. Cluster provisioning is based on available quota. Quota is allocated from Red Hat subscriptions and is required to scale up a cluster.

To use an On-Demand (flexible usage) subscription for your cluster instead, see Section 2.1.2.2, “Creating an OpenShift Dedicated cluster with an On-Demand subscription”.

Important

You cannot change the subscription type after the cluster is created.

Prerequisites

  • A Red Hat login
  • Your organization must have an active Red Hat OpenShift Dedicated subscription with sufficient quota to create a cluster. Check your available quota from Subscriptions > Dedicated (Annual).
  • If you are creating a cluster on your own AWS or Google Cloud (Customer Cloud Subscription), you must configure your cloud account before creating your cluster. See the OpenShift Dedicated Planning guide to understand the requirements for Customer Cloud Subscriptions.

Procedure

  1. From OpenShift Cluster Manager, click Create cluster.
  2. From the Cloud tab next to OpenShift Dedicated, click Create cluster. You can also view your available quota from this screen before creating your cluster.
  3. In the Billing Model screen, select Annual as your Subscription type.

    Important

    You cannot change the subscription type after the cluster is created.

  4. Select your Infrastructure type:

    • Customer Cloud Subscription uses your own cloud account, where you control billing and Red Hat manages the cluster for you. You must configure your cloud account before creating your cluster. See the OpenShift Dedicated Planning guide for instructions.
    • Red Hat cloud account deploys your cluster in cloud provider accounts owned by Red Hat. For this option, Red Hat handles all billing and management for your cluster.
  5. Configure basic cluster settings, including your cloud provider, machine pools, networking, and update policies.

    Note

    See the OpenShift Dedicated documentation for detailed information about configuring your cluster settings.

  6. Click Create cluster to provision your cluster.

Verification

  • While your cluster is being provisioned, you can view it in the Clusters list in OpenShift Cluster Manager. The cluster will show its Status as Ready when provisioning is complete.

Next steps

After creating your OpenShift Dedicated cluster and its status is Ready, you can:

Additional resources

2.1.2.2. Creating an OpenShift Dedicated cluster with an On-Demand subscription

You can use the On-Demand subscription type to create an OpenShift Dedicated cluster that is billed by usage. Billing is post-paid and handled by the Red Hat Marketplace.

When you enable an On-Demand subscription in Red Hat Marketplace, you set resource limits for your services to control maximum usage automatically.

This option allows the flexibility to scale your cluster up and down as needed, and to be billed accordingly. You can track usage by cluster in Subscriptions > Dedicated (On-Demand).

To use an annual (fixed capacity) subscription for your cluster instead, see Section 2.1.2.1, “Creating an OpenShift Dedicated cluster with an annual subscription”.

Important

You cannot change the subscription type after the cluster is created.

Prerequisites

  • A Red Hat login
  • Your organization must have an active OpenShift Dedicated On-Demand subscription enabled from the Red Hat Marketplace with resource limits configured.

  • Your own AWS or Google Cloud account, configured as described in the OpenShift Dedicated Planning documentation.

Procedure

  1. From OpenShift Cluster Manager, click Create cluster.
  2. From the Cloud tab next to OpenShift Dedicated, click Create cluster. You can also view your available quota from this screen before creating your cluster.
  3. In the Billing Model screen, select On-Demand as your Subscription type.

    Note

    If On-Demand is not available as an option, follow the prompts in the OpenShift Cluster Manager user interface to enable an account and link your billing information in the Red Hat Marketplace. You can also verify whether On-Demand billing (Red Hat Marketplace subscriptions) is configured from the Subscriptions > Dedicated (On-Demand Limits) in OpenShift Cluster Manager.

    You cannot change the subscription type after the cluster is created.

  4. Select Customer Cloud Subscription as your Infrastructure type. This is required for the On-Demand subscription option.

    Note

    The Customer Cloud Subscription option uses your own cloud account, where you control billing and Red Hat manages the cluster for you. You must configure your cloud account before creating your cluster. See the OpenShift Dedicated Planning guide for instructions.

  5. Configure basic cluster settings, including your cloud provider, cluster details, machine pools, networking, update policies.

    Note

    See the OpenShift Dedicated documentation for detailed information about configuring your cluster settings.

  6. Click Create cluster to provision your cluster.

Verification

  • While your cluster is being provisioned, you can view it in the Clusters list in OpenShift Cluster Manager. The cluster will show its Status as Ready when provisioning is complete.

Next steps

After creating your OpenShift Dedicated cluster and its status is Ready, you can:

Additional resources

2.1.2.3. Creating an OpenShift Dedicated cluster with a free trial Red Hat subscription

You can try OpenShift Dedicated free of charge for 60 days by using a trial Red Hat subscription.

OpenShift Dedicated trial clusters are provided without an uptime service level agreement (SLA) and are self-supported.

To use a free trial subscription for your cluster, you need to use your own AWS or Google Cloud account (Customer Cloud Subscription) to provide the infrastructure.

At any time before the 60-day trial is finished, you can upgrade your cluster with your own Red Hat subscription details to continue using OpenShift Dedicated. At the end of the 60-day trial period, if you have not upgraded the trial cluster, your OpenShift Dedicated trial cluster and all installed add-on services are marked for permanent deletion.

To find out more and sign up for an OpenShift Dedicated trial subscription, go to About the OpenShift Dedicated Trial or Try OpenShift.

Prerequisites

  • A Red Hat login
  • An OpenShift Dedicated trial subscription enabled. See About the OpenShift Dedicated Trial for details.
  • Your own AWS or Google Cloud account, configured as described in the OpenShift Dedicated Planning documentation.

Procedure

  1. From OpenShift Cluster Manager, click Create cluster.
  2. From the Cloud tab next to Red Hat OpenShift Dedicated Trial, click Create trial cluster. You can also view your available quota from this screen before creating your cluster.

    • In the next screen (Billing model), Free trial (upgradeable) will be automatically selected as your Subscription type, and Customer Cloud Subscription will be automatically selected as your Infrastructure type.

      Note
      • If Free trial (upgradeable) is not available as an option, follow the prompts in the user interface to enable your Red Hat account.
      • Customer Cloud Subscription uses your own cloud account, where you control billing and Red Hat manages the cluster for you. You must configure your cloud account before creating your cluster. See the OpenShift Dedicated Planning guide for instructions.
  3. Configure basic cluster settings, including your cloud provider, machine pools, networking, and update policies.

    Note

    See the OpenShift Dedicated documentation for detailed information about configuring your cluster settings.

  4. Click Create cluster to provision your cluster.

Verification

  • While your cluster is being provisioned, you can view it in the Clusters list in OpenShift Cluster Manager. The cluster will show its Status as Ready when provisioning is complete.

See the cluster overview page to view the expiry date of the trial subscription and other details. This information also shows on the Clusters list in the Created column.

Next steps

After creating your OpenShift Dedicated cluster and its status is Ready, you can:

Important

Before your 60-day trial expires, upgrade your cluster to a paid fully-supported Red Hat subscription to continue using your cluster. See Upgrading an OpenShift Dedicated trial cluster to a fully supported cluster.

Additional resources

2.1.3. Creating a Red Hat OpenShift Service on AWS (ROSA) cluster

Red Hat OpenShift Service on AWS (ROSA) is a fully-managed OpenShift service, jointly managed and supported by both Red Hat and Amazon Web Services (AWS). Having your clusters maintained by this service gives you the freedom to focus on deploying applications.

This service is licensed directly from your AWS account. ROSA pricing is consumption-based and is billed directly to your AWS account.

You can create a ROSA cluster from OpenShift Cluster Manager or by using the rosa CLI.

To create a ROSA cluster in OpenShift Cluster Manager, go to the cluster creation page, find Red Hat OpenShift Service on AWS and click Create cluster.

For full details about creating a ROSA cluster from OpenShift Cluster Manager or the rosa CLI, see Getting started in the ROSA documentation.

2.2. Updating clusters

2.2.1. Updating OpenShift cloud services clusters

OpenShift Cluster Manager allows you to update, or upgrade, your cloud services clusters. Updating your cluster to the latest version ensures your cluster is secure and supported. Cluster updates are rolling per node and do not require you to take your cluster or workloads offline.

The Overview and Settings tabs for your cluster in OpenShift Cluster Manager inform you if an OpenShift version update is available for your Red Hat OpenShift Dedicated (OSD) or Red Hat OpenShift Service on AWS (ROSA) cluster. From the Settings tab, you can apply updates to your cluster, or configure your update strategy for future cluster updates.

You can choose to schedule recurring or individual updates for your cluster by selecting one of these update strategy options in the Settings tab:

  • Individual updates allows you to schedule one update at a time manually.
  • Recurring updates allows you to configure a schedule for updates to occur at a preferred time every week if an update is available. Recurring updates will only occur when a new patch (z-stream) update becomes available at least two days prior to your selected start time. Recurring updates will only schedule minor (y-stream) updates if the update has been manually acknowledged in the Settings tab of OpenShift Cluster Manager.

You can configure either update strategy for both minor version and patch (z-stream) updates.

Note

In the event of Critical security concerns (CVEs) that significantly impact the security or stability of the cluster, updates may be automatically scheduled by Red Hat Site Reliability Engineering (SRE) to the latest z-stream version not impacted by the CVE within two business days after customer notifications if the customer has not already scheduled an update.

Additional resources

For details about updating your cluster, see the documentation for your cluster type:

  • The OpenShift Dedicated Upgrading guide contains details about updating OpenShift Dedicated clusters.
  • The ROSA Upgrading guide contains details about updating ROSA clusters.
  • The Updating clusters guide contains details about updating OpenShift Container Platform clusters. Note that OpenShift Container Platform clusters cannot be updated from OpenShift Cluster Manager.

2.3. Deleting clusters

2.3.1. Removing an OpenShift Container Platform cluster from OpenShift Cluster Manager

You can archive an OpenShift Container Platform cluster to delete it from OpenShift Cluster Manager. Archiving a cluster removes it from subscription management and from the cluster list in OpenShift Cluster Manager.

You cannot delete an OpenShift Container Platform cluster from your infrastructure using OpenShift Cluster Manager.

Note

To fully delete an OpenShift Container Platform cluster, see the instructions for destroying a cluster on your infrastructure type in the OpenShift Container Platform Installing documentation.

Prerequisites

  • A Red Hat login
  • An OpenShift Container Platform cluster
  • You must have the Cluster Owner or Cluster Editor role on the cluster, or Organization Administrator privileges in your Red Hat account

Procedure

  1. In OpenShift Cluster Manager select the cluster you want to archive.
  2. Click more options (more options) > Archive cluster to open the archiving dialog.
  3. Click Archive cluster to confirm.

Verification

When archiving is complete, your cluster will no longer appear in the Clusters list in OpenShift Cluster Manager.

You can view all archived clusters in the Cluster Archives list in OpenShift Cluster Manager.

Note

You can restore an OpenShift Container Platform cluster from the archive by locating it in https://console.redhat.com/openshift/archived and clicking Unarchive next to the cluster. It will appear in the Clusters list after it is unarchived.

Additional resources

  • See Installing in the OpenShift Container Platform documentation for the commands to destroy a cluster.

2.3.2. Deleting an OpenShift Dedicated cluster from OpenShift Cluster Manager

You can delete OpenShift Dedicated clusters using OpenShift Cluster Manager.

Prerequisites

  • A Red Hat login
  • An OpenShift Dedicated cluster
  • You must have the Cluster Owner or Cluster Editor role on the cluster, or Organization Administrator privileges in your Red Hat account

Procedure

  1. In OpenShift Cluster Manager select the cluster you want to delete.
  2. Click more options (more options) > Delete cluster to open the Delete cluster dialog.

    Warning

    This action cannot be undone. It will uninstall the cluster, and all data will be deleted.

  3. Confirm you want to delete the cluster by typing the cluster name in the dialog field and click Delete.

Verification

  • Your cluster will show Uninstalling in the Status column on the Clusters page.
  • While the cluster deletion is in progress, you can view Uninstallation logs by opening the cluster details Overview page.

When the deletion is complete, your cluster will no longer appear in the Clusters list in OpenShift Cluster Manager.

You can view your deleted clusters from the Clusters list by clicking more options (more options) > View cluster archives.

2.3.3. Viewing archived and deleted clusters

You can view all deleted and archived OpenShift clusters in your organization from the Cluster Archives list in OpenShift Cluster Manager.

OpenShift Dedicated clusters can be fully deleted in OpenShift Cluster Manager, while OpenShift Container Platform clusters can only be archived. Archiving an OpenShift Container Platform cluster removes it from the OpenShift Cluster Manager cluster list and from subscription management.

Prerequisites

  • A Red Hat login

Procedure

  • Click Cluster Archives to view a list of deleted and archived clusters in OpenShift Cluster Manager.
Note

You can restore an OpenShift Container Platform cluster from the archive by finding the cluster in https://console.redhat.com/openshift/archived and clicking Unarchive next to the cluster. It will appear in the Clusters list after it is unarchived.

Additional resources

  • See Installing in the OpenShift Container Platform documentation for the commands to fully delete (destroy) a cluster.