-
Notifications
You must be signed in to change notification settings - Fork 1.9k
[OSDOCS-6943]:OSD-GCP: Purchasing OSD through GCP Marketplace #64901
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,105 @@ | ||
| // Module included in the following assemblies: | ||
| // | ||
| // * osd_install_access_delete_cluster/creating-a-gcp-cluster.adoc | ||
|
|
||
| :_content-type: PROCEDURE | ||
| [id="osd-create-cluster-gcp-account_{context}"] | ||
| = Creating a cluster on GCP with Google Cloud Marketplace | ||
|
|
||
| When creating an {product-title} (OSD) cluster on Google Cloud through the OpenShift Cluster Manager Hybrid Cloud Console, customers can select Google Cloud Marketplace as their preferred billing model. This billing model allows Red Hat customers to take advantage of their link:https://cloud.google.com/docs/cuds[Google Committed Use Discounts (CUD)] towards {product-title} purchased through the Google Cloud Marketplace. Additionally, OSD pricing is consumption-based and customers are billed directly through their Google Cloud account. | ||
|
|
||
| .Procedure | ||
|
|
||
| . Log in to {cluster-manager-url} and click *Create cluster*. | ||
|
|
||
| . In the *Cloud* tab, click *Create cluster* in the *Red Hat OpenShift Dedicated* row. | ||
|
|
||
| . Under *Billing model*, configure the subscription type and infrastructure type: | ||
| .. Select the *On-Demand* subscription type. | ||
| .. From the drop-down menu, select *Google Cloud Marketplace*. | ||
| .. Select the *Customer Cloud Subscription* infrastructure type. | ||
| .. Click *Next*. | ||
| . On the *Cloud provider* page, read the provided prerequisites and the Google terms and conditions. Add your service account key. | ||
| .. Click the *Review Google Terms and Agreements* link. | ||
| .. To continue creating the cluster, click the checkbox indicating that you agree to the Google terms and agreements. | ||
| .. Add your service account key. | ||
| + | ||
| [NOTE] | ||
| ==== | ||
| For more information about service account keys, click the information icon located next to *Service account key*. | ||
| ==== | ||
| .. Click *Next* to validate your cloud provider account and go to the *Cluster details* page. | ||
| . On the *Cluster details* page, provide a name for your cluster and specify the cluster details: | ||
| .. Add a *Cluster name*. | ||
| .. Select a cluster version from the *Version* drop-down menu. | ||
| .. Select a cloud provider region from the *Region* drop-down menu. | ||
| .. Select a *Single zone* or *Multi-zone* configuration. | ||
| .. Select a *Persistent storage* capacity for the cluster. For more information, see the _Storage_ section in the {product-title} service definition. | ||
| .. Specify the number of *Load balancers* that you require for your cluster. For more information, see the _Load balancers_ section in the {product-title} service definition. | ||
| .. Leave *Enable user workload monitoring* selected to monitor your own projects in isolation from Red Hat Site Reliability Engineer (SRE) platform metrics. This option is enabled by default. | ||
| .. Optional: Select *Enable additional etcd encryption* if you require etcd key value encryption. With this option, the etcd key values are encrypted, but not the keys. This option is in addition to the control plane storage encryption that encrypts the etcd volumes in {product-title} clusters by default. | ||
| + | ||
| [NOTE] | ||
| ==== | ||
| By enabling etcd encryption for the key values in etcd, you incur a performance overhead of approximately 20%. The overhead is a result of introducing this second layer of encryption, in addition to the default control plane storage encryption that encrypts the etcd volumes. Consider enabling etcd encryption only if you specifically require it for your use case. | ||
| ==== | ||
| .. Click *Next*. | ||
|
|
||
| . On the *Machine pool* page, select a *Compute node instance type* and a *Compute node count*. The number and types of nodes that are available depend on your {product-title} subscription. If you are using multiple availability zones, the compute node count is per zone. | ||
| + | ||
| [NOTE] | ||
| ==== | ||
| After your cluster is created, you can change the number of compute nodes, but you cannot change the compute node instance type in a created machine pool. You can add machine pools after installation that use a customized instance type. The number and types of nodes available to you depend on your {product-title} subscription. | ||
| ==== | ||
|
|
||
| . Optional: Expand *Edit node labels* to add labels to your nodes. Click *Add label* to add more node labels and select *Next*. | ||
|
|
||
| . In the *Cluster privacy* dialog, select *Public* or *Private* to use either public or private API endpoints and application routes for your cluster. | ||
|
|
||
| . Click *Next*. | ||
|
|
||
| . In the *CIDR ranges* dialog, configure custom classless inter-domain routing (CIDR) ranges or use the defaults that are provided. | ||
| + | ||
| [IMPORTANT] | ||
| ==== | ||
| CIDR configurations cannot be changed later. Confirm your selections with your network administrator before proceeding. | ||
|
|
||
| If the cluster privacy is set to *Private*, you cannot access your cluster until you configure private connections in your cloud provider. | ||
| ==== | ||
|
|
||
| . On the *Cluster update strategy* page, configure your update preferences: | ||
| .. Choose a cluster update method: | ||
| ** Select *Individual updates* if you want to schedule each update individually. This is the default option. | ||
| ** Select *Recurring updates* to update your cluster on your preferred day and start time, when updates are available. | ||
| + | ||
| [NOTE] | ||
| ==== | ||
| You can review the end-of-life dates in the update lifecycle documentation for {product-title}. For more information, see _{product-title} update lifecycle_. | ||
| ==== | ||
| + | ||
| .. Provide administrator approval based on your cluster update method: | ||
| ** Individual updates: If you select an update version that requires approval, provide an administrator’s acknowledgment and click *Approve and continue*. | ||
| ** Recurring updates: If you selected recurring updates for your cluster, provide an administrator’s acknowledgment and click *Approve and continue*. {cluster-manager} does not start scheduled y-stream updates for minor versions without receiving an administrator’s acknowledgment. | ||
| + | ||
| For information about administrator acknowledgment, see xref:./../upgrading/osd-upgrading-cluster-prepare.adoc#upgrade-49-acknowledgement_osd-updating-cluster-prepare[Administrator acknowledgment when upgrading to OpenShift 4.9]. | ||
| .. If you opted for recurring updates, select a preferred day of the week and upgrade start time in UTC from the drop-down menus. | ||
| .. Optional: You can set a grace period for *Node draining* during cluster upgrades. A *1 hour* grace period is set by default. | ||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Are there minimum and maximum grace period settings?
Contributor
Author
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Not sure as this was pulled from previously published docs. That being said, I plan on opening another ticket which addresses some of the possible issues that come up when these docs were looked at it again for this topic. Thx |
||
| .. Click *Next*. | ||
| + | ||
| [NOTE] | ||
| ==== | ||
| In the event of critical security concerns that significantly impact the security or stability of a cluster, Red Hat Site Reliability Engineering (SRE) might schedule automatic updates to the latest z-stream version that is not impacted. The updates are applied within 48 hours after customer notifications are provided. For a description of the critical impact security rating, see link:https://access.redhat.com/security/updates/classification[Understanding Red Hat security ratings]. | ||
| ==== | ||
|
|
||
| . Review the summary of your selections and click *Create cluster* to start the cluster installation. The installation takes approximately 30-40 minutes to complete. | ||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. It's great that you included the approximate time!!!
Contributor
Author
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Would love to take credit but this was pulled from previously used docs :) :( |
||
|
|
||
| .Verification | ||
|
|
||
| * You can monitor the progress of the installation in the *Overview* page for your cluster. You can view the installation logs on the same page. Your cluster is ready when the *Status* in the *Details* section of the page is listed as *Ready*. | ||
|
|
||
| ifeval::["{context}" == "osd-creating-a-cluster-on-aws"] | ||
| :!osd-on-aws: | ||
| endif::[] | ||
| ifeval::["{context}" == "osd-creating-a-cluster-on-gcp"] | ||
| :!osd-on-gcp: | ||
| endif::[] | ||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -3,12 +3,41 @@ | |
| // * osd_architecture/osd_policy/osd-service-definition.adoc | ||
| :_content-type: CONCEPT | ||
| [id="billing_{context}"] | ||
| = Billing | ||
| Each {product-title} cluster requires a minimum annual base cluster purchase and there are two billing options available for each cluster: Standard and Customer Cloud Subscription (CCS). | ||
| = Billing options | ||
|
|
||
| Standard {product-title} clusters are deployed in to their own cloud infrastructure accounts, each owned by Red Hat. Red Hat is responsible for this account, and cloud infrastructure costs are paid directly by Red Hat. The customer only pays the Red Hat subscription costs. | ||
| Customers have the option to purchase annual subscriptions of {product-title} (OSD) or consume on-demand through cloud marketplaces. Customers can decide to bring their own cloud infrastructure account, referred to as Customer Cloud Subscription (CCS), or deploy in cloud provider accounts owned by Red Hat. The table below provides additional information regarding billing, as well as the corresponding supported deployment options. | ||
| [cols="2a,3a,3a",options="header"] | ||
| |=== | ||
|
|
||
| In the CCS model, the customer pays the cloud infrastructure provider directly for cloud costs and the cloud infrastructure account is part of a customer’s Organization, with specific access granted to Red Hat. In this model, the customer pays Red Hat for the CCS subscription and pays the cloud provider for the cloud costs. It is the customer's responsibility to pre-purchase or provide Reserved Instance (RI) compute instances to ensure lower cloud infrastructure costs. | ||
| |OSD Subscription-type | ||
| |Cloud infrastructure account | ||
| |Billed through | ||
|
|
||
| .2+|Annual fixed capacity subscriptions through Red Hat |Red Hat cloud account | ||
|
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. I have no advice for this part but for the next two marketplace subscription type. From the design document, there are two kinds of subscription-types: Besides, do not see
Contributor
Author
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. @yasun1 - can you please clarify, what do you mean by -
I am little confused, because, Google Cloud Marketplace and Red Hat Marketplace cannot be at the same level as Annual. This is because, they are NOT annual and purely on-demand/consumption-based. Please let me know if I interpreted your comment incorrectly, We decided to add three different rows to highlight the difference in infrastructure type and how many/who bills the customer. There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Agree with you. So I was thinking that in the table, the first level is Now, I rethink again, the current tab structure could be accepted too. Thanks. There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Thanks @yasun1 |
||
|
|
||
| |Red Hat for consumption of both OSD subscriptions and cloud infrastructure | ||
|
|
||
| |Customer's own cloud account | ||
| |Red Hat for consumption of the OSD subscriptions | ||
|
|
||
| Cloud provider for consumption of cloud infrastructure | ||
|
|
||
| |On-demand usage-based consumption through Google Cloud Marketplace | ||
|
|
||
| |Customer's own Google Cloud account | ||
| |Google Cloud for both cloud infrastructure and Red Hat OSD subscriptions | ||
|
|
||
| |On-demand usage-based consumption through Red Hat Marketplace|Customer’s own cloud account| Red Hat for consumption of the OSD subscriptions | ||
|
|
||
| Cloud provider for consumption of cloud infrastructure | ||
|
|
||
| |=== | ||
|
|
||
| [IMPORTANT] | ||
| ==== | ||
| Customers that use their own cloud infrastructure account, referred to as Customer Cloud Subscription (CSS), are responsible to pre-purchase or provide Reserved Instance (RI) compute instances to ensure lower cloud infrastructure costs. | ||
| ==== | ||
|
|
||
| Additional resources can be purchased for an OpenShift Dedicated Cluster, including: | ||
|
|
||
|
|
||
Uh oh!
There was an error while loading. Please reload this page.