You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/boards/github/install-github-app.md
+18-18Lines changed: 18 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -43,11 +43,11 @@ Your installation sequence might vary due to your account configuration. If nece
43
43
44
44
This example uses **All repositories**:
45
45
46
-
:::image type="content" source="media/github-app/install-options.png" alt-text="Screenshot showing all repositories selected.":::
46
+
:::image type="content" source="media/github-app/install-options.png" alt-text="Screenshot shows Install and Authorize page with all repositories selected.":::
47
47
48
48
1. Choose the Azure DevOps organization and Azure Boards project you want to connect to GitHub.com.
49
49
50
-
:::image type="content" source="media/github-app/choose-azure-boards-project.png" alt-text="Screenshot of setting up connection dialog.":::
50
+
:::image type="content" source="media/github-app/choose-azure-boards-project.png" alt-text="Screenshot shows the Setup your Azure Boards project page where you select an org and project.":::
51
51
52
52
You can only connect one project at a time. If you have other projects you want to connect, you can do that later as described in [Configure other projects or repositories](#configure) later in this article.
53
53
@@ -59,17 +59,17 @@ If necessary, to grant GitHub access to your Azure DevOps organization, do the f
59
59
60
60
1. From the GitHub web portal, open **Settings** from your profile menu.
61
61
62
-
:::image type="content" source="media/troubleshoot/choose-settings.png" alt-text="Screenshot of open profile, choose Settings.":::
62
+
:::image type="content" source="media/troubleshoot/choose-settings.png" alt-text="Screenshot shows the Settings option in your profile.":::
63
63
64
64
1. Select **Applications** under **Integrations**.
1. Under **Organization access**, resolve any issues that might appear. Select **Grant** to grant access to any organizations that show as having an **Access request pending**.
71
71
72
-
:::image type="content" source="media/troubleshoot/organization-access-issues.png" alt-text="Screenshot of Organization access with organizations without access.":::
72
+
:::image type="content" source="media/troubleshoot/organization-access-issues.png" alt-text="Screenshot shows Organization access with organizations without access.":::
73
73
74
74
<aid="install"></a>
75
75
@@ -86,7 +86,7 @@ At this point, your Azure Boards-GitHub integration is complete. You can skip th
86
86
1. Select the repository and enter the pull request ID and an optional comment.
87
87
1. Select **Add link**.
88
88
89
-
:::image type="content" source="media/troubleshoot/add-link-to-pull-request-2.png" alt-text="Screenshot of Add link action in user story, showing repository selection and empty boxes for input of pull request ID and optional comment.":::
89
+
:::image type="content" source="media/troubleshoot/add-link-to-pull-request-2.png" alt-text="Screenshot shows Add link action in user story, showing repository selection and empty boxes for input of pull request ID and optional comment.":::
90
90
91
91
The following actions occur in the background, automatically:
92
92
@@ -97,17 +97,17 @@ At this point, your Azure Boards-GitHub integration is complete. You can skip th
97
97
98
98
1. Select the first pull request link from your work item.
99
99
100
-
:::image type="content" source="media/github-app/issue-add-badge.png" alt-text="Screenshot of issue form for pull request opened in GitHub.":::
100
+
:::image type="content" source="media/github-app/issue-add-badge.png" alt-text="Screenshot shows the issue form for pull request opened in GitHub.":::
101
101
102
102
The GitHub pull request opens in a new browser tab.
103
103
104
104
1. Select **Merge pull request**.
105
105
106
-
:::image type="content" source="media/github-app/git-hub-pr-for-badge-b.png" alt-text="Screenshot of example pull request in GitHub.":::
106
+
:::image type="content" source="media/github-app/git-hub-pr-for-badge-b.png" alt-text="Screenshot shows the example pull request in GitHub.":::
107
107
108
108
1. Go to your repository README file and view the badge that was added.
109
109
110
-
:::image type="content" source="media/github-app/readme-file-with-badge.png" alt-text="Screenshot of GitHub repo with badge added.":::
110
+
:::image type="content" source="media/github-app/readme-file-with-badge.png" alt-text="Screenshot shows the GitHub repo with badge added.":::
111
111
112
112
For more information, see [Add status badges for your GitHub repo](configure-status-badges.md).
113
113
@@ -127,13 +127,13 @@ If you encounter a problem with a connection, we recommend that you remove the c
127
127
128
128
1. From your project in Azure DevOps, go to **Project settings** > **GitHub connections**.
129
129
130
-
1. To add or remove repositories, select the **More options** ellipses for the connection and choose **Add repositories** or **Remove repositories** from the menu.
130
+
1. To add or remove repositories, select the **More options** ellipses for the connection and choose **Add repositories** or **Remove repositories** from the menu.
131
131
132
-
:::image type="content" source="media/connect-cloud/connection-menu.png" alt-text="Screenshot of GitHub connection menu of More options.":::
132
+
:::image type="content" source="media/connect-cloud/connection-menu.png" alt-text="Screenshot shows the GitHub connection menu of More options.":::
133
133
134
134
1. To remove all repositories and the connection, choose the **Remove connection** option. Then, choose **Remove** to confirm.
135
135
136
-
:::image type="content" source="media/github/remove-connection-confirmation.png" alt-text="Screenshot of confirmation removal of GitHub connection.":::
136
+
:::image type="content" source="media/github/remove-connection-confirmation.png" alt-text="Screenshot shows the confirmation removal of GitHub connection.":::
137
137
138
138
::: moniker-end
139
139
@@ -143,7 +143,7 @@ If you encounter a problem with a connection, we recommend that you remove the c
:::image type="content" source="media/change-repo-access/open-installed-github-apps.png" alt-text="Screenshot of open Organization account, Installed GitHub Apps, Azure Boards, Configure.":::
146
+
:::image type="content" source="media/change-repo-access/open-installed-github-apps.png" alt-text="Screenshot shows the Installed GitHub Apps with Azure Boards and the Configure option.":::
147
147
148
148
The Azure Boards configuration page opens.
149
149
@@ -153,33 +153,33 @@ If you encounter a problem with a connection, we recommend that you remove the c
153
153
154
154
If you choose **Only select repositories**, select the repositories you want to participate in integration with Azure Boards.
155
155
156
-
:::image type="content" source="media/change-repo-access/choose-repositories.png" alt-text="Screenshot of Repository access, choose Only select repositories.":::
156
+
:::image type="content" source="media/change-repo-access/choose-repositories.png" alt-text="Screenshot shows the Repository access, where you can choose selected repositories.":::
157
157
158
158
1. Select **Save**.
159
159
160
160
## Suspend or uninstall Azure Boards integration
161
161
162
162
1. Starting from step 2 in the previous procedure, scroll down to the **Danger zone** section.
163
163
164
-
:::image type="content" source="media/change-repo-access/danger-zone.png" alt-text="Screenshot of Azure Boards configuration, Danger zone section.":::
164
+
:::image type="content" source="media/change-repo-access/danger-zone.png" alt-text="Screenshot shows the Danger zone section, with options to suspend and uninstall.":::
165
165
166
166
1. To suspend the integration, choose **Suspend**. From the confirmation window, choose **OK** to confirm the suspension.
167
167
168
-
:::image type="content" source="media/change-repo-access/suspend-confirmation-popup.png" alt-text="Screenshot of suspension confirmation.":::
168
+
:::image type="content" source="media/change-repo-access/suspend-confirmation-popup.png" alt-text="Screenshot shows the suspension confirmation dialog.":::
169
169
170
170
To unsuspend the integration, choose **Unsuspend**.
171
171
172
172
1. To uninstall the Azure Boards app, choose **Uninstall**, and then choose **OK** from the popup confirmation window.
173
173
174
-
:::image type="content" source="media/change-repo-access/uninstall-confirmation-popup.png" alt-text="Screenshot of uninstall confirmation.":::
174
+
:::image type="content" source="media/change-repo-access/uninstall-confirmation-popup.png" alt-text="Screenshot shows the uninstall confirmation dialog.":::
175
175
176
176
## Update Azure Boards-GitHub connections
177
177
178
178
If you change the repositories that the Azure Boards app for GitHub supports, you might get redirected to Azure Boards GitHub connections. A good practice is to remove the repositories in Azure Boards that can no longer connect to GitHub. For more information, see [Add or remove GitHub repositories](#add-remove-repos).
179
179
180
180
If you uninstall the Azure Boards app for GitHub, the following message displays in Azure Boards, **Project settings** > **GitHub** connections. Choose **Remove connection** to remove all previously made GitHub connections. For more information, see [Add or remove GitHub repositories](#add-remove-repos).
181
181
182
-
:::image type="content" source="media/change-repo-access/boards-remove-connection.png" alt-text="Screenshot of uninstalled Azure Boards GitHub app.":::
0 commit comments