Merge pull request #298709 from ProfessorKendrick/neon-ga

[Liftr] Neon (GA)

Author: denrea

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

@@ -1,15 +1,15 @@
 ---
-title: Connect apps to Neon Serverless Postgres (Preview)
-description: Learn how to connect apps to your Neon Serverless Postgres (Preview) service using Service Connector in Azure.
-# customerIntent: As a developer I want connect apps deployed to Azure services, to a Neon Serverless Postgres (Preview) resource.
+title: Connect apps to Neon Serverless Postgres
+description: Learn how to connect apps to your Neon Serverless Postgres service using Service Connector in Azure.
+# customerIntent: As a developer I want connect apps deployed to Azure services, to a Neon Serverless Postgres resource.
 ms.topic: how-to
 ms.date: 03/28/2025
 ms.custom: service-connector
 ---
 
-# Connect apps to Neon Serverless Postgres (Preview)
+# Connect apps to Neon Serverless Postgres
 
-In this guide, learn how to connect your app to a database within a Neon Serverless Postgres (Preview) resource using Service Connector.
+In this guide, learn how to connect your app to a database within a Neon Serverless Postgres resource using Service Connector.
 
 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.
 
@@ -23,7 +23,7 @@ This guide shows step by step instructions to connect an app deployed to Azure A
 
 ## Create a new connection
 
-Follow these steps to connect an app to Neon Serverless Postgres (Preview):
+Follow these steps to connect an app to Neon Serverless Postgres:
 
 1. Open the App Service, Container Apps, or AKS resource where your app is deployed.
 
@@ -63,5 +63,5 @@ Follow these steps to connect an app to Neon Serverless Postgres (Preview):
 
 ## Related content
 
-- [Troubleshoot Neon Serverless Postgres (Preview)](troubleshoot.md)
-- [Manage the New Relic resource in the Azure portal](manage.md)
+- [Troubleshoot Neon Serverless Postgres](troubleshoot.md)
+- [Manage the resource in the Azure portal](manage.md)

articles/partner-solutions/neon/create.md

@@ -1,35 +1,23 @@
 ---
-title: "Quickstart: Create a  Neon Serverless Postgres (Preview) resource"
-description: Learn how to create a resource for  Neon Serverless Postgres (Preview) using the Azure portal.
+title: "Quickstart: Create a  Neon Serverless Postgres resource"
+description: Learn how to create a resource for  Neon Serverless Postgres using the Azure portal.
 author: ProfessorKendrick
 ms.author: kkendrick
 ms.topic: quickstart
-ms.date: 12/02/2024
-
+ms.date: 05/06/2025
 ---
-# Quickstart: Create a Neon Serverless Postgres (Preview) resource
+# Quickstart: Create a Neon Serverless Postgres resource
 
-This quickstart shows you how to create a Neon Serverless Postgres (Preview) resource using the Azure portal.
+This quickstart shows you how to create a Neon Serverless Postgres resource using the Azure portal.
 
 ## Prerequisites
 
