This page will cover the steps required by your GCP admins to prepare a GCP project that is ready for your Glean build.
Glean provides our customers the ability to deploy Glean software inside their own Google Cloud Platform (GCP) project. This deployment requires your GCP admin to:
After completing the above, Glean’s systems will automatically build and deploy the required compute, workflows, and software into your GCP project.
At this stage, Glean will advise you that your tenant is ready, allowing your admins to proceed with the setup process, such as configuring Single Sign-On (SSO) and connecting your data sources.
To ensure our customers enjoy the highest quality of machine learning performance, reduced latency, and adherence to regional data residency laws, Glean advises deploying our services in one of the following recommended GCP regions:
These regions are equipped with Tensor Processing Units (TPUs), which are specifically designed to accelerate machine learning tasks. Additionally, selecting these regions can lead to cost savings and help maintain compliance with various regulations.
While Glean does support additional GCP regions, it’s important to be aware that these alternative locations utilize Graphics Processing Units (GPUs) rather than TPUs for machine learning workloads. Utilizing GPUs for these workloads means that they will take longer to complete; increasing the cost of running the workflows. Additionally, depending on the region, only a limited range of GPU models may be available, some of which will result in a lower-quality output. As such, we strongly recommend hosting your Glean projects within the preferred regions listed above to achieve the best balance of performance and cost-efficiency.
Should you need more information or assistance in determining the most suitable GCP region for your Glean deployment, please don’t hesitate to reach out to your dedicated Glean engineer.
Enable the following APIs by going to the link and clicking Enable API:
Per the Glean setup, Glean will check quota requirements and will make quota change requests as needed. Customers will be alerted when quota requests need approval. All of the quota needs are listed in this spreadsheet. Please note that some quota requests will require filing a ticket with GCP support. They usually respond within 2 days at the latest.
The quotas you will request will differ depending on the size of the Glean tenant that will be built:
Use Case | Deployment Size |
---|---|
Sandbox / UAT environments / < 1M docs | Small Deployment |
< 50M documents to be indexed | Medium Deployment |
> 50M documents to be indexed | Large Deployment |
If you are not sure how to proceed, please consult with your Glean engineer.
Note: Quota requests for some resources for a Large Deployment may fail depending on the GCP region you have selected due to the compute types available. If this is the case, please work with your Glean engineer, who can advise you further.
Go to the Service Accounts page in the GCP console and click Select a Project.
Note: A service account that is generated with an owner role for a specific project in GCP is limited to the resources and services within that specific project. It does not have permission to access or modify resources outside of that project, even if it’s within the same GCP tenant. The owner role grants full access to all resources in the project where it is assigned, but it does not extend to other projects in the GCP tenant.
After a confirmation from Glean that you are set up in the setup portal, browse to https://app.glean.com/admin and enter your email address to generate and send a magic link to your email. The first screen is an admin setup screen. Either add additional admins or skip to the next step.
Follow the on-screen instructions (The instruction is also provided below as a preview)
Upload your JSON key into the Glean portal. The portal will validate the key and provide correctional instruction, which includes quota updates (step 9) and organizational constraints if you have that in the parent organization.
If the validation passes, then Glean is ready to deploy to your GCP environment! 🎉
If the validation fails, the error message will indicate the issue.
Typically this is due to:
Please correct the issues indicated before attempting validation again. If you are unsure of anything, please contact your Glean engineer, who will assist you.
This page will cover the steps required by your GCP admins to prepare a GCP project that is ready for your Glean build.
Glean provides our customers the ability to deploy Glean software inside their own Google Cloud Platform (GCP) project. This deployment requires your GCP admin to:
After completing the above, Glean’s systems will automatically build and deploy the required compute, workflows, and software into your GCP project.
At this stage, Glean will advise you that your tenant is ready, allowing your admins to proceed with the setup process, such as configuring Single Sign-On (SSO) and connecting your data sources.
To ensure our customers enjoy the highest quality of machine learning performance, reduced latency, and adherence to regional data residency laws, Glean advises deploying our services in one of the following recommended GCP regions:
These regions are equipped with Tensor Processing Units (TPUs), which are specifically designed to accelerate machine learning tasks. Additionally, selecting these regions can lead to cost savings and help maintain compliance with various regulations.
While Glean does support additional GCP regions, it’s important to be aware that these alternative locations utilize Graphics Processing Units (GPUs) rather than TPUs for machine learning workloads. Utilizing GPUs for these workloads means that they will take longer to complete; increasing the cost of running the workflows. Additionally, depending on the region, only a limited range of GPU models may be available, some of which will result in a lower-quality output. As such, we strongly recommend hosting your Glean projects within the preferred regions listed above to achieve the best balance of performance and cost-efficiency.
Should you need more information or assistance in determining the most suitable GCP region for your Glean deployment, please don’t hesitate to reach out to your dedicated Glean engineer.
Enable the following APIs by going to the link and clicking Enable API:
Per the Glean setup, Glean will check quota requirements and will make quota change requests as needed. Customers will be alerted when quota requests need approval. All of the quota needs are listed in this spreadsheet. Please note that some quota requests will require filing a ticket with GCP support. They usually respond within 2 days at the latest.
The quotas you will request will differ depending on the size of the Glean tenant that will be built:
Use Case | Deployment Size |
---|---|
Sandbox / UAT environments / < 1M docs | Small Deployment |
< 50M documents to be indexed | Medium Deployment |
> 50M documents to be indexed | Large Deployment |
If you are not sure how to proceed, please consult with your Glean engineer.
Note: Quota requests for some resources for a Large Deployment may fail depending on the GCP region you have selected due to the compute types available. If this is the case, please work with your Glean engineer, who can advise you further.
Go to the Service Accounts page in the GCP console and click Select a Project.
Note: A service account that is generated with an owner role for a specific project in GCP is limited to the resources and services within that specific project. It does not have permission to access or modify resources outside of that project, even if it’s within the same GCP tenant. The owner role grants full access to all resources in the project where it is assigned, but it does not extend to other projects in the GCP tenant.
After a confirmation from Glean that you are set up in the setup portal, browse to https://app.glean.com/admin and enter your email address to generate and send a magic link to your email. The first screen is an admin setup screen. Either add additional admins or skip to the next step.
Follow the on-screen instructions (The instruction is also provided below as a preview)
Upload your JSON key into the Glean portal. The portal will validate the key and provide correctional instruction, which includes quota updates (step 9) and organizational constraints if you have that in the parent organization.
If the validation passes, then Glean is ready to deploy to your GCP environment! 🎉
If the validation fails, the error message will indicate the issue.
Typically this is due to:
Please correct the issues indicated before attempting validation again. If you are unsure of anything, please contact your Glean engineer, who will assist you.