Enable AL-Go for GitHub on GitHub Enterprise Cloud with data residency by freddydk · Pull Request #2309 · microsoft/AL-Go

Freddy Kristiansen (freddydk) · 2026-07-07T16:01:27Z

❔What, Why & How

This pull request introduces comprehensive updates to improve compatibility with GitHub Enterprise (GHE) hosts. The main focus is to ensure that all scripts and workflows dynamically use the correct GitHub server and API URLs, rather than hardcoding references to github.com and api.github.com. This enables repositories using AL-Go for GitHub to work seamlessly on both public GitHub and GHE instances. Additionally, documentation has been updated to clarify support and provide guidance for GHE users.

GitHub Enterprise compatibility and dynamic host resolution:

All PowerShell scripts and workflow files now use the GITHUB_SERVER_URL and GITHUB_API_URL environment variables instead of hardcoded github.com and api.github.com URLs for REST API calls and repository links. This affects actions such as dependency probing, deployments, pull request validation, and workflow post-processing. [1] [2] [3] [4] [5] [6] [7] [8] [9] [10]
The workflow now explicitly verifies that the AL-Go for GitHub repository itself only runs on github.com, preventing unsupported usage on GHE for the main repo.
The gh CLI commands set the GH_HOST environment variable to ensure API calls target the correct host on GHE. [1] [2] [3]

Documentation and user guidance:

Added a new scenario guide, Scenarios/UsingGitHubEnterprise.md, detailing how to use AL-Go for GitHub on GHE, including setup instructions and best practices.
The README.md is updated to reference the new GHE usage guide.
Release notes summarize the GHE compatibility improvements and clarify the support policy.

Other improvements and fixes:

Improved template repository download logic to construct API URLs correctly for both public GitHub and GHE, and to use authenticated or anonymous requests as appropriate. [1] [2] [3]
Minor comments and clarifications added to template scripts regarding authentication requirements.

These changes ensure that AL-Go for GitHub works reliably in both public and enterprise GitHub environments, with clear documentation and robust host detection.

This functionality was sponsored by Fellowmind, Sweden.

Updated instructions and add images

Freddy Kristiansen (freddydk) · 2026-07-07T16:03:41Z

@microsoft-github-policy-service agree

Copilot

Pull request overview

Enables AL-Go templates and actions to operate on GitHub Enterprise Cloud data-residency hosts.

Changes:

Replaces hardcoded GitHub URLs with runtime server/API URLs.
Updates release uploads, dependency retrieval, and template downloads for enterprise hosts.
Adds enterprise documentation, release notes, safeguards, and regression fixes.

Reviewed changes

Copilot reviewed 24 out of 24 changed files in this pull request and generated 7 comments.

Show a summary per file

File	Description
`Tests/DownloadProjectDependencies.Test.ps1`	Tests URL secrets.
`Tests/Deploy.Module.Test.ps1`	Configures API URL in tests.
`Templates/Per Tenant Extension/.github/workflows/CreateRelease.yaml`	Makes release operations host-aware.
`Templates/Per Tenant Extension/.AL-Go/localDevEnv.ps1`	Clarifies GitHub CLI authentication.
`Templates/AppSource App/.github/workflows/CreateRelease.yaml`	Makes release operations host-aware.
`Templates/AppSource App/.AL-Go/localDevEnv.ps1`	Clarifies GitHub CLI authentication.
`Scenarios/UsingGitHubEnterprise.md`	Adds enterprise setup guidance.
`RELEASENOTES.md`	Announces enterprise compatibility.
`README.md`	Links the enterprise guide.
`Actions/WorkflowPostProcess/WorkflowPostProcess.ps1`	Targets the active GitHub CLI host.
`Actions/VerifyPRChanges/VerifyPRChanges.ps1`	Uses the runtime API URL.
`Actions/PullRequestStatusCheck/PullRequestStatusCheck.ps1`	Targets the runtime GitHub host.
`Actions/Github-Helper.psm1`	Derives dependency API hosts.
`Actions/GetArtifactsForDeployment/GetArtifactsForDeployment.psm1`	Uses host-aware API and run URLs.
`Actions/GetArtifactsForDeployment/GetArtifactsForDeployment.ps1`	Produces host-aware links.
`Actions/DownloadProjectDependencies/DownloadProjectDependencies.psm1`	Resolves whole-URL secrets.
`Actions/DetermineProjectsToBuild/DetermineProjectsToBuild.psm1`	Initializes empty project metadata.
`Actions/DetermineProjectsToBuild/DetermineProjectsToBuild.Action.ps1`	Emits host-aware build links.
`Actions/Deploy/Deploy.psm1`	Uses the runtime API URL.
`Actions/Deliver/Deliver.ps1`	Handles package lookup failures.
`Actions/CheckForUpdates/CheckForUpdates.ps1`	Configures the GitHub CLI host.
`Actions/CheckForUpdates/CheckForUpdates.HelperFunctions.ps1`	Adds host-aware template downloads.
`Actions/AL-Go-Helper.ps1`	Updates defaults and dependency URLs.
`.github/workflows/CI.yaml`	Restricts AL-Go development CI to GitHub.com.

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

