From be7046e7e525781f6e44b77907e11f337cb200bd Mon Sep 17 00:00:00 2001 From: defangdevs Date: Tue, 8 Sep 2026 09:27:09 -0700 Subject: [PATCH] docs: note managed Postgres/Redis region availability per cloud AWS (RDS/ElastiCache) and GCP (Cloud SQL/Memorystore) ship these services to essentially every region, but Azure Database for PostgreSQL and Azure Managed Redis roll out region-by-region, and the VM SKU Defang picks can still hit regional capacity limits even where the service itself is available. Point readers at the live Azure "Products available by region" page instead of a static list that would go stale. Fixes #423 --- docs/concepts/managed-storage/managed-postgres.mdx | 2 ++ docs/concepts/managed-storage/managed-redis.md | 2 ++ docs/providers/aws.md | 4 ++++ docs/providers/azure.md | 6 ++++++ docs/providers/gcp.md | 4 ++++ 5 files changed, 18 insertions(+) diff --git a/docs/concepts/managed-storage/managed-postgres.mdx b/docs/concepts/managed-storage/managed-postgres.mdx index 43bbcd0a36..9b592255a6 100644 --- a/docs/concepts/managed-storage/managed-postgres.mdx +++ b/docs/concepts/managed-storage/managed-postgres.mdx @@ -16,6 +16,8 @@ Postgres, or PostgreSQL, is a powerful open-source relational database system kn | [DigitalOcean](/docs/providers/digitalocean#future-improvements) | ⚠️ Unmanaged | | [GCP](/docs/providers/gcp#managed-storage) | ✅ Cloud SQL Postgres | +Managed Postgres is available in all AWS and GCP regions. On Azure, availability varies by region — see [Managed Postgres and Redis region availability](/docs/providers/azure#managed-postgres-and-redis-region-availability) before choosing an `AZURE_LOCATION`. + ## How to use Managed Postgres To use managed Postgres, in your `compose.yaml` file, use the `x-defang-postgres` extension to define your Postgres service. Adding the extension will tell Defang to provision a managed instance, rather than running Postgres as a service. diff --git a/docs/concepts/managed-storage/managed-redis.md b/docs/concepts/managed-storage/managed-redis.md index 9c6141d3b0..7d0fe5b6df 100644 --- a/docs/concepts/managed-storage/managed-redis.md +++ b/docs/concepts/managed-storage/managed-redis.md @@ -16,6 +16,8 @@ Redis is an in-memory data structure store widely used for caching, real-time an | [DigitalOcean](/docs/providers/digitalocean#future-improvements) | ⚠️ Unmanaged | | [GCP](/docs/providers/gcp#managed-redis) | ✅ Memorystore | +Managed Redis is available in all AWS and GCP regions. On Azure, availability varies by region — see [Managed Postgres and Redis region availability](/docs/providers/azure#managed-postgres-and-redis-region-availability) before choosing an `AZURE_LOCATION`. + ## How to use Managed Redis To use managed Redis, in your `compose.yaml` file, use the `x-defang-redis` extension to define your Redis service. Adding the extension will tell Defang to provision a managed instance, rather than running Redis as a service. diff --git a/docs/providers/aws.md b/docs/providers/aws.md index 0ea04e922c..accfe0e360 100644 --- a/docs/providers/aws.md +++ b/docs/providers/aws.md @@ -75,10 +75,14 @@ Defang can help you provision [managed storage](/docs/concepts/managed-storage/m When using [Managed Postgres](/docs/concepts/managed-storage/managed-postgres.mdx), the Defang CLI provisions an RDS Postgres instance in your account. +Amazon RDS is included in every AWS Region launch, so there's no region planning needed for managed Postgres. + ### Managed Redis When using [Managed Redis](/docs/concepts/managed-storage/managed-redis.md), the Defang CLI provisions an ElastiCache Redis cluster in your account. +Amazon ElastiCache is included in every AWS Region launch, so there's no region planning needed for managed Redis. + ### Managed LLMs Defang offers integration with managed, cloud-native large language model services with the `x-defang-llm` service extension. Add this extension to any services which use the Bedrock SDKs. diff --git a/docs/providers/azure.md b/docs/providers/azure.md index f576e1e11d..0952124396 100644 --- a/docs/providers/azure.md +++ b/docs/providers/azure.md @@ -69,6 +69,12 @@ $ export DEFANG_PROVIDER=azure The Defang BYOC Azure Provider uses the region specified in the `AZURE_LOCATION` environment variable. For a list of Azure regions, see the [Azure region documentation](https://azure.microsoft.com/en-us/explore/global-infrastructure/geographies/). Not every Azure service used by Defang (for example, Azure OpenAI model SKUs) is available in every region — `westus3` is a good default during the beta. +### Managed Postgres and Redis region availability + +Azure Database for PostgreSQL and Azure Managed Redis do not ship to every Azure region at the same time, and Microsoft keeps adding regions. Before you set `AZURE_LOCATION`, check the live [Products available by region](https://azure.microsoft.com/en-us/explore/global-infrastructure/products-by-region/table) page for **Azure Database for PostgreSQL** and **Azure Managed Redis**. + +Even in a region where the service itself is available, Defang picks a specific VM SKU for the tier you request (for example `Standard_D2ds_v5` for a general-purpose Postgres server). That SKU can still run into a regional capacity limit. If a deployment fails with a capacity or SKU error, try a different `AZURE_LOCATION` rather than assuming the whole service is unavailable. + ## Architecture Defang uses resources that are native to the cloud provider you are using. The following describes the current state of Defang's support for Azure, the specific resources that Defang uses, and the roadmap for future support. diff --git a/docs/providers/gcp.md b/docs/providers/gcp.md index 350b14a84d..12b9a27eca 100644 --- a/docs/providers/gcp.md +++ b/docs/providers/gcp.md @@ -67,10 +67,14 @@ Defang can help you provision [managed storage](/docs/concepts/managed-storage/m When using [Managed Postgres](/docs/concepts/managed-storage/managed-postgres.mdx), the Defang CLI provisions a Cloud SQL instance in your account. +Cloud SQL is available in all Google Cloud regions, so there's no region planning needed for managed Postgres. See the [Cloud SQL locations documentation](https://cloud.google.com/sql/docs/postgres/locations) for the full list. + ### Managed Redis When using [Managed Redis](/docs/concepts/managed-storage/managed-redis.md), the Defang CLI provisions a Memorystore for Redis cluster in your account. +Memorystore for Redis is available in 40+ Google Cloud regions. See the [Memorystore for Redis regions documentation](https://cloud.google.com/memorystore/docs/redis/regions) if your target `GCP_LOCATION` isn't listed. + ### Managed LLMs Defang offers integration with managed, cloud-native large language model services with the x-defang-llm service extension. Add this extension to any services which use the [Google Vertex AI SDKs](https://cloud.google.com/vertex-ai/docs/python-sdk/use-vertex-ai-sdk).