Skip to content

Commit 008f767

Browse files
authored
Update README.md for Deploy
Added the instructions to deploy using Azure DevOps
1 parent cdb2140 commit 008f767

File tree

1 file changed

+42
-34
lines changed

1 file changed

+42
-34
lines changed

deploy/README.md

Lines changed: 42 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -1,72 +1,78 @@
1-
1. In your ADO organization you first need to install `Power BI Actions`. [Power BI Actions Extension!](https://marketplace.visualstudio.com/items?itemName=maikvandergaag.maikvandergaag-power-bi-actions)
1+
# Deployment
22

3-
![Screenshot 2024-07-17 at 8.19.15 AM.png](/.attachments/Screenshot%202024-07-17%20at%208.19.15 AM-062f9c11-0286-4e88-9ac1-da90eabad8c5.png =600x)
3+
The report can be deployed many different ways. Publishing from PowerBI Desktop is likely the fastest. For a more automated version which would include report version, you should use a repository. Below are the instructions on how to deploy your report in Azure DevOps repos, into your Power BI Workspace using a Azure DevOps Pipeline.
44

5-
1. Get the PBI Workspace ID. Open Powershell in Administrative Mode and run:
6-
### Install Power BI Management module
5+
### Installing the ADO Extension
6+
7+
Install the extension
8+
These instructions will show you how to install the Power BI Action extension that we are going to use for this tutorial,
9+
10+
1. Sign in to your Azure DevOps organization.
11+
1. Go to Organization Settings.
12+
1. Select Extensions.
13+
1. Click on Browse Marketplace at the top right.
14+
1. Search for and install `Power BI Actions`. [Power BI Actions Extension!](https://marketplace.visualstudio.com/items?itemName=maikvandergaag.maikvandergaag-power-bi-actions)
15+
<img width="600" alt="Screenshot 2024-07-17 at 8 19 15 AM" src="https://github.com/user-attachments/assets/c79c98c2-55a4-4772-ba62-8cccc7a83bef">
16+
17+
18+
### Get the PBI Workspace ID. Open Powershell in Administrative Mode and run:
19+
1. Install Power BI Management module
720
`Install-Module -Name MicrosoftPowerBIMgmt -Scope CurrentUser -Force`
821

9-
### Sign in to Power BI
22+
1. Sign in to Power BI
1023
`Login-PowerBI`
1124

12-
### List all workspaces
25+
3. List all workspaces
1326
`Get-PowerBIWorkspace -Scope Organization`
1427

15-
Write down the Workpace ID:
28+
Write down the Workpace ID and save it for later
1629

17-
#Create the App Registration
30+
### Create the App Registration
1831
1. Go to Entra AD
19-
![Screenshot 2024-07-17 at 8.04.48 AM.png](/.attachments/Screenshot%202024-07-17%20at%208.04.48 AM-41944f47-aaab-415b-9cb9-e75ab5ec5967.png =600x)
32+
<img width="600" alt="Screenshot 2024-07-17 at 8 04 48 AM" src="https://github.com/user-attachments/assets/1f4af117-5383-42cb-8403-1f59c162486e">
33+
2034
1. Set `API Permissions -> Add a permission`
2135
1. Power BI Service
2236
1. Chose Delegated permissions
2337
1. Chose:
2438
- Tenant.Read.All
2539
- Tenant.ReadWrite.All
2640
- Report.ReadWrite.All
27-
![Screenshot 2024-07-17 at 8.06.50 AM.png](/.attachments/Screenshot%202024-07-17%20at%208.06.50 AM-f9a7ce5a-6e64-4475-a4ec-eaec70089f50.png =600x)
41+
<img width="600" alt="Screenshot 2024-07-17 at 8 06 50 AM" src="https://github.com/user-attachments/assets/238ed9b4-6caa-4f2c-8b13-4c0893dd4c67">
2842

29-
#Power BI
43+
### Power BI
3044

3145
Setting up the tenant
3246
The next step is to configure your Power BI,
3347

3448
1. Sign in to the Power BI portal.
3549
1. Click the gear icon on the top right and select Admin portal.
3650
1. Select the Tenant settings and scroll down to Developer Settings and allow service principals to use Power BI APIs
37-
![Screenshot 2024-07-17 at 7.53.01 AM.png](/.attachments/Screenshot%202024-07-17%20at%207.53.01 AM-79bb65df-dfc9-4989-86c1-146f60b49600.png)
51+
<img width="600" alt="Screenshot 2024-07-17 at 7 53 01 AM" src="https://github.com/user-attachments/assets/cb52ca8c-ada2-4446-ba43-b973f16bdcce">
3852

39-
#Configure a workspace
53+
### Configure a workspace
4054
Now create the workspace where your pipeline will publish the reports and grant permission to your Azure AD App to do this,
4155

4256
1. Select Workspaces tab.
4357
1. Click the three vertical dots on the right of your new workspace.
4458
1. Click Manage access.
45-
![Screenshot 2024-07-17 at 8.02.30 AM.png](/.attachments/Screenshot%202024-07-17%20at%208.02.30 AM-5acc2b30-bb83-4bbb-88d1-153c2f4216fd.png)
46-
47-
1. Search the app that you have previously registered in Azure AD and grant it the permission of **Admin**.
48-
![Screenshot 2024-07-17 at 7.58.15 AM.png](/.attachments/Screenshot%202024-07-17%20at%207.58.15 AM-361bfcf7-4837-4d56-8918-87514c7286b7.png =600x)
59+
<img width="600" alt="Screenshot 2024-07-17 at 8 02 30 AM" src="https://github.com/user-attachments/assets/9cdcbc1e-a790-4c82-b0c5-c62277af104c">
60+
61+
4. Search the app that you have previously registered in Azure AD and grant it the permission of **Admin**.
62+
<img width="600" alt="Screenshot 2024-07-17 at 7 58 15 AM" src="https://github.com/user-attachments/assets/5fed83f5-491b-4098-96fe-4a99fd8ba4bc">
4963

50-
#Azure DevOps
51-
52-
Install the extension
53-
These instructions will show you how to install the Power BI Action extension that we are going to use for this tutorial,
54-
55-
1. Sign in to your Azure DevOps organization.
56-
1. Go to Organization Settings.
57-
1. Select Extensions.
58-
1. Click on Browse Marketplace at the top right.
59-
60-
#Create a new service connection
64+
### Create a new service connection
6165
1. Go to Project Settings.
6266
1. Select Service connections.
6367
1. Click the New service connection button and select Power BI Service Connection.
64-
![Screenshot 2024-07-17 at 8.11.27 AM.png](/.attachments/Screenshot%202024-07-17%20at%208.11.27 AM-e5f10640-66ba-4961-b4bc-88a33760cd22.png =600x)
65-
1. Fill in the parameters for the service connection and allow all pipelines to use this connection option.
68+
<img width="600" alt="Screenshot 2024-07-17 at 8 11 27 AM" src="https://github.com/user-attachments/assets/b5dd095f-c210-43b5-b041-a00587b79226">
69+
70+
4. Fill in the parameters for the service connection and allow all pipelines to use this connection option. Be sure to pick the type of _Service Principal_
6671
1. Click OK to create the connection.
67-
![Screenshot 2024-07-17 at 8.14.41 AM.png](/.attachments/Screenshot%202024-07-17%20at%208.14.41 AM-99f4ceb3-9e59-4c91-a105-3a32532f7248.png =600x)
72+
<img width="600" alt="Screenshot 2024-07-17 at 8 14 41 AM" src="https://github.com/user-attachments/assets/01b6f4c9-3290-4de4-b076-b7a5fdd1c757">
6873

69-
#Creating the Build Pipeline
74+
75+
### Creating the Build Pipeline
7076
It is time to create your build pipeline.
7177

7278
1. From the dashboard, select Pipelines.
@@ -78,7 +84,9 @@ It is time to create your build pipeline.
7884
- AppSecret
7985
- TenantId
8086
- WorkspaceId
81-
![Screenshot 2024-07-17 at 8.16.38 AM.png](/.attachments/Screenshot%202024-07-17%20at%208.16.38 AM-5668d9bb-fda4-4102-95c9-84f6f8418a29.png =600x)
87+
<img width="600" alt="Screenshot 2024-07-17 at 8 16 38 AM" src="https://github.com/user-attachments/assets/0bbe7b5b-697c-4d4b-8f94-d8c8f8994903">
88+
89+
8290

8391
1. Add the following YAML snippet to your pipeline
8492
``` yaml
@@ -121,7 +129,7 @@ Deploy PBIX file using PowerShell with Service Principal Authentication
121129
# Note: Ensure that the necessary modules and credentials are correctly set up for this script to work.
122130
displayName: 'Deploy PBIX file to Power BI Workspace using PowerShell'
123131
```
124-
The remaining step is to save, check-in, and then watch it automatically deply
132+
The remaining step is to save, check-in, and then watch it automatically deploy as the trigger is set to monitor the main branch
125133
126134
127135

0 commit comments

Comments
 (0)