Skip to content

Commit 3d2e70d

Browse files
ktoliverktoliver
authored
Merge pull request #300179 from ShawnJackson/neon-serverless-postgres-ga
[AQ] edit pass: Neon Serverless Postgres GA content
2 parents d1c12c0 + 862daa2 commit 3d2e70d

File tree

9 files changed

+149
-157
lines changed

9 files changed

+149
-157
lines changed

‎articles/partner-solutions/includes/sso.md

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -5,14 +5,12 @@ ms.date: 02/18/2025
55
ms.author: kkendrick
66
---
77

8-
If your organization uses Microsoft Entra ID as its identity provider, you can establish single sign-on from the Azure portal.
9-
10-
To establish single sign-on through Microsoft Entra ID:
8+
If your organization uses Microsoft Entra ID as its identity provider, you can establish single sign-on from the Azure portal:
119

1210
1. Select the checkbox.
1311

14-
The Azure portal retrieves the appropriate application from Microsoft Entra ID.
12+
The Azure portal retrieves the appropriate application from Microsoft Entra ID.
1513

1614
1. Select the app name.
1715

18-
Select the **Next** button at the bottom of the page.
16+
1. Select **Next**.

‎articles/partner-solutions/includes/view-edit-connection.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,9 @@ ms.date: 02/25/2025
55
ms.author: malev
66
---
77

8-
To review, edit or delete your existing connections:
8+
To review, edit, or delete your existing connections:
99

10-
1. Navigate to your application in the Azure portal and open Service Connector from the left menu.
10+
1. Go to your application in the Azure portal. On the left menu, open **Service Connector**.
1111

1212
1. Select a connection's checkbox and explore the following options:
1313

‎articles/partner-solutions/neon/create-service-connection.md

Lines changed: 29 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -1,59 +1,62 @@
11
---
2-
title: Connect apps to Neon Serverless Postgres
3-
description: Learn how to connect apps to your Neon Serverless Postgres service using Service Connector in Azure.
4-
# customerIntent: As a developer I want connect apps deployed to Azure services, to a Neon Serverless Postgres resource.
2+
title: Connect Apps to Neon Serverless Postgres
3+
description: Learn how to connect apps to the Neon Serverless Postgres service by using Service Connector in Azure.
4+
#customer intent: As a developer, I want connect apps deployed in Azure services to a Neon Serverless Postgres resource so that I can take advantage of Neon's capabilities.
55
ms.topic: how-to
66
ms.date: 03/28/2025
77
ms.custom: service-connector
88
---
99

1010
# Connect apps to Neon Serverless Postgres
1111

12-
In this guide, learn how to connect your app to a database within a Neon Serverless Postgres resource using Service Connector.
12+
In this guide, learn how to connect your app to a database within a Neon Serverless Postgres resource by using Service Connector.
1313

14-
Service Connector is an Azure service designed to simplify the process of connecting Azure resources together. Service Connector manages your connection's network and authentication settings to simplify the operation.
14+
Service Connector is an Azure feature that simplifies the process of connecting Azure resources together. Service Connector manages your connection's network and authentication settings to simplify the operation.
1515

16-
This guide shows step by step instructions to connect an app deployed to Azure App Service to a Neon Serverless Postgres resource. You can apply a similar method to create a connection from apps deployed to [Azure Container Apps](/azure/container-apps/quickstart-portal), [Azure Kubernetes Services (AKS)](/azure/aks/learn/quick-kubernetes-deploy-portal).
16+
This guide shows step-by-step instructions for connecting an app deployed in Azure App Service to a Neon Serverless Postgres resource. You can apply a similar method to create a connection from apps deployed in [Azure Container Apps](/azure/container-apps/quickstart-portal) or [Azure Kubernetes Service (AKS)](/azure/aks/learn/quick-kubernetes-deploy-portal).
1717

1818
## Prerequisites
1919

