Skip to content

Multi-cluster and multi-cloud

When configuring your data plane, you can map each domain or project to its own GCP project or AWS subaccount. You can even mix cloud providers: Some of your domains and/or projects can be mapped to AWS subaccounts while others can be mapped to GCP projects.

  • If you choose domain isolation, then you would have one GCP project or AWS subaccount each for each domain. For example:
DomainGCP project or AWS subaccount
developmentgcp-project-union-development
staginggcp-project-union-staging
productionaws-subaccount-union-production
  • If you choose project isolation, then you would have one GCP project or AWS subaccount for each Union project-domain pair. For example:
Domain/ProjectGCP Project or AWS Subaccount
development/project-1gcp-project-union-development-project-1
development/project-2gcp-project-union-development-project-2
development/project-3gcp-project-union-development-project-3
staging/project-1gcp-project-union-staging-project-1
staging/project-2gcp-project-union-staging-project-1
staging/project-3gcp-project-union-staging-project-1
production/project-1aws-subaccount-union-production-project-1
production/project-2aws-subaccount-union-production-project-1
production/project-3aws-subaccount-union-production-project-1

The precise set of GCP projects and/or AWS subaccounts depends on the number of Union domains and projects that you have.

Limitations of project per GCP project/AWS subaccount

Note that if you choose to map each Union project to its own GCP project/AWS subaccount, you will need to define the set of such projects up front. This is because the Union project will have to be created when the GCP project/AWS subaccount is set up.

If you also want the ability to create projects on demand, this can be supported by having an additional default GCP project/AWS subaccount. Any projects created after onboarding will be created in that default GCP project/AWS subaccount.

Data and metadata isolation

Each domain or project is isolated within its own AWS account or Google project, and therefore provides the level of compute and data isolation intrinsic to that arrangement. Specifically, execution-time isolation per domain or project is maintained for both compute and user data stored in blob store (or other configured storage).

In addition, metadata specific to the internals of Union can be either isolated or shared across clusters, depending on the configuration you choose.

Specifically, the sharing of metadata is controlled by the cluster pool to which a cluster belongs. If two clusters are in the same cluster pool, then they must share the same metadata bucket. If they are in different cluster pools, then they must have different metadata buckets. You could, for example, have a single metadata bucket for all your development clusters, and a separate one for all your production clusters, by grouping the clusters into cluster pools accordingly. Alternatively you could have a separate metadata bucket for each cluster, by putting each cluster in its own cluster pool.

You specify the cluster pool to which a cluster belongs when you configure your data plane with the help of the Union team.