Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -7,93 +7,90 @@
---

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.

<br />
Required permissions to view and accept your committed contract in AWS:

<Image img={aws_marketplace_committed_1} size="md" alt="AWS Marketplace private offer email" border/>
- 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`

<br />
## 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.
<VerticalStepper headerLevel="h3">

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.

<br />
<Image img={mp_committed_spend_1} size="md" alt="AWS Marketplace private offer email"/>

<Image img={aws_marketplace_payg_6} size="md" alt="ClickHouse Cloud sign in page" border/>
### Review offer link {#review-offer-link}

<br />
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}

<br />
Complete the steps to subscribe on the AWS portal and click on **"Set up your account"**.

Check warning on line 55 in docs/cloud/reference/03_billing/02_marketplace/aws-marketplace-committed.md

View workflow job for this annotation

GitHub Actions / vale

ClickHouse.Quotes

Commas and periods go inside quotation marks.
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.

<Image img={aws_marketplace_payg_7} size="md" alt="ClickHouse Cloud sign up page" border/>
<Image img={mp_committed_spend_2} size="md" alt="AWS Marketplace private offer email"/>

<br />
### 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.

<br />
<Image img={mp_committed_spend_3} size="md" alt="AWS Marketplace private offer email"/>

<Image img={aws_marketplace_payg_8} size="md" alt="ClickHouse Cloud sign up info form" border/>
### Register if new {#register}

<br />
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).

<br />
Note that if you are a new user, you will also need to provide some basic information about your business.

Check warning on line 74 in docs/cloud/reference/03_billing/02_marketplace/aws-marketplace-committed.md

View workflow job for this annotation

GitHub Actions / vale

ClickHouse.FutureTense

Instead of future tense 'will also', use present tense.
See the screenshots below.

<Image img={aws_marketplace_payg_9} size="md" alt="ClickHouse Cloud sign up info form 2" border/>
<Image img={mp_committed_spend_4} size="md" alt="Provide business information"/>

<br />
<Image img={mp_committed_spend_5} size="md" alt="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.

<br />

<Image img={aws_marketplace_payg_10} size="md" alt="ClickHouse Cloud view AWS Marketplace billing" border/>

<br />

<Image img={aws_marketplace_payg_11} size="md" alt="ClickHouse Cloud new services page" border/>
### Create or select organization to bill {#create-select-org-to-bill}

<br />
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:
<Image img={mp_committed_spend_6} size="md" alt="Create or select an organization to bill to this subscription"/>

<br />
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.

Check warning on line 89 in docs/cloud/reference/03_billing/02_marketplace/aws-marketplace-committed.md

View workflow job for this annotation

GitHub Actions / vale

ClickHouse.FutureTense

Instead of future tense 'will be', use present tense.

Check warning on line 89 in docs/cloud/reference/03_billing/02_marketplace/aws-marketplace-committed.md

View workflow job for this annotation

GitHub Actions / vale

ClickHouse.FutureTense

Instead of future tense 'will be', use present tense.
You can confirm from the organization's billing page in the ClickHouse UI that billing is indeed now linked to the AWS marketplace.

<Image img={aws_marketplace_payg_12} size="md" alt="AWS Marketplace confirmation email" border/>
<Image img={mp_committed_spend_7} size="md" alt="Confirm set up is complete"/>

<br />
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).
</VerticalStepper>
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading