OpenShift Dedicated cluster creation
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. Use a cloud account owned by Red Hat, or use your own cloud account with 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. For more information, see Creating an OpenShift Dedicated cluster with an annual subscription, linked in Additional resources.
- 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. For more information, see Creating an OpenShift Dedicated cluster with an On-Demand subscription, linked in Additional resources.
- 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. For more information, see About the OpenShift Dedicated Trial and Creating an OpenShift Dedicated cluster with a free trial Red Hat subscription, linked in Additional resources.
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, linked in Additional resources.
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, linked in Additional resources.
Create an OpenShift Dedicated cluster with an annual subscription
You can create an OpenShift Dedicated cluster using an annual (fixed capacity) Red Hat subscription. Use 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.
Before you begin
- You must have 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're 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.
About this task
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 Create an OpenShift Dedicated cluster with an On-Demand subscription.
You cannot change the subscription type after the cluster is created.
Procedure
Results
- 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.
What to do next
After creating your OpenShift Dedicated cluster and its status is Ready, you can:
- Configure an identity provider for user access. For instructions, see Configuring identity providers.
- Configure privileged
dedicated-adminandcluster-adminusers to access your cluster. See 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).
Create 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.
Before you begin
- You must have 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.
- You must have your own AWS or Google Cloud account, configured as described in the OpenShift Dedicated Planning your environment documentation.
About this task
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 Create an OpenShift Dedicated cluster with an annual subscription.
You cannot change the subscription type after the cluster is created.
Procedure
Results
- 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.
What to do next
After creating your OpenShift Dedicated cluster and its status is Ready, you can:
- Configure an identity provider for user access. For instructions, see Configuring identity providers.
- Configure privileged
dedicated-adminandcluster-adminusers to access your cluster. See 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).
Create an OpenShift Dedicated cluster with a trial subscription
You can try OpenShift Dedicated free of charge for 60 days by using a trial Red Hat subscription.
Before you begin
- You must have a Red Hat login.
- You must have an OpenShift Dedicated trial subscription enabled. See About the OpenShift Dedicated Trial for details.
- You must have your own AWS or Google Cloud account, configured as described in the OpenShift Dedicated Planning your environment documentation.
About this task
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.
For more information and to sign up for an OpenShift Dedicated trial subscription, go to About the OpenShift Dedicated Trial or Try OpenShift.
Procedure
Results
- 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.
What to do next
After creating your OpenShift Dedicated cluster and its status is Ready, you can:
- Configure an identity provider for user access. For instructions, see Configuring identity providers.
- Configure privileged
dedicated-adminandcluster-adminusers to access your cluster. See 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).
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.
Create a cluster using the ocm-cli tool
You can create managed clusters quickly using the ocm-cli tool.
Before you begin
- You must have the
ocm-clicommand-line tool installed. See https://github.com/openshift-online/ocm-cli for instructions for your environment. - You must have your OpenShift Cluster Manager offline access token, available at https://console.redhat.com/openshift/token.
Procedure
Results
Clusters are created asynchronously and take time to create before they are ready to use. After running ocm create cluster to create a cluster, you need to periodically check the state attribute to confirm the cluster is ready.
- To verify the cluster is ready to use, check the cluster
stateusing the cluster ID:
$ ocm list cluster <id>When the state is ready, the creation process is complete and you can use your cluster.
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}