|
1 | 1 | ---
|
2 |
| -title: Create a Neon deployment |
3 |
| -description: This article describes how to use the Azure portal to create an instance of Neon Serverless Postgres - An Azure Native ISV Service. |
| 2 | +title: "Quickstart: Create a Neon Serverless Postgres (preview) resource" |
| 3 | +description: Learn how to create a resource for Neon Serverless Postgres (preview) using the Azure portal. |
4 | 4 | author: ProfessorKendrick
|
| 5 | +ms.author: kkendrick |
5 | 6 | ms.topic: quickstart
|
6 |
| -ms.date: 10/01/2024 |
7 |
| -ms.custom: |
| 7 | +ms.date: 10/29/2024 |
8 | 8 |
|
9 | 9 | ---
|
| 10 | +# Quickstart: Create a Neon Serverless Postgres (preview) resource |
10 | 11 |
|
11 |
| -# QuickStart: Get started with Neon Serverless Postgres - An Azure Native ISV Service |
| 12 | +This quickstart shows you how to create a Neon Serverless Postgres (preview) resource using the Azure portal. |
12 | 13 |
|
13 |
| -In this quickstart, you use the Azure portal and Marketplace to find and create an instance of Neon Serverless Postgres - An Azure Native ISV Service. Use Neon Serverless Postgres - An Azure Native ISV Service to run data pipelines that power company dashboards, AI, and ML applications. |
| 14 | +## Prerequisites |
14 | 15 |
|
15 |
| -When you install Neon Serverless Postgres - An Azure Native ISV Service, you manage your Neon resource usage and billing alongside your existing Azure applications. You also get an integration with Microsoft Entra ID for your organization. |
| 16 | +- 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. |
16 | 17 |
|
17 |
| -For more information, see Install Neon Serverless Postgres - An Azure Native ISV Service from the Azure Marketplace. |
| 18 | +## Setup |
18 | 19 |
|
19 |
| -## Prerequisites |
| 20 | +Begin by signing in to the [Azure portal](https://portal.azure.com). |
20 | 21 |
|
21 |
| -- An Azure account. If you don't have an active Azure subscription, [create a free account](https://azure.microsoft.com/free/). Make sure you're an _Owner_ or a _Contributor_ in the subscription. |
| 22 | +### Register Neon Serverless Postgres as a resource provider |
22 | 23 |
|
23 |
| -## Create a new Neon resource |
| 24 | +To create a Neon Serverless Postgres resource, you must register the `ADD NEON NAME HERE` resource provider first. |
24 | 25 |
|
25 |
| -In this section, you see how to create an instance of Neon using Azure portal. |
| 26 | +1. Under Azure services, choose **Subscriptions**. |
| 27 | +1. Choose the subscription you plan to use. |
| 28 | +1. From your subscription, select **Settings** > **Resource providers**. |
| 29 | +1. In the Filter by name search box, type **ADD NEON NAME HERE**. |
| 30 | +1. Select the ellipse next to `ADD NEON NAME HERE` and choose **Register**. |
26 | 31 |
|
27 |
| -### Find the service |
| 32 | +## Create a Neon Serverless Postgres resource |
28 | 33 |
|
29 |
| -1. Use the search in the [Azure portal](https://portal.azure.com) to find the Neon Serverless Postgres - An Azure Native ISV Service application. |
30 |
| -2. Alternatively, go to Marketplace and search for Neon Serverless Postgres - An Azure Native ISV Service. |
31 |
| -3. Subscribe to the corresponding service. |
| 34 | +To create your Neon Serverless Postgres resource, start at the Azure portal home page. |
32 | 35 |
|
33 |
| -### Basics |
| 36 | +1. Search for the Neon Serverless Postgres resource provider by typing **Azure Native Neon Serverless Postgres Service** the header search bar. |
34 | 37 |
|
35 |
| -1. Set the following values in the **Create a Neon Organization** pane. |
| 38 | +1. Choose **Azure Native Neon Serverless Postgres Service** from the *Services* search results. |
36 | 39 |
|
37 |
| - | Property | Description | |
38 |
| - |---------|---------| |
39 |
| - | **Subscription** | From the drop-down, select your Azure subscription where you have Owner or Contributor access. | |
40 |
| - | **Resource group** | Specify whether you want to create a new resource group or use an existing one. A resource group is a container that holds related resources for an Azure solution. For more information, see [Azure Resource Group overview](/azure/azure-resource-manager/management/overview).| |
41 |
| - | **Resource Name** | Put the name for the Neon organization you want to create. | |
42 |
| - | **Region** | Select the closest region to where you would like to deploy your resource. | |
43 |
| - | **Neon Organization name** | Corresponds to the name of your company, usually. | |
44 |
| - | **Workspace Name** | Name of the default workspace where you would like to group your Airflow deployments. | |
45 |
| - | **Pricing Plan** | Choose the default Pay-As-You-Go option | |
| 40 | +1. Select the **+ Create** option. |
| 41 | + |
| 42 | +## Create an Azure Native Neon Serverless Postgres Service |
| 43 | + |
| 44 | +The Create an Azure Native Neon Serverless Postgres Service pane opens to the *Basics* tab by default. |
| 45 | + |
| 46 | +### Basics tab |
46 | 47 |
|
47 |
| -### Tags |
| 48 | +The *Basics* tab has three sections: |
48 | 49 |
|
49 |
| -You can specify custom tags for the new Neon resource in Azure by adding custom key-value pairs. |
| 50 | +- Project Details |
| 51 | +- Instance Details |
| 52 | +- Company Details |
50 | 53 |
|
51 |
| -1. Select Tags. |
| 54 | +There are required fields in each section that you need to fill out. |
52 | 55 |
|
53 |
| - | Property | Description | |
54 |
| - |----------| -------------| |
55 |
| - | **Name** | Name of the tag corresponding to the Neon resource. | |
56 |
| - | **Value** | Value of the tag corresponding to the Neon resource. | |
| 56 | +1. Enter the values for each required setting under *Project details*. |
| 57 | + |
| 58 | + |Setting |Action | |
| 59 | + |---------|---------| |
| 60 | + |Subscription |Select a subscription from your existing subscriptions. | |
| 61 | + |Resource group |Use an existing resource group or create a new one. | |
| 62 | + |
| 63 | +1. Enter the values for each required setting under *Instance details*. |
| 64 | + |
| 65 | + |Setting |Action | |
| 66 | + |---------|---------| |
| 67 | + |Resource name |Specify a unique name for the resource. | |
| 68 | + |Region |Select the [region](https://azure.microsoft.com/explore/global-infrastructure/geographies/) where you want to enable this service and its child resources to be located. | |
57 | 69 |
|
58 |
| -### Review and create |
| 70 | +1. Enter the values for each required setting under *Company details*. |
59 | 71 |
|
60 |
| -1. Select the **Next: Review + Create** to navigate to the final step for resource creation. When you get to the **Review + Create** page, all validations are run. At this point, review all the selections made in the Basics and optionally Tags panes. You can also review the Neon and Azure Marketplace terms and conditions. |
| 72 | +1. Select the **Review and create** button at the bottom of the page. |
61 | 73 |
|
62 |
| -1. After you review all the information, select **Create**. Azure now deploys the Neon resource. |
| 74 | +### Review and create tab |
63 | 75 |
|
64 |
| -### Deployment completed |
| 76 | +If the review identifies errors, a red dot appears next each tabbed section where errors exist. Fields with errors are highlighted in red. |
65 | 77 |
|
66 |
| -1. Once the create process is completed, select **Go to Resource** to navigate to the specific Neon resource. |
| 78 | +1. Open each tabbed section with errors and fix the errors. |
67 | 79 |
|
68 |
| -1. Select **Overview** in the Resource menu to see information on the deployed resources. |
| 80 | +1. Select the **Review and create** button again. |
69 | 81 |
|
70 |
| -1. Now select the **SSO Url** to redirect to the newly created Neon organization. |
| 82 | +1. Select the **Create** button. |
71 | 83 |
|
72 |
| -## Next steps |
| 84 | +## Related content |
73 | 85 |
|
74 |
| -- [Manage the Neon resource](manage.md) |
75 |
| -<!--TO DO: Add links |
76 |
| -- Get started with Neon Serverless Postgres - An Azure Native ISV Service on |
77 |
| - > [!div class="nextstepaction"] |
78 |
| - > Azure portal |
| 86 | +To learn more about Azure, review [Azure fundamental concepts](/azure/cloud-adoption-framework/ready/considerations/fundamental-concepts). |
79 | 87 |
|
80 |
| - > [!div class="nextstepaction"] |
81 |
| - > Azure Marketplace |
82 |
| ---> |
| 88 | +## Next steps |
0 commit comments