Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Updated setup Azure doc following Slack post #6087

Merged
merged 20 commits into from
Sep 20, 2024
Merged
Changes from 1 commit
Commits
Show all changes
20 commits
Select commit Hold shift + click to select a range
8fa1b61
Updated setup Azure doc following Slack post
nataliefiann Sep 18, 2024
61f8785
Update website/docs/docs/cloud/git/setup-azure.md
nataliefiann Sep 18, 2024
7e01e51
Update website/docs/docs/cloud/git/setup-azure.md
nataliefiann Sep 18, 2024
61a6a11
Update website/docs/docs/cloud/git/setup-azure.md
nataliefiann Sep 18, 2024
772d698
Update website/docs/docs/cloud/git/setup-azure.md
nataliefiann Sep 18, 2024
113baad
Updated doc to add an expandable
nataliefiann Sep 18, 2024
425945f
Update website/docs/docs/cloud/git/setup-azure.md
nataliefiann Sep 19, 2024
3259018
Merge branch 'current' into nfiann-ADOandSSO
mirnawong1 Sep 19, 2024
8ecf203
Update setup-azure.md
mirnawong1 Sep 19, 2024
fa4d460
Update website/docs/docs/cloud/git/setup-azure.md
nataliefiann Sep 19, 2024
fc47a9e
Update website/docs/docs/cloud/git/setup-azure.md
nataliefiann Sep 19, 2024
547bb44
Update website/docs/docs/cloud/git/setup-azure.md
nataliefiann Sep 19, 2024
3cbda5a
Update website/docs/docs/cloud/git/setup-azure.md
nataliefiann Sep 19, 2024
e85f040
Update website/docs/docs/cloud/git/setup-azure.md
mirnawong1 Sep 19, 2024
379641c
Update website/docs/docs/cloud/git/setup-azure.md
nataliefiann Sep 19, 2024
a381c3b
Merge branch 'current' into nfiann-ADOandSSO
nataliefiann Sep 19, 2024
867c129
Update website/docs/docs/cloud/git/setup-azure.md
nataliefiann Sep 19, 2024
9a32b42
Update website/docs/docs/cloud/git/setup-azure.md
nataliefiann Sep 19, 2024
e802ce2
Merge branch 'current' into nfiann-ADOandSSO
nataliefiann Sep 20, 2024
3df1671
Merge branch 'current' into nfiann-ADOandSSO
nataliefiann Sep 20, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 6 additions & 5 deletions website/docs/docs/cloud/git/setup-azure.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ To use our native integration with Azure DevOps in dbt Cloud, an account admin n
4. [Connect Azure DevOps to your new app](#connect-azure-devops-to-your-new-app).
5. [Add your Entra ID app to dbt Cloud](#add-your-azure-ad-app-to-dbt-cloud).

Once the Microsoft Entra ID app is added to dbt Cloud, an account admin must also [connect a service user](#connecting-a-service-user) via OAuth, which will be used to power headless actions in dbt Cloud such as deployment runs and CI.
Once the Microsoft Entra ID app is added to dbt Cloud, an account admin must also [connect a service user](/docs/cloud/git/setup-azure#connect-a-service-user) via OAuth, which will be used to power headless actions in dbt Cloud such as deployment runs and CI.


Once the Microsoft Entra ID app is added to dbt Cloud and the service user is connected, then dbt Cloud developers can personally authenticate in dbt Cloud from Azure DevOps. For more on this, see [Authenticate with Azure DevOps](/docs/cloud/git/authenticate-azure).
Expand Down Expand Up @@ -363,10 +363,11 @@ az devops security permission update --organization https://dev.azure.com/<org_n

You must connect your service user before setting up a dbt Cloud project, as the service user's permissions determine which projects dbt Cloud can import.

A dbt Cloud account admin with access to the service user's Azure DevOps account must complete the following to connect the service user:
1. Sign in to the service user's Azure DevOps account.
2. In dbt Cloud, click **Link Azure Service User**.
3. You will be directed to Azure DevOps and must accept the Microsoft Entra ID app's permissions.
When using Azure AD to SSO to connect to dbt Cloud, and also SSO to your MS tools, a dbt Cloud account admin with access to the service user's Azure DevOps account must complete the following to connect the service user:
nataliefiann marked this conversation as resolved.
Show resolved Hide resolved
nataliefiann marked this conversation as resolved.
Show resolved Hide resolved
1. Sign into the service user's Azure DevOps account.
2. When connected to dbt Cloud, sign out of Azure AD by visiting the [Azure Portal](https://portal.azure.com/).
nataliefiann marked this conversation as resolved.
Show resolved Hide resolved
3. From there, disconnect the service user in dbt Cloud, and go through the steps to set it up again.
nataliefiann marked this conversation as resolved.
Show resolved Hide resolved
4. You should then be prompted for the service user's credentials.
nataliefiann marked this conversation as resolved.
Show resolved Hide resolved
4. Finally, you will be redirected to dbt Cloud, and the service user will be connected.

<Lightbox src="/img/docs/dbt-cloud/connecting-azure-devops/azure-service-user.png" title="Connecting an Azure Service User"/>
Expand Down
Loading