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 installation program 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 Go to OpenShift Cluster Manager and click Create cluster on the Red Hat OpenShift Container Platform tile. 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 registers with a 60-day evaluation subscription that does not include Red Hat support. Note You can also create an on-premises cluster using the Assisted Installer. For more information about this method, see Installing on-premise with Assisted Installer . Verification steps After you provision your cluster, click Cluster List list in the left navivation panel in OpenShift Cluster Manager and confirm that your cluster is listed. 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. View health monitoring data and recommendations for your cluster from Insights Advisor . Contact Red Hat Support in case of any issues. Additional resources See the OpenShift Container Platform installation documentation for information about configuring and working with your clusters. Learn more about OpenShift health monitoring with Telemetry and the Insights Operator in Remote health monitoring with connected clusters . Find information about the latest OpenShift Container Platform release versions on the Releases page in OpenShift Cluster Manager. 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 a 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 includes Premium-level support. You can use the following types of Red Hat subscriptions to support your OpenShift Dedicated clusters: Annual : A subscription providing a fixed capacity of resources, pre-purchased from Red Hat. Cluster provisioning is based on available quota. Quota is allocated from your Red Hat subscriptions and is required to scale up a cluster. See Section 2.1.2.1, "Creating an OpenShift Dedicated cluster with an annual subscription" . On-Demand : A subscription allowing flexible usage, billed through the Red Hat Marketplace. When you enable an On-Demand subscription in Red Hat Marketplace, you set resource limits for your services to control usage automatically. See Section 2.1.2.2, "Creating an OpenShift Dedicated cluster with an On-Demand subscription" . OpenShift Dedicated trial : You can try OpenShift Dedicated for 60 days free of charge with a trial Red Hat subscription. You can upgrade your cluster to a paid Red Hat subscription at any time. See About the OpenShift Dedicated Trial and Section 2.1.2.3, "Creating an OpenShift Dedicated cluster with a free trial Red Hat subscription" for more details. 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 Learn more about getting started with OpenShift Dedicated clusters from Getting started in the OpenShift Dedicated documentation. For more information about subscription types, see Managing OpenShift Dedicated cluster subscriptions . Learn more about Red Hat Marketplace subscriptions. Learn more about trying OpenShift Dedicated in About the OpenShift Dedicated Trial . 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 the Red Hat 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 your environment guide to understand the requirements for Customer Cloud Subscriptions. Procedure From OpenShift Cluster Manager , click Create cluster . From the Cloud tab to OpenShift Dedicated , click Create cluster . You can also view your available quota from this screen before creating your cluster. In the Billing Model screen, select Annual as your Subscription type . Important You cannot change the subscription type after the cluster is created. 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. 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. 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 shows its Status as Ready when provisioning is complete. steps After creating your OpenShift Dedicated cluster and its status is Ready , you can: Configure an identity provider to set up user access. For instructions, see Configuring identity providers . Configure privileged dedicated-admin and cluster-admin users to access your cluster. Learn more about OpenShift Dedicated roles in Managing administration roles and users . Upgrade your cluster. To learn more, see OpenShift Dedicated cluster upgrades . View logs and notifications about your cluster. For more information, see Logging . Create machine pools in your cluster. For more information, see About machine pools . Use the monitoring stack to check your projects in isolation from Red Hat Site Reliability Engineer (SRE) platform metrics. For more information, see Understanding the monitoring stack . Monitor the health of your cluster. For more information, see About remote health monitoring . Scale your OpenShift Dedicated cluster up or down, if you have purchased the necessary subscriptions to do so. For instructions, see Scaling your cluster . Install add-ons to expand the capabilities of your cluster. For more information, see Adding a service to a cluster . View a summary of the resource limits and usage for your cluster in the Red Hat Hybrid Cloud Console at Subscriptions > Dedicated (Annual) . Additional resources Learn more about getting started with OpenShift Dedicated clusters from Getting started in the OpenShift Dedicated documentation. Learn more about subscription types in Managing OpenShift Dedicated cluster subscriptions . 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. Check your resource limits from the Subscriptions > Dedicated (On-Demand Limits) area in OpenShift Cluster Manager. If no resource limits display, go to Red Hat Marketplace to enable your OpenShift Dedicated On-Demand subscription. Your own AWS or Google Cloud account, configured as described in the OpenShift Dedicated Planning your environment documentation. Procedure From OpenShift Cluster Manager , click Create cluster . From the Cloud tab to OpenShift Dedicated , click Create cluster . You can also view your available quota from this screen before creating your cluster. 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. 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. 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. 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 shows its Status as Ready when provisioning is complete. steps After creating your OpenShift Dedicated cluster and its status is Ready , you can: Configure an identity provider to set up user access. For instructions, see Configuring identity providers . Configure privileged dedicated-admin and cluster-admin users to access your cluster. Learn more about OpenShift Dedicated roles in Managing administration roles and users . Upgrade your cluster. To learn more, see OpenShift Dedicated cluster upgrades . View logs and notifications about your cluster. For more information, see Logging . Create machine pools in your cluster. For more information, see About machine pools . Use the monitoring stack to check your projects in isolation from Red Hat Site Reliability Engineer (SRE) platform metrics. For more information, see Understanding the monitoring stack . Monitor the health of your cluster. For more information, see About remote health monitoring . Scale your OpenShift Dedicated cluster up or down, if you have purchased the necessary subscriptions to do so. For instructions, see Scaling your cluster . Install add-ons to expand the capabilities of your cluster. For more information, see Adding a service to a cluster . View a summary of your cluster usage in the Red Hat Hybrid Cloud Console at Subscriptions > Dedicated (On-Demand) . View a summary of the resource limits for your cluster in the Red Hat Hybrid Cloud Console at Subscriptions > Dedicated (On-Demand Limits) . Additional resources Learn more about getting started with OpenShift Dedicated clusters from Getting started in the OpenShift Dedicated documentation. Learn more about subscription types in Managing OpenShift Dedicated cluster subscriptions . Learn more about On-Demand subscriptions and billing in the Red Hat Marketplace documentation . Learn more about subscriptions in the Subscriptions documentation . 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 your environment documentation. Procedure From OpenShift Cluster Manager , click Create cluster . From the Cloud tab 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 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. 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. 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. steps After creating your OpenShift Dedicated cluster and its status is Ready , you can: Configure an identity provider to set up user access. For instructions, see Configuring identity providers . Configure privileged dedicated-admin and cluster-admin users to access your cluster. Learn more about OpenShift Dedicated roles in Managing administration roles and users . Upgrade your cluster. To learn more, see OpenShift Dedicated cluster upgrades . View logs and notifications about your cluster. For more information, see Logging . Create machine pools in your cluster. For more information, see About machine pools . Use the monitoring stack to check your projects in isolation from Red Hat Site Reliability Engineer (SRE) platform metrics. For more information, see Understanding the monitoring stack . Monitor the health of your cluster. For more information, see About remote health monitoring . Scale your OpenShift Dedicated cluster up or down, if you have purchased the necessary subscriptions to do so. For instructions, see Scaling your cluster . Install add-ons to expand the capabilities of your cluster. For more information, see Adding a service to a cluster . View a summary of the resource limits and usage for your cluster in the Red Hat Hybrid Cloud Console at Subscriptions > Dedicated (Annual) . 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 For more details about OpenShift Dedicated trial clusters, see: Try OpenShift About the OpenShift Dedicated Trial Learn more about getting started with OpenShift Dedicated clusters from Getting started in the OpenShift Dedicated documentation. Learn more about subscription types in Managing OpenShift Dedicated cluster subscriptions . Learn more about Red Hat OpenShift Dedicated . 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. Additional resources Product documentation for Red Hat OpenShift Service on AWS 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 contain notifications 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 only occur when a new patch (z-stream) update becomes available at least two days prior to your selected start time. Recurring updates 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 case of Critical security concerns (CVEs) that significantly impact the security or stability of the cluster, updates might 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. Removing, archiving, and deleting clusters There are several ways to remove a cluster from your OpenShift instance. 2.3.1. Removing an OpenShift Container Platform cluster from OpenShift Cluster Manager You can archive an OpenShift Container Platform cluster to remove 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 In OpenShift Cluster Manager , select the cluster that you want to archive. Click ( more options ) > Archive cluster to open the archiving dialog. Click Archive cluster to confirm. Verification When archiving is complete, your cluster no longer appears 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 Cluster Manager cluster from the archive by locating it in https://console.redhat.com/openshift/archived and clicking Unarchive to the cluster. It appears in the Clusters list after it is unarchived. Additional resources See Installing in the OpenShift Container Platform documentation for the commands to delete 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 In OpenShift Cluster Manager , select the cluster that you want to delete. Click ( more options ) > Delete cluster to open the Delete cluster dialog. Warning This action cannot be undone. It uninstalls the cluster, and all data is deleted. Confirm that you want to delete the cluster by entereing the cluster name in the dialog field and then click Delete . Verification Your cluster shows 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 no longer appears in the Clusters list in OpenShift Cluster Manager. You can view your deleted clusters from the Clusters list by clicking ( more options ) > View cluster archives . 2.3.3. Deleting a Red Hat OpenShift Service on AWS cluster from OpenShift Cluster Manager You can delete Red Hat OpenShift Service on AWS (ROSA) clusters using OpenShift Cluster Manager . Prerequisites A Red Hat login. A Red Hat OpenShift Service on AWS (ROSA) cluster. You must have the Cluster Owner or Cluster Editor role on the cluster, or Organization Administrator privileges in your Red Hat account. Procedure In OpenShift Cluster Manager , select the cluster that you want to delete. Click ( more options ) > Delete cluster to open the Delete cluster dialog. Warning This action cannot be undone. It uninstalls the cluster, and all data is deleted. Confirm that you want to delete the cluster by entering the cluster name in the dialog field and then click Delete . Verification Your cluster shows 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 no longer appears in the Clusters list in OpenShift Cluster Manager. You can view your deleted clusters from the Clusters list by clicking ( more options ) > View cluster archives . 2.3.4. 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. You can fully delete OpenShift Dedicated clusters in OpenShift Cluster Manager, but you can only archive OpenShift Container Platform clusters. 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 to the cluster. It appears in the Clusters list after it is unarchived. Additional resources See Installing in the OpenShift Container Platform documentation for the commands to fully delete a cluster.

Commands: