Skip to content

Commit 9edaa4a

Browse files
updates
1 parent f173b70 commit 9edaa4a

3 files changed

Lines changed: 134 additions & 0 deletions

File tree

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
---
2+
title: Unable to install Astro using a personal email
3+
description: Learn why installing Apache Airflow on Astro from the Azure Marketplace isn't supported with a personal email and how to resolve the issue.
4+
author: ProfessorKendrick
5+
ms.author: jarrettr
6+
ms.reviewer: kkendrick
7+
ms.service: partner-services
8+
ms.topic: troubleshooting-problem-resolution
9+
ms.date: 09/04/2025
10+
ai-usage: ai-assisted
11+
12+
#customer intent: As an Azure user, I want to understand why I can't install Astro with a personal email so that I can successfully deploy Apache Airflow.
13+
14+
---
15+
16+
# Unable to install Astro using a personal email
17+
18+
If you're trying to install Apache Airflow on Astro from the Azure Marketplace using a personal email from a generic domain, you may encounter issues. This article explains why this happens and how to resolve it.
19+
20+
## Prerequisites
21+
22+
- Access to the Azure portal.
23+
- An email address associated with a unique domain (such as work or school).
24+
- Subscription owner permissions in Azure.
25+
26+
## Symptoms
27+
28+
- Unable to proceed with Astro installation using a personal email (for example, Gmail, Yahoo, Outlook).
29+
- Error or warning indicating unsupported email domain.
30+
31+
## Cause
32+
33+
Astro installation from the Azure Marketplace doesn't support personal emails from generic domains. The service requires an email address with a unique domain, typically associated with an organization, school, or business.
34+
35+
## Solution
36+
37+
1. Use an email address with a unique domain (for example, your organization's email).
38+
1. Alternatively, create a new user in Azure with a unique domain and assign subscription owner permissions.
39+
1. Retry the Astro installation from the Azure Marketplace.
Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,54 @@
1+
---
2+
title: Troubleshoot Astro Resource Creation in Azure
3+
description: Learn how to resolve issues when creating Astro resources in Azure, including permission and user profile requirements.
4+
author: ProfessorKendrick
5+
ms.author: jarrettr
6+
ms.reviewer: kkendrick
7+
ms.service: partner-services
8+
ms.topic: troubleshooting-problem-resolution
9+
ms.date: 09/04/2025
10+
ai-usage: ai-assisted
11+
12+
#customer intent: As an Azure administrator or user, I want to resolve issues when I create Astro resources so that I can successfully set up Astro integration.
13+
---
14+
15+
# Can't create Astro resource in Azure
16+
17+
This article helps you resolve common issues that you might encounter when you try to create Astro resources in Microsoft Azure. These issues include permission errors and missing user profile information.
18+
19+
## Prerequisites
20+
21+
- You must have **Owner** access on the Azure subscription to set up Astro integration.
22+
- Make sure that your user profile in Azure contains all required business information.
23+
24+
## Symptoms
25+
26+
- When you try to create an Astro resource, you receive an error message that indicates that you're not a subscription owner.
27+
- You can't create an Astro resource because of missing details in your user profile.
28+
29+
## Cause 1: Not a subscription owner
30+
31+
Only users who have _Owner_ access on the Azure subscription can set up the Astro integration.
32+
33+
### Solution 1
34+
35+
1. Verify your access level on the Azure subscription.
36+
1. If you don't have **Owner** access, ask your Azure administrator to grant you the required permissions before you start the integration setup.
37+
38+
## Cause 2: Missing details in user profile
39+
40+
Your user profile has to be updated to include key business information for Astro resource creation.
41+
42+
### Solution 2
43+
44+
1. In the Azure portal, select **Users**, and fill out the required details.
45+
46+
1. Search for your username in the user information screen.
47+
48+
1. Edit **UserInformation** to make sure that all required fields are completed.
49+
50+
## Additional troubleshooting
51+
52+
- If the deployment process takes more than three hours to complete, contact support.
53+
- If the deployment fails and the Astro resource has a status of **Failed**, delete the resource. After deletion, try to create the resource again.
54+
- If you get a **DeploymentFailed error**, check the status of your Azure subscription. Make sure it isn't suspended and doesn't have any billing issues.
Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
---
2+
title: Unable to use Single sign-on in Astronomer portal
3+
description: "Troubleshoot issues with Single sign-on (SSO) for the Astronomer portal in Azure, including consent and email requirements."
4+
author: ProfessorKendrick
5+
ms.author: jarrettr
6+
ms.reviewer: kkendrick
7+
ms.service: partner-services
8+
ms.topic: troubleshooting-problem-resolution
9+
ms.date: 09/04/2025
10+
ai-usage: ai-assisted
11+
12+
#customer intent: As an Azure administrator, I want to resolve SSO issues with Astronomer so that users can access the portal securely.
13+
14+
---
15+
16+
# Unable to use Single sign-on in Astronomer portal
17+
18+
This article helps you troubleshoot and resolve issues with Single sign-on (SSO) when accessing the Astronomer portal in Azure. If SSO isn't working, follow the steps in this guide to identify and fix common problems related to email, consent, and tenant settings.
19+
20+
## Prerequisites
21+
22+
- Access to the Azure subscription and Astronomer portal.
23+
- Microsoft Entra account credentials.
24+
- Admin permissions to review tenant consent settings.
25+
26+
## Symptoms
27+
28+
- Unable to sign in to the Astronomer portal using SSO.
29+
- Prompted for both Admin and User consent during first-time login.
30+
- Error messages related to email or consent.
31+
32+
## Cause
33+
34+
SSO issues can occur if you're using an incorrect email, haven't provided consent, or tenant settings prevent access.
35+
36+
## Solution
37+
38+
- Verify you're using the correct Microsoft Entra email for SSO.
39+
- Ensure you've consented to allow access for the Astronomer SaaS portal.
40+
- If you see both Admin and User consent screens during first-time login, check your tenant consent settings.
41+
- Refer to the [single sign-on documentation](/azure/partner-solutions/astronomer/manage) for additional troubleshooting steps.

0 commit comments

Comments
 (0)