diff --git a/docs/cloud/reference/03_billing/02_marketplace/aws-marketplace-committed.md b/docs/cloud/reference/03_billing/02_marketplace/aws-marketplace-committed.md index 95cdfbeaba6..de3546cb79f 100644 --- a/docs/cloud/reference/03_billing/02_marketplace/aws-marketplace-committed.md +++ b/docs/cloud/reference/03_billing/02_marketplace/aws-marketplace-committed.md @@ -7,93 +7,90 @@ doc_type: 'guide' --- import Image from '@theme/IdealImage'; -import aws_marketplace_committed_1 from '@site/static/images/cloud/manage/billing/marketplace/aws-marketplace-committed-1.png'; -import aws_marketplace_payg_6 from '@site/static/images/cloud/manage/billing/marketplace/aws-marketplace-payg-6.png'; -import aws_marketplace_payg_7 from '@site/static/images/cloud/manage/billing/marketplace/aws-marketplace-payg-7.png'; -import aws_marketplace_payg_8 from '@site/static/images/cloud/manage/billing/marketplace/aws-marketplace-payg-8.png'; -import aws_marketplace_payg_9 from '@site/static/images/cloud/manage/billing/marketplace/aws-marketplace-payg-9.png'; -import aws_marketplace_payg_10 from '@site/static/images/cloud/manage/billing/marketplace/aws-marketplace-payg-10.png'; -import aws_marketplace_payg_11 from '@site/static/images/cloud/manage/billing/marketplace/aws-marketplace-payg-11.png'; -import aws_marketplace_payg_12 from '@site/static/images/cloud/manage/billing/marketplace/aws-marketplace-payg-12.png'; +import mp_committed_spend_1 from '@site/static/images/cloud/reference/mp_committed_spend_1.png' +import mp_committed_spend_2 from '@site/static/images/cloud/reference/mp_committed_spend_2.png' +import mp_committed_spend_3 from '@site/static/images/cloud/reference/mp_committed_spend_3.png' +import mp_committed_spend_4 from '@site/static/images/cloud/reference/mp_committed_spend_4.png' +import mp_committed_spend_5 from '@site/static/images/cloud/reference/mp_committed_spend_5.png' +import mp_committed_spend_6 from '@site/static/images/cloud/reference/mp_committed_spend_6.png' +import mp_committed_spend_7 from '@site/static/images/cloud/reference/mp_committed_spend_7.png' -Get started with ClickHouse Cloud on the [AWS Marketplace](https://aws.amazon.com/marketplace) via a committed contract. A committed contract, also known as a a Private Offer, allows customers to commit to spending a certain amount on ClickHouse Cloud over a period of time. +Get started with ClickHouse Cloud on the [AWS Marketplace](https://aws.amazon.com/marketplace) via a committed contract. +A committed contract, also known as a Private Offer, allows customers to commit to spending a certain amount on ClickHouse Cloud over a period of time. ## Prerequisites {#prerequisites} - A Private Offer from ClickHouse based on specific contract terms. - To connect a ClickHouse organization to your committed spend offer, you must be an admin of that organization. -[Required permissions to view and accept your committed contract in AWS](https://docs.aws.amazon.com/marketplace/latest/buyerguide/private-offers-page.html#private-offers-page-permissions): -- If you use AWS managed policies it is required to have the following permissions: `AWSMarketplaceRead-only`, `AWSMarketplaceManageSubscriptions`, or `AWSMarketplaceFullAccess`. -- If you aren't using AWS managed policies it is required to have the following permissions: IAM action `aws-marketplace:ListPrivateListings` and `aws-marketplace:ViewSubscriptions`. +:::note +One AWS account can only subscribe to one “ClickHouse Cloud - Committed Contract” private offer which can only be linked to one ClickHouse organization. +::: -## Steps to sign up {#steps-to-sign-up} - -1. You should have received an email with a link to review and accept your private offer. - -
+Required permissions to view and accept your committed contract in AWS: -AWS Marketplace private offer email +- If you use AWS managed policies, it is required to have the following permissions: + - `AWSMarketplaceRead-only`, `AWSMarketplaceManageSubscriptions` + - or `AWSMarketplaceFullAccess` +- If you aren't using AWS managed policies it is required to have the following permissions: + - IAM action `aws-marketplace:ListPrivateListings` and `aws-marketplace:ViewSubscriptions` -
+## Steps to sign up {#steps-to-sign-up} -2. Click on the **Review Offer** link in the email. This should take you to your AWS Marketplace page with the private offer details. While accepting the private offer, choose a value of 1 for the number of units in the Contract Options picklist. + -3. Complete the steps to subscribe on the AWS portal and click on **Set up your account**. -It is critical to redirect to ClickHouse Cloud at this point and either register for a new account, or sign in with an existing account. Without completing this step, we will not be able to link your AWS Marketplace subscription to ClickHouse Cloud. +### Accept your private offer {#private-offer-accept} -4. Once you redirect to ClickHouse Cloud, you can either login with an existing account, or register with a new account. This step is very important so we can bind your ClickHouse Cloud organization to the AWS Marketplace billing. +You should have received an email with a link to review and accept your private offer. -
+AWS Marketplace private offer email -ClickHouse Cloud sign in page +### Review offer link {#review-offer-link} -
+Click on the Review Offer link in the email. +This should take you to your AWS Marketplace page with the private offer details. -If you are a new ClickHouse Cloud user, click **Register** at the bottom of the page. You will be prompted to create a new user and verify the email. After verifying your email, you can leave the ClickHouse Cloud login page and login using the new username at the [https://console.clickhouse.cloud](https://console.clickhouse.cloud). +### Set up your account {#setup-your-account} -
+Complete the steps to subscribe on the AWS portal and click on **"Set up your account"**. +It is critical to redirect to ClickHouse Cloud at this point and either register for a new account, or sign in with an existing account. +Without completing this step, we will not be able to link your AWS Marketplace contract to ClickHouse Cloud. -ClickHouse Cloud sign up page +AWS Marketplace private offer email -
+### Login to Cloud {#login-cloud} -Note that if you are a new user, you will also need to provide some basic information about your business. See the screenshots below. +Once you redirect to ClickHouse Cloud, you can either login with an existing account, or register with a new account. +This step is necessary so that we can bind your ClickHouse Cloud organization to AWS Marketplace billing. -
+AWS Marketplace private offer email -ClickHouse Cloud sign up info form +### Register if new {#register} -
+If you are a new ClickHouse Cloud user, click "Register" at the bottom of the page. +You will be prompted to create a new user and verify the email. +After verifying your email, you can leave the ClickHouse Cloud login page and login using the new username at [https://console.clickhouse.cloud](https://console.clickhouse.cloud). -
+Note that if you are a new user, you will also need to provide some basic information about your business. +See the screenshots below. -ClickHouse Cloud sign up info form 2 +Provide business information -
+Provide business information If you are an existing ClickHouse Cloud user, simply log in using your credentials. -5. After successfully logging in, a new ClickHouse Cloud organization will be created. This organization will be connected to your AWS billing account and all usage will be billed via your AWS account. - -6. Once you login, you can confirm that your billing is in fact tied to the AWS Marketplace and start setting up your ClickHouse Cloud resources. - -
- -ClickHouse Cloud view AWS Marketplace billing - -
- -ClickHouse Cloud new services page +### Create or select organization to bill {#create-select-org-to-bill} -
+After successfully logging in, you can decide whether to create a new organization to bill to this marketplace contract or choose an existing organization to bill to this contract. -6. You should receive an email confirming the sign up: +Create or select an organization to bill to this subscription -
+After completing this step your organization will be connected to your AWS committed spend contract and all usage will be billed via your AWS account. +You can confirm from the organization's billing page in the ClickHouse UI that billing is indeed now linked to the AWS marketplace. -AWS Marketplace confirmation email +Confirm set up is complete -
+If you run into any issues, please do not hesitate to contact our [support team](https://clickhouse.com/support/program). -If you run into any issues, please do not hesitate to contact [our support team](https://clickhouse.com/support/program). + diff --git a/static/images/cloud/reference/mp_committed_spend_1.png b/static/images/cloud/reference/mp_committed_spend_1.png new file mode 100644 index 00000000000..2426b7e2418 Binary files /dev/null and b/static/images/cloud/reference/mp_committed_spend_1.png differ diff --git a/static/images/cloud/reference/mp_committed_spend_2.png b/static/images/cloud/reference/mp_committed_spend_2.png new file mode 100644 index 00000000000..0dd65aaa095 Binary files /dev/null and b/static/images/cloud/reference/mp_committed_spend_2.png differ diff --git a/static/images/cloud/reference/mp_committed_spend_3.png b/static/images/cloud/reference/mp_committed_spend_3.png new file mode 100644 index 00000000000..b607c2047c4 Binary files /dev/null and b/static/images/cloud/reference/mp_committed_spend_3.png differ diff --git a/static/images/cloud/reference/mp_committed_spend_4.png b/static/images/cloud/reference/mp_committed_spend_4.png new file mode 100644 index 00000000000..8db756f4b28 Binary files /dev/null and b/static/images/cloud/reference/mp_committed_spend_4.png differ diff --git a/static/images/cloud/reference/mp_committed_spend_5.png b/static/images/cloud/reference/mp_committed_spend_5.png new file mode 100644 index 00000000000..9f8aedd3425 Binary files /dev/null and b/static/images/cloud/reference/mp_committed_spend_5.png differ diff --git a/static/images/cloud/reference/mp_committed_spend_6.png b/static/images/cloud/reference/mp_committed_spend_6.png new file mode 100644 index 00000000000..ea7f211908c Binary files /dev/null and b/static/images/cloud/reference/mp_committed_spend_6.png differ diff --git a/static/images/cloud/reference/mp_committed_spend_7.png b/static/images/cloud/reference/mp_committed_spend_7.png new file mode 100644 index 00000000000..4227b16800f Binary files /dev/null and b/static/images/cloud/reference/mp_committed_spend_7.png differ