-- An Azure account with an active subscription is required. If you don't already have one, you can [create an account for free](https://azure.microsoft.com/free/). Make sure you're an *Owner* or a *Contributor* in the subscription.
-
-## Setup
-
-Begin by signing in to the [Azure portal](https://portal.azure.com/).
-
-## Create a Neon Serverless Postgres resource
-
-To create your Neon Serverless Postgres resource, start at the Azure portal home page.
-
-1. Search for the Neon Serverless Postgres resource provider by typing **Neon Serverless Postgres** the header search bar.
+[!INCLUDE [create-prerequisites](../includes/create-prerequisites.md)]
+- You must [subscribe to Neon](overview.md#subscribe-to-neon).
 
-1. Choose **Neon Serverless Postgres** from the *Services* search results.
+## Create a resource
 
-1. Select the **+ Create** option.
-
-The **Create a Neon Serverless Postgres** Resource pane opens to the *Basics* tab by default.
+[!INCLUDE [create-resource](../includes/create-resource.md)]
 
 ### Basics tab
 
@@ -45,49 +33,58 @@ There are required fields in each section that you need to fill out.
 
 1. Enter the values for each required setting under *Project details*.
 
-    |Field  |Action  |
-    |---------|---------|
-    |Subscription    |Select a subscription from your existing subscriptions.         |
-    |Resource group     |Use an existing resource group or create a new one.          |
+    |Field              |Action                                                          |
+    |-------------------|----------------------------------------------------------------|
+    |Subscription       |Select a subscription from your existing subscriptions.         |
+    |Resource group     |Use an existing resource group or create a new one.             |
 
 1. Enter the values for each required setting under *Azure Resource details*.
 
-    |Field |Action  |
-    |---------|---------|
-    |Resource name     |Specify a unique name for the resource.    |
-    |Region     |Select a region to deploy your resource.         |
+    |Field             |Action                                            |
+    |------------------|--------------------------------------------------|
+    |Resource name     |Specify a unique name for the resource.           |
+    |Region            |Select a region to deploy your resource.          |
 
 1. Enter the values for each required setting under *New Organization details*.
 
-    |Field  |Action  |
-    |---------|---------|
-    |Organization     |Specify a name for the organization.   |
-    |Plan    |Select the **Change plan** link and choose the plan you want.        |
+    |Field            |Action                                                               |
+    |-----------------|---------------------------------------------------------------------|
+    |Organization     |Specify a name for the organization.                                 |
+    |Plan             |Select the **Change plan** link and choose the plan you want.        |
 
     The remaining fields update to reflect the details of the plan you selected for this new organization.
 
 1. Select the **Next** button at the bottom of the page.
 
-### Tags tab (optional)
+### Project tab
 
-If you wish, you can optionally create a tag for your Neon Serverless Postgres resource, then select the **Review + create** button at the bottom of the page. 
+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.
 
-### Review + create tab
+:::image type="content" source="media/create/project-tab.png" alt-text="Screenshot from the Azure portal showing the Project tab for the Neon resource.":::
 
-> [!NOTE]
-> The view automation template link directs you to a downloadable [ARM template](../../azure-resource-manager/templates/overview.md). 
+- Enter the values for each setting, or continue with the default values for your project.
 
-If the review identifies errors, a red dot appears next each section where errors exist. Fields with errors are highlighted in red. 
+    
+    |Field              |Action                                                             |
+    |-------------------|-------------------------------------------------------------------|
+    |Project name       |Specify a name for your Neon project.                              |
+    |Postgres version   |Choose a Postgres version for your project.                        |
+    |Database name      |Specify a name for your first database in the project.             |
+    |Project region     |Choose the region for your database.                               |
 
-1. Open each section with errors and fix the errors.
+    > [!NOTE]
+    > The *Project region* in this tab corresponds to your database. 
+    > Don't confuse this value with the *Region* from the Basics tab, which is where your Azure resource is deployed. 
 
-1. Select the **Review + create** button again.
+### Tags tab (optional)
+
+[!INCLUDE [tags](../includes/tags.md)]
 
-1. Select the **Create** button.
+### Review + create tab
 
-Once the resource is created, select **Go to Resource** to navigate to the Neon resource. 
+[!INCLUDE [review-create](../includes/review-create.md)]
 
-## Next steps
+## Next step
 
 > [!div class="nextstepaction"]
-> [Manage your Neon  integration through the portal](manage.md)
+> [Manage your resource](manage.md)

articles/partner-solutions/neon/manage.md

@@ -1,45 +1,109 @@
 ---
-title: Manage a Neon resource through the Azure portal (Preview)
-description: This article describes management functions for Neon on the Azure portal.
+title: Manage a Neon resource through the Azure portal
+description: This article describes management functions for Neon in Azure portal.
 author: ProfessorKendrick
 ms.topic: how-to
-ms. custom:
-
-ms.date: 12/04/2024
+ms.date: 05/06/2025
 ---
 
-# Manage your Neon integration through the portal (Preview)
+# Manage your Neon integration through the portal
 
-This article describes how to access the Neon Console and how to delete the Neon Serverless Postgres (Preview) resource using the Azure portal.
+This article describes how to manage a Neon resource in Azure portal.
 
-## Single sign-on
+## Resource overview
+
+[!INCLUDE [manage](../includes/manage.md)]
 
-Single sign-on (SSO) is already enabled when you create your Neon resource. To access Neon through SSO, follow these steps:
+:::image type="content" source="media/manage/resource-overview.png" alt-text="A screenshot of a Pure Storage resource in the Azure portal with the overview displayed in the working pane." lightbox="media/manage/resource-overview.png":::
 
-1. Navigate to the **Overview** for your instance of the Neon resource. 
+The *Essentials* details include:
 
-1. Select the portal SSO URL.
+- Resource group
+- Location
+- Subscription
+- Subscription ID
+- Tags
 
-   :::image type="content" source="media/manage/overview.png" alt-text="Screenshot from the Azure portal showing the Neon SSO URL.":::
+To manage your resource, select the links next to corresponding details.
+
+Below the essentials, you can navigate to other details about your resource by selecting the links.
+
+## Single sign-on
+
+Single sign-on (SSO) is already enabled when you create your Neon resource.
+
+[!INCLUDE [sso](../includes/sso.md)]
 
 > [!NOTE] 
 > The first time you access this URL, depending on your Azure tenant settings, you might be asked to verify your email address on the Neon portal. Once the email address is verified, you can access the Neon portal.
 
-## Delete a Neon resource
+## Projects
+
+When you create your first Neon organization, a default project is created for you. You can create and view your projects from the resource overview.
+
+### View projects
+
+To view your projects, Choose **Projects** from the sidebar.
+
+To view a specific project, select the project's name.
+
+### Create a new project
+
+1. From the menu bar in the working pane, select **+ Create project**.
+
+    The **Create project** flyout appears in the right side of the working pane.
+
+    :::image type="content" source="media/manage/create-project.png" alt-text="The Neon Create project flyout in the Azure portal.":::
 
-Once the Neon resource is deleted, all billing stops for that resource through Azure Marketplace. If you're done using your resource and would like to delete it, follow these steps:
+1. Enter the values for each setting, or continue with the default values for your project.
 
-1. From the **Resource** menu, select the Neon resource you would like to delete.
+    |Field              |Action                                                             |
+    |-------------------|-------------------------------------------------------------------|
+    |Project name       |Specify a name for your Neon project.                              |
+    |Postgres version   |Choose a Postgres version for your project.                        |
+    |Database name      |Specify a name for your first database in the project.             |
+    |Project region     |Choose the region for your database.                               |
 
-1. On the working pane of the **Overview** menu, select **Delete**.
+    > [!NOTE]
+    > The *Project region* in this tab corresponds to your database. 
+    > Don't confuse this value with the *Region* from the Basics tab, which is where your Azure resource is deployed.
 
-1. Confirm deletion.
+1. Select the **Create** button.
 
-1. Select a reason for deleting the resource.
+### Add a branch to a project
+
+A branch is a copy-on-write clone of your data. You can create a branch from a current or past state. Each Neon project is created with a root branch called main. The first branch that you create is branched from the project's root branch. Subsequent branches can branch off the root branch or from a previously created branch.
+
+To create a new branch, open the project in the working pane.
+
+1. Select **+ Create Branch** from the menu bar in the working pane.
+
+    The **Create Branch** flyout appears in the right side of the working pane.
+
+    :::image type="content" source="media/manage/create-branch.png" alt-text="A screenshot of the + Create branch button emphasized inside the working pane with the Create branch flyout open.":::
+
+1. Enter the values for each setting.
+
+1. Select the **Create** button.
+
+### Connect to a database
+
+You can connect clients and applications to a Neon database via a connection string.
+
+To generate a connection string, open your project or branch in the working pane.
+
+1. Select **Connect to database** from the menu bar in the working pane. 
+
+1. Verify the default values or select new values from each dropdown.
+
+1. Select the copy icon next to the connection string.
+
+    :::image type="content" source="media/manage/connect.png" alt-text="A screenshot of the Connect to database options in the working pane with the copy icon emphasized.":::
+
+## Delete a Neon resource
 
-1. Select **Delete**.
+[!INCLUDE [delete-resource](../includes/delete-resource.md)]
 
-## Next steps
+## Related content
 
-> [!div class"nextstepaction"]
-> [Neon Serverless Postgres developer resources and tools](tools.md)
+[Neon Serverless Postgres developer resources and tools](tools.md)