NSilvergrund

Working as expected.

Arend-Jan Kauffmann (ajkauffmann) · 2026-09-16T06:59:02Z

We are waiting for this! Having data residency for our codebase is paramount for us and our customers, so we need GitHub Enterprise. Without proper support from AL-Go, we can't move to GHE.

James Pearson (jimmymcp) · 2026-09-16T09:35:22Z

We've been running AL-Go on GHE with these changes for a couple of months. Would love to see this officially adopted.

Flemming Bakkensen (FBakkensen) · 2026-09-16T09:44:30Z

We are really waiting for this, using ghe is non-negotiable for us, and having to rely on a fork is far from ideal.

Copilot

Copilot review overview

🟡 Changes recommended

Cross-host credentials, local dependency URLs, and the GHE action bootstrap path remain incomplete.

Get a fresh assessment by requesting another Copilot review.

Review effort: Balanced
Findings: 3 · 1

Open (4)

Preserve repository host when creating local dependency URLs · New
Prevent workflow tokens from being sent to other hosts · New
This unrelated default change forces direct AL-Go users onto a mutable main.zip. It also disables…
Support mirroring AL-Go actions for GitHub Enterprise bootstrap · New

Resolved since last review (1)

appDependencyProbingPaths.repo accepts any HTTPS host (see Actions/AL-Go-Helper.ps1:929-938),…

Maria Zhelezova (mazhelez) · 2026-09-24T09:07:23Z

Freddy Kristiansen (@freddydk) Thank you for your contribution!

We are excited for AL-Go to support GHE. However, we are currently unable to test your solution properly and, while we figure out the setup, the feature has to marked as "preview" or "experimental".

Freddy Kristiansen (freddydk) · 2026-09-25T21:14:57Z

@microsoft-github-policy-service agree

### ❔What, Why & How Fixes #2389 URLs in localdevenv and the settings schema are wrong when running a self-hosted AL-Go from a fork. This fix is also included in PR #2309 (this is where the problem occured for partners using my fork) --------- Co-authored-by: Freddy Kristiansen <fkr@freddy.dk>

Alexander Holstrup (aholstrup1) · 2026-10-07T09:35:24Z

+### Include agentic workflows when updating system files from AL-Go or indirect templates
+
+Update AL-Go System Files will now also include .md files from .github/workflows. This is the recommended location for storing agentic workflows (.md files).


let's make this a separate effort? Doesn't really seem related to GitHub enterprise support

Correct, but the people using this will be broken if I remove it...
Will try to figure out what I can do - maybe create another branch they can use and then remove it from here.

Alexander Holstrup (aholstrup1) · 2026-10-07T09:35:55Z

+# Using AL-Go for GitHub on GitHub Enterprise (GHE)
+
+Repositories using AL-Go for GitHub are supported on **GitHub Enterprise Cloud with data residency** (also known as **GHE**, where your enterprise lives on a dedicated host like `https://<enterprise>.ghe.com`).


You could add a note in here that this is in preview (same way you did in the releasenotes)

Alexander Holstrup (aholstrup1) · 2026-10-07T09:45:17Z

+> [!NOTE]
+> The mirror-clone in step 2 reads from the **public** `github.com` template, which does not require authentication. Step 3 and step 4 target your enterprise host, using the credentials you authenticated with in step 1.
+
+## Automated approach


