mirror of
https://github.com/hasura/graphql-engine.git
synced 2024-09-11 10:46:25 +03:00
docs: improve documentation for Hasura Enterprise
PR-URL: https://github.com/hasura/graphql-engine-mono/pull/8902 GitOrigin-RevId: 708d90f07a866891411d9e99799367880b4e9b1b
This commit is contained in:
parent
107db24caf
commit
a3b5cfc8d4
@ -65,7 +65,7 @@ installation manifests required to deploy Hasura anywhere. Get the ECS task defi
|
||||
wget https://raw.githubusercontent.com/hasura/graphql-engine/stable/install-manifests/enterprise/aws-ecs/hasura-fargate-task.json
|
||||
```
|
||||
|
||||
### Step 3: Set the license key, Metadata database URL, Redis database URL and the admin secret
|
||||
### Step 3: Set the Metadata database URL, Redis database URL and the admin secret
|
||||
|
||||
Edit `hasura-fargate-task.json` and set the right values:
|
||||
|
||||
@ -124,20 +124,17 @@ Examples of `HASURA_GRAPHQL_REDIS_URL` and `HASURA_GRAPHQL_RATE_LIMIT_REDIS_URL`
|
||||
|
||||
:::
|
||||
|
||||
### Step 4 (optional): Set the Enterprise Edition license key
|
||||
|
||||
If you have been provided a license key by Hasura Sales, add this as an environment variable.
|
||||
### Step 4: Set up a license key
|
||||
|
||||
Edit `hasura-fargate-task.json` and add the license key value:
|
||||
If you don't have a license key, you can skip this step and proceed with this guide to set up Hasura. Once you have the Hasura up and running, you can sign up for a [free 30 day Enterprise Edition trial](/enterprise/try-hasura-enterprise-edition.mdx) from the Hasura console.
|
||||
|
||||
```json {6}
|
||||
If you have been provided a license key by the Hasura team, add it as an environment variable to Hasura. Edit `hasura-fargate-task.json` and set the license key as the value for HASURA_GRAPHQL_EE_LICENSE_KEY environment variable.
|
||||
|
||||
```json {20-23}
|
||||
---
|
||||
{
|
||||
"environment": [
|
||||
{
|
||||
"name": "HASURA_GRAPHQL_EE_LICENSE_KEY",
|
||||
"value": "<license key>"
|
||||
},
|
||||
{
|
||||
"name": "HASURA_GRAPHQL_METADATA_DATABASE_URL",
|
||||
"value": "postgres://<username>:<password>@hostname:<port>/<dbname>"
|
||||
@ -153,14 +150,15 @@ Edit `hasura-fargate-task.json` and add the license key value:
|
||||
{
|
||||
"name": "HASURA_GRAPHQL_ADMIN_SECRET",
|
||||
"value": "myadminsecretkey"
|
||||
},
|
||||
{
|
||||
"name": "HASURA_GRAPHQL_EE_LICENSE_KEY",
|
||||
"value": "<license key>"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
This is not a required step. You can also enable Enterprise Edition features just by registering for
|
||||
[Enterprise Edition Trial](/enterprise/try-hasura-enterprise-edition.mdx) in the Hasura Console.
|
||||
|
||||
### Step 5: Register the Task Definition
|
||||
|
||||
```bash
|
||||
|
@ -51,10 +51,11 @@ admin secret key.
|
||||
|
||||
Edit the downloaded `docker-compose.yml` and set the admin secret as an environment variable.
|
||||
|
||||
```yaml {4-5}
|
||||
```yaml {5}
|
||||
graphql-engine:
|
||||
image: hasura/graphql-engine:v2.12.0
|
||||
environment:
|
||||
HASURA_GRAPHQL_METADATA_DATABASE_URL: postgres://postgres:postgrespassword@postgres:5432/postgres
|
||||
HASURA_GRAPHQL_ADMIN_SECRET: myadminsecretkey
|
||||
...
|
||||
```
|
||||
@ -67,22 +68,22 @@ information on setting up authentication.
|
||||
|
||||
:::
|
||||
|
||||
### Step 3 (optional): Set Enterprise Edition License Key
|
||||
### Step 3: Set up a license key
|
||||
|
||||
If you have been provided a license key by Hasura Sales, add this as an environment variable.
|
||||
If you don't have a license key, you can skip this step and proceed with this guide to set up Hasura. Once you have Hasura up and running, you can sign up for a [free 30 day Enterprise Edition trial](/enterprise/try-hasura-enterprise-edition.mdx) from the Hasura console.
|
||||
|
||||
```yaml {4}
|
||||
If you have been provided a license key by the Hasura team, add it as an environment variable to Hasura. Edit the `docker-compose.yaml` to set the license key as the value for the `HASURA_GRAPHQL_EE_LICENSE_KEY` environment variable.
|
||||
|
||||
```yaml {6}
|
||||
graphql-engine:
|
||||
image: hasura/graphql-engine:v2.12.0
|
||||
environment:
|
||||
HASURA_GRAPHQL_EE_LICENSE_KEY: "<license key>"
|
||||
HASURA_GRAPHQL_METADATA_DATABASE_URL: postgres://postgres:postgrespassword@postgres:5432/postgres
|
||||
HASURA_GRAPHQL_ADMIN_SECRET: myadminsecretkey
|
||||
HASURA_GRAPHQL_EE_LICENSE_KEY: '<license key>'
|
||||
...
|
||||
```
|
||||
|
||||
This is not a required step. You can also enable Enterprise Edition features just by registering for
|
||||
[Enterprise Edition Trial](/enterprise/try-hasura-enterprise-edition.mdx) in the Hasura Console.
|
||||
|
||||
### Step 4: Run Hasura GraphQL Engine
|
||||
|
||||
The following command will run Hasura GraphQL Engine along with a Postgres database to store its metadata.
|
||||
|
@ -86,21 +86,20 @@ Examples of `HASURA_GRAPHQL_REDIS_URL` and `HASURA_GRAPHQL_RATE_LIMIT_REDIS_URL`
|
||||
|
||||
:::
|
||||
|
||||
### Step 3 (optional): Set the license key
|
||||
### Step 3: Set up a license key
|
||||
|
||||
Edit `env.yaml` and add the license key value:
|
||||
If you don't have a license key, you can skip this step and proceed with this guide to set up Hasura. Once you have Hasura up and running, you can sign up for a [free 30 day Enterprise Edition trial](/enterprise/try-hasura-enterprise-edition.mdx) from the Hasura console.
|
||||
|
||||
```yaml {1}
|
||||
HASURA_GRAPHQL_EE_LICENSE_KEY: '<license key>'
|
||||
If you have been provided a license key by the Hasura team, add it as an environment variable to Hasura. Edit `env.yaml` to set the license key as the value for the `HASURA_GRAPHQL_EE_LICENSE_KEY` environment variable.
|
||||
|
||||
```yaml {5}
|
||||
HASURA_GRAPHQL_METADATA_DATABASE_URL: postgres://postgres:postgrespassword@postgres:5432/postgres
|
||||
HASURA_GRAPHQL_REDIS_URL: 'redis://redis:6379'
|
||||
HASURA_GRAPHQL_RATE_LIMIT_REDIS_URL: 'redis://redis:6379'
|
||||
HASURA_GRAPHQL_ADMIN_SECRET: myadminsecretkey
|
||||
HASURA_GRAPHQL_EE_LICENSE_KEY: '<license key>'
|
||||
```
|
||||
|
||||
This is not a required step. You can also enable Enterprise Edition features just by registering for
|
||||
[Enterprise Edition Trial](/enterprise/try-hasura-enterprise-edition.mdx) in the Hasura Console.
|
||||
|
||||
### Step 4: Copy the Hasura graphql-engine image to the GCR registry
|
||||
|
||||
Cloud Run does not allow using images from Dockerhub. Due to this limitation it's necessary to pull the Hasura
|
||||
|
@ -91,17 +91,15 @@ Examples of `HASURA_GRAPHQL_REDIS_URL` and `HASURA_GRAPHQL_RATE_LIMIT_REDIS_URL`
|
||||
|
||||
:::
|
||||
|
||||
### Step 3 (optional): Set the Enterprise Edition license key
|
||||
### Step 3: Set up a license key
|
||||
|
||||
If you have been provided a license key by Hasura Sales, add this as an environment variable.
|
||||
If you don't have a license key, you can skip this step and proceed with this guide to set up Hasura. Once you have the Hasura up and running, you can sign up for a [free 30 day Enterprise Edition trial](/enterprise/try-hasura-enterprise-edition.mdx) from the Hasura console.
|
||||
|
||||
Edit `deployment.yaml` and add the license key value:
|
||||
If you have been provided a license key by the Hasura team, add it as an environment variable to Hasura. Edit `deployment.yaml` and set the license key as the value for the `HASURA_GRAPHQL_EE_LICENSE_KEY` environment variable.
|
||||
|
||||
```yaml {4}
|
||||
```yaml {11,12}
|
||||
---
|
||||
env:
|
||||
- name: HASURA_GRAPHQL_EE_LICENSE_KEY
|
||||
value: '<license key>'
|
||||
- name: HASURA_GRAPHQL_METADATA_DATABASE_URL
|
||||
value: postgres://<username>:<password>@hostname:<port>/<dbname>
|
||||
- name: HASURA_GRAPHQL_REDIS_URL
|
||||
@ -110,11 +108,10 @@ env:
|
||||
value: redis://redis:6379
|
||||
- name: HASURA_GRAPHQL_ADMIN_SECRET
|
||||
value: adminsecret
|
||||
- name: HASURA_GRAPHQL_EE_LICENSE_KEY
|
||||
value: '<license key>'
|
||||
```
|
||||
|
||||
This is not a required step. You can also enable Enterprise Edition features just by registering for
|
||||
[Enterprise Edition Trial](/enterprise/try-hasura-enterprise-edition.mdx) in the Hasura Console.
|
||||
|
||||
### Step 4: Create the Kubernetes deployment and service
|
||||
|
||||
```bash
|
||||
|
@ -42,6 +42,8 @@ help you successfully evaluate Hasura Enterprise for your use case.
|
||||
|
||||
- Supported in `v2.23.0` onwards.
|
||||
|
||||
- Your Hasura instance must be connected to the internet to use the Hasura Enterprise Edition Trial. If you are running Hasura in an airgap environment, please [contact Hasura Sales](mailto:sales@hasura.io) to get a license key for trying Hasura Enterprise.
|
||||
|
||||
:::
|
||||
|
||||
## Activate your Enterprise Edition Trial
|
||||
@ -49,15 +51,13 @@ help you successfully evaluate Hasura Enterprise for your use case.
|
||||
### Step 1. Run Hasura
|
||||
|
||||
You can run Hasura instances in a container environment of your choice. Please follow this
|
||||
[Getting Started](/getting-started/docker-simple.mdx) guide, which describes how to install Hasura GraphQL Engine using
|
||||
[guide for getting started](getting-started/quickstart-docker.mdx), which describes how to install Hasura GraphQL Engine using
|
||||
Docker.
|
||||
|
||||
:::tip Already running Hasura in a Docker container?
|
||||
|
||||
If you are already running Hasura inside a Docker container with open-source features, then you just need to change the
|
||||
Docker container tag to `v2.23.0` or above and then redeploy the container.
|
||||
|
||||
:::
|
||||
> Please make sure that your `docker-compose.yaml` does not have the `HASURA_GRAPHQL_EE_LICENSE_KEY` environment variable set. If you already have a license key, you can try Hasura Enterprise directly by following instructions [here](upgrade-ce-to-ee.mdx).
|
||||
|
||||
### Step 2. Register for your 30-day free Trial
|
||||
|
||||
|
@ -17,31 +17,27 @@ import ProductBadge from '@site/src/components/ProductBadge';
|
||||
|
||||
## Overview
|
||||
|
||||
Starting from Hasura GraphQL Engine version `v2.12.0`, we have included both open-source and commercial components in
|
||||
the `hasura/graphql-engine` container image. The open-source portions are licensed under the [Apache License, Version 2.0](https://www.apache.org/licenses/LICENSE-2.0). The proprietary components include features for Hasura Enterprise and they can be enabled through a free trial or with a license key provided by the Hasura team.
|
||||
|
||||
:::info Note
|
||||
|
||||
There's now a much quicker and self-serve manner to enable Enterprise Edition features using
|
||||
[Enterprise Edition Trials](/enterprise/try-hasura-enterprise-edition.mdx).
|
||||
|
||||
The documentation below still applies for Hasura versions before `v2.23.0`
|
||||
|
||||
:::
|
||||
|
||||
Starting from Hasura GraphQL Engine version `v2.12.0`, we have included both open-source and commercial components in
|
||||
the `hasura/graphql-engine` container image.
|
||||
|
||||
The `hasura/graphql-engine` image includes both open-source and proprietary components. The open-source portions are
|
||||
licensed under the [Apache License, Version 2.0](https://www.apache.org/licenses/LICENSE-2.0). The proprietary
|
||||
components include features for Hasura Enterprise and are enabled with a license key provided by Hasura. If you would
|
||||
If you would
|
||||
like to use an image with only the open source components, please use Docker images on
|
||||
[this page](https://hub.docker.com/r/hasura/graphql-engine/tags?page=1&name=-ce) that contain `-ce`. (example:
|
||||
`hasura/graphql-engine:<VERSION>-ce`)
|
||||
:::
|
||||
|
||||
If you are already running Hasura CE and would like to upgrade to Hasura Enterprise, please follow these instructions:
|
||||
|
||||
1. [Please contact Hasura Sales](mailto:sales@hasura.io) to obtain a license key.
|
||||
2. Create an environment variable called `HASURA_GRAPHQL_EE_LICENSE_KEY` in your container platform environment and set
|
||||
it to the license key from the previous step.
|
||||
#### Hasura Enterprise trial
|
||||
|
||||
E.g. if the license key sent by Sales is `ABC1234`, you will set `HASURA_GRAPHQL_EE_LICENSE_KEY=”ABC1234”`.
|
||||
If you're running Hasura version `v2.23.0` or greater, you can instantly try Hasura Enterprise on your existing Hasura setup by signing up for a [free 30-day Hasura Enterprise trial](/enterprise/try-hasura-enterprise-edition.mdx).
|
||||
|
||||
#### Hasura Enterprise Edition license key
|
||||
|
||||
If you have been provided a license key by the Hasura team, set it as the value for the `HASURA_GRAPHQL_EE_LICENSE_KEY` environment variable in your Hasura container.
|
||||
|
||||
E.g. if the license key sent by the Hasura team is `ABC1234`, you will set `HASURA_GRAPHQL_EE_LICENSE_KEY=”ABC1234”`.
|
||||
|
||||
Restart Hasura to start using the enteprise features.
|
||||
|
||||
3. Restart Hasura.
|
||||
|
Loading…
Reference in New Issue
Block a user