Skip to content

Cellular Multi-Tenancy Deployment Guide¶

This guide shows how to configure Cellular Multi-Tenancy for Provider Hosted, BYOC Anywhere, and Air-Gapped deployments.

Provider Hosted¶

For Compose-based SaaS Products, set OMNISTRATE_MULTI_TENANCY and configure the provider account with hostedDeployment:

x-omnistrate-service-plan:
  name: 'Cellular Multi-Tenant SaaS'
  tenancyType: 'OMNISTRATE_MULTI_TENANCY'
  deployment:
    hostedDeployment:
      awsAccountId: '<AWS_ACCOUNT_ID>'
      awsBootstrapRoleAccountArn: 'arn:aws:iam::<AWS_ACCOUNT_ID>:role/omnistrate-bootstrap-role'

Configure resource requests and limits so Omnistrate can bin-pack customer deployments safely. For placement controls, see Deployment Cells and Custom Deployment Cell Placement.

BYOC Anywhere¶

For Compose services, replace hostedDeployment with byoaDeployment and onboard each customer account:

deployment:
  byoaDeployment:
    awsAccountId: '<AWS_ACCOUNT_ID>'
    awsBootstrapRoleAccountArn: 'arn:aws:iam::<AWS_ACCOUNT_ID>:role/omnistrate-bootstrap-role'

Use the same shared tenancy design across customer accounts, then follow BYOC Deployment for account onboarding and instance deployment.

What's Next¶