While this tool sounds very useful, I am not sure we are allowed to / should reference third-party tools in our docs like this.

Could we document it just with the manual steps for now?

Sure - will fix this - I will add a blog post about the tool then, no problem.

Copilot

🟡 Changes recommended

Anonymous cross-host release downloads remain broken, and local test execution has a missing server environment setup.

3 open findings

Anonymous dependency downloads reacquire an unscoped authentication token · New
Tests fail when GITHUB_SERVER_URL is undefined · New
Add test coverage for empty repository project detection · New

4 resolved since last review

Prevent workflow tokens from being sent to other hosts
Preserve repository host when creating local dependency URLs
This unrelated default change forces direct AL-Go users onto a mutable main.zip. It also disables…
Support mirroring AL-Go actions for GitHub Enterprise bootstrap

🧠 Review effort: Balanced

                    }
                }
-                $dependency | Add-Member -name "AuthTokenSecret" -MemberType NoteProperty -Value $token
+                $dependency | Add-Member -name "AuthTokenSecret" -MemberType NoteProperty -Value $useToken


    Write-Host "Checking PR Build status for run $RunId in repository $Repository"

    $workflowJobs = Invoke-CommandWithRetry -RetryCount 5 -FirstDelay 5 -MaxWaitBetweenRetries 60 -ScriptBlock {
+        $env:GH_HOST = ([Uri]$env:GITHUB_SERVER_URL).Host


+        # Initialize in case no projects are found
+        $projectBuildInfo = @{ projectDependencies = @{} }


Freddy Kristiansen (freddydk) · 2026-10-20T06:11:24Z

Closing this as it is being split in two PRs, where the data residency is here: #2407

Freddy Kristiansen (freddydk) added 8 commits July 7, 2026 07:36

allow CheckforUpdates to use GHE.COM

cd40611

set GH HOST

3965cd6

use host

5bcd2fe

remove dump

d4f4cd2

fix api calls and hardcoded hosts

d024570

add docs

843c306

Updated instructions and add images

85cadc6

Updated instructions and add images

Merge branch 'main' into main

74e6067

Freddy Kristiansen (freddydk) added 5 commits July 8, 2026 12:15

remove --

7f13d02

Merge branch 'main' of https://github.com/Freddy-DK/AL-Go

70514cc

add login

f49ce39

use github api url

26d2ce9

fix release and deployment for ghe

84f3fe6

Chris Blank (ChrisBlankDe) reviewed Jul 10, 2026

View reviewed changes

Comment thread Scenarios/UsingGitHubEnterprise.md Outdated

support internal dependencies from ghe

7643656

Maria Zhelezova (mazhelez) mentioned this pull request Jul 13, 2026

[Bug]: Failed to download dependency from GitHub packages #2316

Closed

Freddy Kristiansen (freddydk) added 7 commits July 14, 2026 16:25

Merge branch 'main' into main

f509309

ignore failure when getting nuget package

0a875e6

Merge branch 'main' of https://github.com/Freddy-DK/AL-Go

1e4e0f3

Fix cases where installapps is a secret and nothing else

c28527d

init

9e27a0a

save

236132a

Merge branch 'main' into main

651aefd

Copilot AI review requested due to automatic review settings July 27, 2026 16:33

Copilot started reviewing on behalf of Freddy Kristiansen (freddydk) July 27, 2026 16:34

View session

Copilot AI reviewed Jul 27, 2026

View reviewed changes

Potential fix for pull request finding

a13d7bc

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Copilot AI review requested due to automatic review settings July 29, 2026 05:53

Copilot started reviewing on behalf of Freddy Kristiansen (freddydk) July 29, 2026 05:54

View session

NSilvergrund approved these changes Sep 16, 2026

View reviewed changes

James Pearson (jimmymcp) approved these changes Sep 16, 2026

View reviewed changes

Flemming Bakkensen (FBakkensen) approved these changes Sep 16, 2026

View reviewed changes

Alexander Holstrup (aholstrup1) reviewed Sep 21, 2026

View reviewed changes

Comment thread Actions/AL-Go-Helper.ps1 Outdated

Comment thread Actions/AL-Go-Helper.ps1 Outdated

Comment thread Actions/AL-Go-Helper.ps1 Outdated

Comment thread Actions/Github-Helper.psm1

Comment thread Tests/DownloadProjectDependencies.Test.ps1

Alexander Holstrup (aholstrup1) requested a balanced review from Copilot September 21, 2026 07:56

Copilot started reviewing on behalf of Alexander Holstrup (aholstrup1) September 21, 2026 07:57

View session

Copilot AI reviewed Sep 21, 2026

View reviewed changes

Comment thread Actions/AL-Go-Helper.ps1 Outdated

Comment thread Actions/Github-Helper.psm1

Comment thread Scenarios/UsingGitHubEnterprise.md

Freddy Kristiansen (freddydk) added 2 commits September 25, 2026 19:50

use preview BcContainerHelper

cb71c06

use repositoryUrl instead of repository

c393264

Freddy Kristiansen (freddydk) added 5 commits September 25, 2026 23:15

Merge branch 'main' into main

857378a

release notes

0a4a4e8

Merge branch 'main' of https://github.com/Freddy-DK/AL-Go

14675d2

fix err

e855100

preview in releasenotes

6a99dac

Freddy Kristiansen (freddydk) requested a review from Alexander Holstrup (aholstrup1) September 29, 2026 04:24

fix urls

07a22c2

Freddy (Bunker) (FreundDK) mentioned this pull request Oct 2, 2026

fix URLs for self-hosted AL-Go #2388

Merged

Alexander Holstrup (aholstrup1) reviewed Oct 7, 2026

View reviewed changes

Maria Zhelezova (mazhelez) requested a balanced review from Copilot October 7, 2026 15:25

Copilot started reviewing on behalf of Maria Zhelezova (mazhelez) October 7, 2026 15:26

View session

Copilot AI reviewed Oct 7, 2026

View reviewed changes

Merge branch 'main' into main

d3aae97

Freddy Kristiansen (freddydk) closed this Oct 20, 2026

		### Include agentic workflows when updating system files from AL-Go or indirect templates

		Update AL-Go System Files will now also include .md files from .github/workflows. This is the recommended location for storing agentic workflows (.md files).

		# Using AL-Go for GitHub on GitHub Enterprise (GHE)

		Repositories using AL-Go for GitHub are supported on GitHub Enterprise Cloud with data residency (also known as GHE, where your enterprise lives on a dedicated host like `https://<enterprise>.ghe.com`).

		# Initialize in case no projects are found
		$projectBuildInfo = @{ projectDependencies = @{} }

Conversation

Freddy Kristiansen (freddydk) commented Jul 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

❔What, Why & How

Uh oh!

Freddy Kristiansen (freddydk) commented Jul 7, 2026

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

NSilvergrund left a comment

Choose a reason for hiding this comment

Uh oh!

Arend-Jan Kauffmann (ajkauffmann) commented Sep 16, 2026

Uh oh!

James Pearson (jimmymcp) commented Sep 16, 2026

Uh oh!

Flemming Bakkensen (FBakkensen) commented Sep 16, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Copilot review overview

🟡 Changes recommended

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Maria Zhelezova (mazhelez) commented Sep 24, 2026

Uh oh!

Freddy Kristiansen (freddydk) commented Sep 25, 2026

Uh oh!

Alexander Holstrup (aholstrup1) Oct 7, 2026

Choose a reason for hiding this comment

Uh oh!

Freddy Kristiansen (freddydk) Oct 15, 2026

Choose a reason for hiding this comment

Uh oh!

Alexander Holstrup (aholstrup1) Oct 7, 2026

Choose a reason for hiding this comment

Uh oh!

Freddy Kristiansen (freddydk) Oct 15, 2026

Choose a reason for hiding this comment

Uh oh!

Alexander Holstrup (aholstrup1) Oct 7, 2026

Choose a reason for hiding this comment

Uh oh!

Freddy Kristiansen (freddydk) Oct 15, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

🟡 Changes recommended

Uh oh!

Freddy Kristiansen (freddydk) commented Oct 20, 2026

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

9 participants

Freddy Kristiansen (freddydk) commented Jul 7, 2026 •

edited

Loading