20-
* An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free)
21-
* An existing Neon Serverless Postgres resource. If you don't have one yet, refer to [create a Neon Serverless Postgres resource](./create.md)
22-
* An app deployed to an [Azure compute service supported by Service Connector](../../service-connector/overview.md#what-services-are-supported-by-service-connector).
20+
- An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free).
21+
- An existing Neon Serverless Postgres resource. If you don't have one yet, refer to [Create a Neon Serverless Postgres resource](./create.md).
22+
- An app deployed to an [Azure compute service that Service Connector supports](../../service-connector/overview.md#what-services-are-supported-by-service-connector).
2323

24-
## Create a new connection
24+
## Create a connection
2525

2626
Follow these steps to connect an app to Neon Serverless Postgres:
2727

2828
1. Open the App Service, Container Apps, or AKS resource where your app is deployed.
2929

30-
1. Open **Service Connector** from the left menu and select **Create**.
30+
1. On the left menu, open **Service Connector**, and then select **Create**.
3131

32-
:::image type="content" source="./media/service-connection/create-connection.png" alt-text="Screenshot from the Azure portal showing the Create option.":::
32+
:::image type="content" source="./media/service-connection/create-connection.png" alt-text="Screenshot of the Azure portal that shows the button for creating a connection.":::
3333

34-
1. Enter or select the following information.
34+
1. Enter or select the following information:
3535

3636
| Setting | Example | Description |
3737
|----------------------------|-------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
3838
| **Service type** | *Neon Serverless Postgres* | The name of the target service: **Neon Serverless Postgres**. |
39-
| **Connection name** | *neon_postgres_01* | The name of the connection between the Azure compute resource and the Neon Serverless Postgres resource. Use the connection name provided by Service Connector or enter your own connection name. Connection names can only contain letters, numbers (0-9), periods ("."), and underscores ("_"). |
40-
| **Neon Postgres hostname** | *contoso-compute.gwc.azure.neon.tech* | The host name of the Neon Serverless Postgres resource. The host name is displayed in the Neon portal, in the **Connect** menu, under **Connection string**. |
41-
| **Neon Postgres database** | *database* | The name of the database within the Neon Serverless Postgres resource. The database name is displayed in the Neon portal, in the **Connect** menu, under **Database**. |
39+
| **Connection name** | *neon_postgres_01* | The name of the connection between the Azure compute resource and the Neon Serverless Postgres resource. Use the connection name that Service Connector provides, or enter your own connection name. Connection names can contain only letters, numbers (0-9), periods (.), and underscores (_). |
40+
| **Neon Postgres hostname** | *contoso-compute.gwc.azure.neon.tech* | The host name of the Neon Serverless Postgres resource. The host name is displayed in the Neon portal, on the **Connect** menu, under **Connection string**. |
41+
| **Neon Postgres database name** | *database* | The name of the database within the Neon Serverless Postgres resource. The database name is displayed in the Neon portal, on the **Connect** menu, under **Database**. |
4242
| **Client type** | *Python* | The database client type. |
43-
44-
:::image type="content" source="./media/service-connection/create-basics-tab.png" alt-text="Screenshot from the Azure portal showing the Create connection - Basics tab.":::
4543

46-
1. Select **Next: Authentication** and select or enter the following information:
47-
1. Select **Database credentials** and enter your database username and password.
48-
1. Select **Store Secret in Key Vault** and select a Key Vault connection if you already have one, or select **Create new** to create a Key Vault connection. For step-by-step instructions to create a new connection to Key Vault, refer to [Connect Azure services and store secrets in Azure Key Vault](../../service-connector/tutorial-portal-key-vault.md#create-a-key-vault-connection-in-app-service).
49-
1. Optionally also select **Advanced** and edit the provided environment variables.
44+
:::image type="content" source="./media/service-connection/create-basics-tab.png" alt-text="Screenshot of the Azure portal that shows the Basics tab for creating a connection.":::
5045

51-
:::image type="content" source="./media/service-connection/create-authentication-tab.png" alt-text="Screenshot from the Azure portal showing the Create connection - Authentication tab.":::
46+
1. Select **Next: Authentication**, and then select or enter the following information:
47+
48+
1. Select **Database credentials**, and then enter your database username and password.
49+
1. Select **Store Secret In Key Vault**, and then select an Azure Key Vault connection if you already have one.
50+
51+
If you don't have a Key Vault connection, select **Create new** to create one. For step-by-step instructions on creating a new connection to Key Vault, refer to [Connect Azure services and store secrets in Azure Key Vault](../../service-connector/tutorial-portal-key-vault.md#create-a-key-vault-connection-in-app-service).
52+
1. Optionally, select **Advanced** and edit the provided environment variables.
53+
54+
:::image type="content" source="./media/service-connection/create-authentication-tab.png" alt-text="Screenshot of the Azure portal that shows the Authentication tab for creating a connection.":::
5255

5356
> [!NOTE]
54-
> We recommend you leverage Azure Key Vault to securely store and manage your credentials, reduce the risk of exposure and simplify secret management.
57+
> We recommend that you use Azure Key Vault to securely store and manage your credentials, reduce the risk of exposure, and simplify secret management.
5558
56-
1. Select **Next: Networking** > **Next: Review + Create** and review the provided information.
59+
1. Select **Next: Networking** > **Next: Review + Create**, and then review the provided information.
5760

5861
1. Select **Create**.
5962

@@ -64,4 +67,4 @@ Follow these steps to connect an app to Neon Serverless Postgres:
6467
## Related content
6568

6669
- [Troubleshoot Neon Serverless Postgres](troubleshoot.md)
67-
- [Manage the resource in the Azure portal](manage.md)
70+
- [Manage your Neon integration through the Azure portal](manage.md)

‎articles/partner-solutions/neon/create.md

Lines changed: 31 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,19 @@
11
---
2-
title: "Quickstart: Create a Neon Serverless Postgres resource"
3-
description: Learn how to create a resource for Neon Serverless Postgres using the Azure portal.
2+
title: "Quickstart: Create a Neon Serverless Postgres Resource"
3+
description: Learn how to create a resource for Neon Serverless Postgres by using the Azure portal.
44
author: ProfessorKendrick
55
ms.author: kkendrick
66
ms.topic: quickstart
77
ms.date: 05/06/2025
88
---
99
# Quickstart: Create a Neon Serverless Postgres resource
1010

11-
This quickstart shows you how to create a Neon Serverless Postgres resource using the Azure portal.
11+
This quickstart shows you how to create a Neon Serverless Postgres resource by using the Azure portal.
1212

1313
## Prerequisites
1414

1515
[!INCLUDE [create-prerequisites](../includes/create-prerequisites.md)]
16+
1617
- You must [subscribe to Neon](overview.md#subscribe-to-neon).
1718

1819
## Create a resource
@@ -21,60 +22,52 @@ This quickstart shows you how to create a Neon Serverless Postgres resource usin
2122

2223
### Basics tab
2324

24-
The *Basics* tab has three sections:
25-
26-
- Project details
27-
- Azure Resource details
28-
- New Organization details
29-
30-
:::image type="content" source="media/create/basics-tab.png" alt-text="Screenshot from the Azure portal showing the Basics tab to create a new Neon resource.":::
25+
The **Basics** tab has sections for details about the project, the Azure resource, and the Neon organization. Red asterisks identify required settings.
3126

32-
There are required fields in each section that you need to fill out.
27+
:::image type="content" source="media/create/basics-tab.png" alt-text="Screenshot of the Azure portal that shows the Basics tab to create a new Neon resource.":::
3328

34-
1. Enter the values for each required setting under *Project details*.
29+
1. Under **Project details**, enter these values:
3530

36-
|Field |Action |
31+
|Setting |Action |
3732
|-------------------|----------------------------------------------------------------|
38-
|Subscription |Select a subscription from your existing subscriptions. |
39-
|Resource group |Use an existing resource group or create a new one. |
33+
|**Subscription** |Select a subscription from your existing subscriptions. |
34+
|**Resource group** |Use an existing resource group or create a new one. |
4035

41-
1. Enter the values for each required setting under *Azure Resource details*.
36+
1. Under **Azure Resource details**, enter these values:
4237

43-
|Field |Action |
38+
|Setting |Action |
4439
|------------------|--------------------------------------------------|
45-
|Resource name |Specify a unique name for the resource. |
46-
|Region |Select a region to deploy your resource. |
40+
|**Resource name** |Specify a unique name for the resource. |
41+
|**Region** |Select a region to deploy your resource. |
4742

48-
1. Enter the values for each required setting under *New Organization details*.
43+
1. Under **New Organization details**, enter these values:
4944

50-
|Field |Action |
45+
|Setting |Action |
5146
|-----------------|---------------------------------------------------------------------|
52-
|Organization |Specify a name for the organization. |
53-
|Plan |Select the **Change plan** link and choose the plan you want. |
47+
|**Organization name** |Specify a name for the organization. |
48+
|**Plan** |Select the **Change Plan** link and choose the plan that you want. |
5449

55-
The remaining fields update to reflect the details of the plan you selected for this new organization.
50+
The remaining settings update themselves to reflect the details of the plan that you selected for this new organization.
5651

57-
1. Select the **Next** button at the bottom of the page.
52+
1. Select **Next**.
5853

5954
### Project tab
6055

61-
In Neon, everything starts with a project: the top-level object in the Neon object hierarchy. When you create a project, a default branch and database is automatically created for your project to help you get started.
56+
In Neon, everything starts with a project: the top-level object in the Neon object hierarchy. When you create a project, a default branch and database are automatically created for your project to help you get started.
6257

63-
:::image type="content" source="media/create/project-tab.png" alt-text="Screenshot from the Azure portal showing the Project tab for the Neon resource.":::
58+
:::image type="content" source="media/create/project-tab.png" alt-text="Screenshot of the Azure portal that shows the Project tab for a Neon resource.":::
6459

65-
- Enter the values for each setting, or continue with the default values for your project.
60+
On the **Project** tab, enter the values for each setting, or continue with the default values for your project.
6661

67-
68-
|Field |Action |
69-
|-------------------|-------------------------------------------------------------------|
70-
|Project name |Specify a name for your Neon project. |
71-
|Postgres version |Choose a Postgres version for your project. |
72-
|Database name |Specify a name for your first database in the project. |
73-
|Project region |Choose the region for your database. |
62+
|Setting |Action |
63+
|-------------------|-------------------------------------------------------------------|
64+
|**Project name** |Specify a name for your Neon project. |
65+
|**Postgres version** |Choose a Postgres version for your project. |
66+
|**Database name** |Specify a name for your first database in the project. |
67+
|**Project region** |Choose the region for your database. |
7468

75-
> [!NOTE]
76-
> The *Project region* in this tab corresponds to your database.
77-
> Don't confuse this value with the *Region* from the Basics tab, which is where your Azure resource is deployed.
69+
> [!NOTE]
70+
> The **Project region** value on this pane corresponds to your database. Don't confuse this value with the **Region** value from the **Basics** tab, which is where your Azure resource is deployed.
7871
7972
### Tags tab (optional)
8073

0 commit comments

Comments
 (0)