Skip to content

Commit ab37eb9

Browse files
maud-lvmaud-lv
committed
Merge branch 'liftr-neon-preview-draft2' of https://github.com/ProfessorKendrick/azure-docs-pr into ml-neon
2 parents 987dcc9 + 4ae7fed commit ab37eb9

File tree

6 files changed

+331
-0
lines changed

6 files changed

+331
-0
lines changed

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

Lines changed: 102 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,102 @@
1+
---
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+
author: ProfessorKendrick
5+
ms.author: kkendrick
6+
ms.topic: quickstart
7+
ms.date: 11/22/2024
8+
9+
---
10+
# Quickstart: Create a Neon Serverless Postgres (preview) resource
11+
12+
This quickstart shows you how to create a Neon Serverless Postgres (preview) resource using the Azure portal.
13+
14+
## Prerequisites
15+
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.
17+
18+
## Setup
19+
20+
Begin by signing in to the [Azure portal](https://aka.ms/ANI/NeonServerlessPostgres/AzurePortal).
21+
22+
## Create a Neon Serverless Postgres resource
23+
24+
To create your Neon Serverless Postgres resource, start at the Azure portal home page.
25+
26+
1. Search for the Neon Serverless Postgres resource provider by typing **Neon Serverless Postgres** the header search bar.
27+
28+
1. Choose **Neon Serverless Postgres** from the *Services* search results.
29+
30+
1. Select the **+ Create** option.
31+
32+
## Create a Neon Serverless Postgres Resource
33+
34+
The **Create a Neon Serverless Postgres** Resource pane opens to the *Basics* tab by default.
35+
36+
### Basics tab
37+
38+
The *Basics* tab has three sections:
39+
40+
- Project details
41+
- Azure Resource details
42+
- New Organization details
43+
44+
<!--add image-->
45+
46+
There are required fields in each section that you need to fill out.
47+
48+
1. Enter the values for each required setting under *Project details*.
49+
50+
|Field |Action |
51+
|---------|---------|
52+
|Subscription |Select a subscription from your existing subscriptions. |
53+
|Resource group |Use an existing resource group or create a new one. |
54+
55+
1. Enter the values for each required setting under *Azure Resource details*.
56+
57+
|Field |Action |
58+
|---------|---------|
59+
|Resource name |Specify a unique name for the resource. |
60+
|Region |Select a region to deploy your resource. |
61+
62+
1. Enter the values for each required setting under *New Organization details*.
63+
64+
|Field |Action |
65+
|---------|---------|
66+
|Organization |Specify a name for the organization. |
67+
|Plan |Select the **Change plan** link and choose the plan you want. |
68+
69+
The remaining fields update to reflect the details of the plan you selected for this new organization.
70+
71+
1. Select the **Next** button at the bottom of the page.
72+
73+
### Tags tab (optional)
74+
75+
If you wish, you can optionally create a tag for your Neon Serverless Postgres resource.
76+
77+
1. Select the **Review + create** button at the bottom of the page.
78+
79+
### Review + create tab
80+
81+
<!--TODO: Add image-->
82+
83+
> [!NOTE]
84+
> The view automation template link directs you to a downloadable [ARM template](LINK).
85+
86+
If the review identifies errors, a red dot appears next each section where errors exist. Fields with errors are highlighted in red.
87+
88+
1. Open each section with errors and fix the errors.
89+
90+
1. Select the **Review + create** button again.
91+
92+
1. Select the **Create** button.
93+
94+
Once the resource is created, select **Go to Resource** to navigate to the Neon resource.
95+
96+
## Related content
97+
98+
To learn more about Azure, review [Azure fundamental concepts](/azure/cloud-adoption-framework/ready/considerations/fundamental-concepts).
99+
100+
## Next steps
101+
102+
[Manage your Neon integration through the portal](manage.md)

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

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
---
2+
title: Manage a Neon resource through the Azure portal
3+
description: This article describes management functions for Neon on the Azure portal.
4+
author: ProfessorKendrick
5+
ms.topic: how-to
6+
ms.custom:
7+
8+
ms.date: 11/22/2024
9+
---
10+
11+
# Manage your Neon integration through the portal
12+
13+
## Single sign-on
14+
15+
Single sign-on (SSO) is already enabled when you created your Neon resource. To access Neon through SSO, follow these steps:
16+
17+
1. Navigate to the Overview for your instance of the Neon resource.
18+
19+
1. Select the SSO URL.
20+
21+
<!--add image-->
22+
23+
> [!NOTE]
24+
> 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.
25+
26+
## Delete a Neon resource
27+
28+
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:
29+
30+
1. From the Resource menu, select the Neon resource you would like to delete.
31+
32+
1. On the working pane of the **Overview**, select **Delete**.
33+
34+
1. Confirm that you want to delete the Neon resource by entering the name of the resource.
35+
36+
1. Choose the reason why would you like to delete the resource.
37+
38+
1. Select **Delete**.
39+
40+
## Related content
41+
42+
[Neon Serverless Postgres developer resources and tools](tools.md)

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

Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
---
2+
title: What is Neon Serverless Postgres?
3+
description: Learn about using the Neon Serverless Postgres in the Azure Marketplace.
4+
author: ProfessorKendrick
5+
ms.topic: overview
6+
ms.custom:
7+
8+
ms.date: 11/22/2024
9+
---
10+
11+
# What is Neon Serverless Postgres?
12+
13+
Easily provision, manage, and tightly integrate independent software vendor (ISV) software and services on Azure with Azure Native integrations.
14+
15+
Microsoft and [Neon](https://neon.tech/) developed this service and manage it together.
16+
17+
<!--You can find Neon Serverless Postgres in the [Azure portal]().or get it on [Azure Marketplace]().-->
18+
19+
Neon is a cloud-native Postgres solution designed for modern applications. It offers a serverless, fully managed, and scalable Postgres database.
20+
Neon's advanced features include autoscaling, scale-to-zero, database branching, instant point-in-time restore, and time travel queries.
21+
Neon simplifies database management with seamless integration into your existing workflows, providing a powerful, cost-efficient solution for developers and businesses. 
22+
23+
Neon manages the Postgres infrastructure, including database configuration, maintenance, and scaling operations, allowing you to focus on building and optimizing your applications.
24+
25+
With its intuitive onboarding process, you can quickly start using Neon's capabilities for your Azure workloads, ensuring your databases are always optimized for performance and reliability. 
26+
27+
Here are the key capabilities provided by the Neon integration:
28+
29+
- **Seamless onboarding** on Neon as an integrated service on Azure.
30+
- **Unified billing** of Neon through monthly billing through Azure Marketplace.
31+
- **Single-Sign on to Neon** - No separate sign-up needed from the Neon portal.
32+
- **Manage all Neon resources** from the Azure portal, and track them in the **All resources** page with your other Azure resources.
33+
34+
## Prerequisites for Neon Serverless Postgres
35+
36+
- An Azure account. If you don't have an active Azure subscription, [create a free account](https://azure.microsoft.com/free/).
37+
- Only users with _Owner_ or _Contributor_ access on the Azure subscription can set up the Azure integration. Ensure you have the appropriate access before starting to set up this integration.
38+
39+
## Find Neon Serverless Postgres
40+
41+
From the [Azure Marketplace](LINK), search for _Neon Serverless Postgres_. Once you subscribe, you'll be directed to a the [Create a Neon Serverless Postgres resource](create.md#create-a-neon-serverless-postgres-resource)pane.
42+
43+
You can also find Neon Serverless Postgres in the [Azure portal](LINK).-->
44+
45+
## Related content
46+
47+
- [QuickStart: Get started with Neon](create.md)
48+
- [Manage your Neon integration through the portal](manage.md)
49+
- [Neon Serverless Postgres developer resources and tools](tools.md)

‎articles/partner-solutions/neon/toc.yml

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
items:
2+
- name: Overview
3+
items:
4+
- name: What is Neon Serverless Postgres - An Azure Native ISV Service
5+
href: overview.md
6+
- name: Quickstarts
7+
expanded: true
8+
items:
9+
- name: Create
10+
href: create.md
11+
- name: How to
12+
items:
13+
- name: Manage
14+
href: manage.md

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

Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
1+
---
2+
title: Neon Serverless Postgres developer resources and tools
3+
description: Learn about resources and developer tools available with Neon Serverless Postgres.
4+
5+
ms.topic: overview
6+
ms.date: 11/22/2024
7+
8+
# CustomerIntent: As a developer implementing Neon Serverless Postgres, I want to know about other resources and tools available.
9+
10+
---
11+
12+
# What are some resources and tools you can use with Neon Serverless Postgres on Azure?
13+
14+
In this article, you learn about resources and tools for use with Neon Serverless Postgres
15+
16+
- Articles that you can use to understand Neon Serverless Postgres
17+
- Tools for developers to work with Neon Serverless Postgres
18+
19+
## Neon Postgres resources
20+
21+
To learn more about Neon Postgres:
22+
23+
- [Why Neon?](https://neon.tech/docs/get-started-with-neon/why-neon)
24+
- [Developer experience with Neon](https://neon.tech/docs/get-started-with-neon/dev-experience)
25+
- [Neon features](https://neon.tech/docs/guides/neon-features)
26+
- [Neon pricing](https://neon.tech/pricing)
27+
28+
To get started on Neon Postgres:
29+
30+
- [Learn the basics](https://neon.tech/docs/get-started-with-neon/signing-up)
31+
- [Connect Neon to your stack](https://neon.tech/docs/get-started-with-neon/connect-neon)
32+
- [Learn about database branching](https://neon.tech/docs/get-started-with-neon/workflow-primer)
33+
- [Production-ready features](https://neon.tech/docs/get-started-with-neon/production-checklist)
34+
- [Migrate data to Neon Postgres](https://neon.tech/docs/import/migrate-intro)
35+
36+
To learn more about how Neon can help you make the most of your Neon Postgres resource:
37+
38+
- [Neon sales](https://neon.tech/contact-sales)
39+
- [Neon support](https://neon.tech/docs/introduction/support)
40+
- [Neon Discord server](https://discord.gg/92vNTzKDGp)
41+
42+
## Developer tools
43+
44+
Neon Postgres offers several developer tools and guides to help you with integration and management of your resource.
45+
46+
Key links to get started:
47+
48+
- [Neon CLI](https://neon.tech/docs/reference/neon-cli)
49+
- [Neon API](https://api-docs.neon.tech/reference/getting-started-with-neon-api)
50+
- [Neon Serverless driver](https://neon.tech/docs/serverless/serverless-driver)
51+
- [Neon SDKs](https://neon.tech/docs/reference/sdk)
52+
- [Terraform providers](https://neon.tech/docs/reference/terraform)
53+
- [Framework guides](https://neon.tech/docs/get-started-with-neon/frameworks)
54+
- [Language guides](https://neon.tech/docs/get-started-with-neon/languages)
55+
- [Integration guides](https://neon.tech/docs/guides/integrations)
56+
- [Supported Postgres extensions](https://neon.tech/docs/extensions/extensions-intro)

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

Lines changed: 68 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
1+
---
2+
title: Troubleshoot Neon Serverless Postgres
3+
description: Learn how to troubleshoot Neon Serverless Postgres.
4+
author: ProfessorKendrick
5+
ms.topic: overview
6+
ms.custom:
7+
8+
ms.date: 11/22/2024
9+
---
10+
11+
# Troubleshoot Neon Serverless Postgres
12+
13+
You can get support for your Neon deployment through a New Support request. For further assistance, visit [Neon Support]. In addition, this article includes troubleshooting for problems you might experience in creating and using a Neon resource.
14+
15+
## Getting support
16+
17+
To contact support about Neon resource, select the resource in the Resource menu.
18+
19+
<!--add image-->
20+
21+
Select Support + troubleshooting in Help menu on the left of the Overview page.
22+
23+
Select **Create a support request**. You're redirected to the partner portal where you can raise a support ticket.
24+
25+
## Unable to create a Neon resource as not a subscription owner/ contributor
26+
Only users with Owner or Contributor access on the Azure subscription can create Neon resources. Ensure you have the appropriate access before setting up this integration.
27+
28+
## Marketplace purchase errors
29+
30+
### The Microsoft.SaaS resource provider isn't registered on the Azure subscription.
31+
You must make sure your Azure subscription is registered for the resource provider before you use it. Learn more about [resource provider registration](../../azure-resource-manager/management/resource-providers-and-types.md#register-resource-provider) and [resolving errors on resource provider registration](../../azure/azure-resource-manager/troubleshooting/error-register-resource-provider).
32+
33+
### Plan can't be purchased on a free subscription.
34+
You can't make marketplace purchases on a free Azure subscription. Refer to the [Azure free account FAQ](https://azure.microsoft.com/en-us/pricing/purchase-options/azure-account). For more information, see [purchase SaaS offer in the Azure portal](/marketplace/purchase-saas-offer-in-azure-portal).
35+
36+
### Purchase failed because we couldn't find a valid payment method associated with your Azure subscription.
37+
Use a different Azure subscription or add or update current credit card or payment method information for this subscription. For more information, see [purchase SaaS offer in the Azure portal](/marketplace/purchase-saas-offer-in-azure-portal).
38+
39+
### The Publisher doesn't make available Offer, Plan in your Subscription/Azure account’s region.
40+
The offer or the specific plan isn't available to the billing account market that is connected to the Azure Subscription.
41+
42+
### Enrollment for Azure Marketplace is set to Free/BYOL SKUs only, purchase for Azure product isn't allowed. Contact your enrollment administrator.
43+
Enterprise administrators can disable or enable Azure Marketplace purchases for all Azure subscriptions under their enrollment. For more information, see Azure Marketplace - Microsoft Cost Management[Enabling Azure Marketplace purchases](../../cost-management-billing/manage/ea-azure-marketplace.md#enabling-azure-marketplace-purchases). More information on different listing options is present in Introduction to listing options.
44+
45+
### Marketplace isn't enabled for the Azure subscription.
46+
Enterprise administrators can disable or enable Azure Marketplace purchases for all Azure subscriptions under their enrollment. Refer to Azure Marketplace - Microsoft Cost Management.
47+
48+
### Plan by publisher isn't available to you for purchase due to private marketplace settings made by your tenant’s IT administrator.
49+
Customer uses private marketplace to limit the access of its organization to specific offers and plans. The specific offer or the plan wasn't set up to be available in the tenant's private marketplace. Contact your tenant’s IT administrator.
50+
51+
### The EA subscription doesn't allow Marketplace purchases.
52+
Use a different subscription or check if your EA subscription is enabled for Marketplace purchase. For more information, see Enable Marketplace purchases.
53+
If those options don't solve the problem, contact [Neon support].
54+
55+
## Deployment Failed error
56+
If you get a Deployment Failed error, check the status of your Azure subscription. Make sure it isn't suspended and doesn't have any billing issues.
57+
58+
## Resource creation takes a long time
59+
If the deployment process takes more than three hours to complete, contact [Neon support](https://neon.tech/docs/introduction/support).
60+
If the deployment fails and the Neon resource has a status of Failed, delete the resource. After deletion, try to create the resource again
61+
62+
## Other Troubleshooting resources
63+
64+
### Errors when connecting to your Neon database
65+
If you encounter issues when connecting to your Neon database, refer to the [Connection errors section in the Neon documentation](https://neon.tech/docs/connect/connection-errors) for potential solutions.
66+
67+
### Database connection latency and timeouts
68+
If you experience latency or timeouts while connecting to your Neon database, consult the Connection latency and timeouts section in the Neon documentation for strategies and best practices.

0 commit comments

Comments
 (0)