From 445511769f57c6ab7ee4c3d5c5036c1250c56d38 Mon Sep 17 00:00:00 2001 From: Jake Taylor <147415933+jrtaylorJH@users.noreply.github.com> Date: Fri, 5 Jan 2024 10:36:44 -0600 Subject: [PATCH 1/4] Update github-apps.md Provide information on troubleshooting a specific error with GitHub Apps integration Signed-off-by: Jake Taylor <147415933+jrtaylorJH@users.noreply.github.com> --- docs/integrations/github/github-apps.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/docs/integrations/github/github-apps.md b/docs/integrations/github/github-apps.md index cc84704799..495f789f7e 100644 --- a/docs/integrations/github/github-apps.md +++ b/docs/integrations/github/github-apps.md @@ -139,3 +139,13 @@ integration: - `Variables`: `Read & write` (if templates include GitHub Action Repository Variables) - `Secrets`: `Read & write` (if templates include GitHub Action Repository Secrets) - `Environments`: `Read & write` (if templates include GitHub Environments) + + ### Troubleshooting + + `HttpError: This endpoint requires you to be authenticated.` + +This message tends to wrap a `NotFoundError: No app installation found` under the hood, which +is the reuslt of not installing the app in your organization. Even if created via the `backstage-cli` +as a member and app manager of your organization, the app will not automatically install. You +must posses the `Owner` role in the organization to see the `Install` menu under your +app settings, then manually press `Install` to authorize the application. From 5de1455df0de0b6cb828b66501bc4df7aae19d9a Mon Sep 17 00:00:00 2001 From: Jake Taylor <147415933+jrtaylorJH@users.noreply.github.com> Date: Fri, 5 Jan 2024 10:38:52 -0600 Subject: [PATCH 2/4] Update github-apps.md Fix indentation Signed-off-by: Jake Taylor <147415933+jrtaylorJH@users.noreply.github.com> --- docs/integrations/github/github-apps.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/integrations/github/github-apps.md b/docs/integrations/github/github-apps.md index 495f789f7e..5e55e638ff 100644 --- a/docs/integrations/github/github-apps.md +++ b/docs/integrations/github/github-apps.md @@ -140,9 +140,9 @@ integration: - `Secrets`: `Read & write` (if templates include GitHub Action Repository Secrets) - `Environments`: `Read & write` (if templates include GitHub Environments) - ### Troubleshooting +### Troubleshooting - `HttpError: This endpoint requires you to be authenticated.` +`HttpError: This endpoint requires you to be authenticated.` This message tends to wrap a `NotFoundError: No app installation found` under the hood, which is the reuslt of not installing the app in your organization. Even if created via the `backstage-cli` From fe30d259228002a725820166d5c5384919b15f2e Mon Sep 17 00:00:00 2001 From: Jake Taylor <147415933+jrtaylorJH@users.noreply.github.com> Date: Fri, 5 Jan 2024 11:21:30 -0600 Subject: [PATCH 3/4] Update docs/integrations/github/github-apps.md Co-authored-by: Andre Wanlin <67169551+awanlin@users.noreply.github.com> Signed-off-by: Jake Taylor <147415933+jrtaylorJH@users.noreply.github.com> --- docs/integrations/github/github-apps.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/integrations/github/github-apps.md b/docs/integrations/github/github-apps.md index 5e55e638ff..bdff95c8e9 100644 --- a/docs/integrations/github/github-apps.md +++ b/docs/integrations/github/github-apps.md @@ -145,7 +145,7 @@ integration: `HttpError: This endpoint requires you to be authenticated.` This message tends to wrap a `NotFoundError: No app installation found` under the hood, which -is the reuslt of not installing the app in your organization. Even if created via the `backstage-cli` +is the result of not installing the app in your organization. Even if created via the `backstage-cli` as a member and app manager of your organization, the app will not automatically install. You must posses the `Owner` role in the organization to see the `Install` menu under your app settings, then manually press `Install` to authorize the application. From 57c115c86b29eb18d84a70f646996d123f24ba30 Mon Sep 17 00:00:00 2001 From: Jake Taylor <147415933+jrtaylorJH@users.noreply.github.com> Date: Tue, 16 Jan 2024 14:00:49 -0600 Subject: [PATCH 4/4] Update docs/integrations/github/github-apps.md Co-authored-by: Frank Kong <50030060+Zaperex@users.noreply.github.com> Signed-off-by: Jake Taylor <147415933+jrtaylorJH@users.noreply.github.com> --- docs/integrations/github/github-apps.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/integrations/github/github-apps.md b/docs/integrations/github/github-apps.md index bdff95c8e9..96363bc719 100644 --- a/docs/integrations/github/github-apps.md +++ b/docs/integrations/github/github-apps.md @@ -147,5 +147,5 @@ integration: This message tends to wrap a `NotFoundError: No app installation found` under the hood, which is the result of not installing the app in your organization. Even if created via the `backstage-cli` as a member and app manager of your organization, the app will not automatically install. You -must posses the `Owner` role in the organization to see the `Install` menu under your +must possess the `Owner` role in the organization to see the `Install` menu under your app settings, then manually press `Install` to authorize the application.