Skip to content

Commit 1e51ada

Browse files
AndreasMothAndreasMoth
committed
Merge branch 'main' of https://github.com/microsoft/BCApps into private/anmoth/RemoveIncrementNoTextReferences
2 parents 1027b96 + d131030 commit 1e51ada

File tree

300 files changed

+674
-429
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

300 files changed

+674
-429
lines changed

‎.github/AL-Go-Settings.json

+4-9
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
"runs-on": "windows-latest",
66
"cacheImageName": "",
77
"UsePsSession": false,
8-
"artifact": "https://bcinsider-fvh2ekdjecfjd6gk.b02.azurefd.net/sandbox/27.0.31018.0/base",
8+
"artifact": "https://bcinsider-fvh2ekdjecfjd6gk.b02.azurefd.net/sandbox/27.0.31612.0/base",
99
"country": "base",
1010
"useProjectDependencies": true,
1111
"repoVersion": "27.0",
@@ -16,16 +16,11 @@
1616
],
1717
"settings": {
1818
"preprocessorSymbols": [
19-
"CLEAN17",
20-
"CLEAN18",
21-
"CLEAN19",
22-
"CLEAN20",
23-
"CLEAN21",
24-
"CLEAN22",
2519
"CLEAN23",
2620
"CLEAN24",
2721
"CLEAN25",
28-
"CLEAN26"
22+
"CLEAN26",
23+
"CLEAN27"
2924
]
3025
}
3126
},
@@ -92,7 +87,7 @@
9287
]
9388
},
9489
"UpdateALGoSystemFilesEnvironment": "Official-Build",
95-
"templateSha": "b608fc6787759aaac18f1407750c3436b6553b88",
90+
"templateSha": "6e5bf7752c8288a922c50393814925d794e9ec38",
9691
"commitOptions": {
9792
"messageSuffix": "Related to AB#539394",
9893
"pullRequestAutoMerge": true,

‎.github/RELEASENOTES.copy.md

+68-2
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,69 @@
1+
## preview
2+
3+
Note that when using the preview version of AL-Go for GitHub, we recommend you Update your AL-Go system files, as soon as possible when informed that an update is available.
4+
5+
### Deprecations
6+
7+
- `alwaysBuildAllProjects` will be removed after October 1st 2025. Please set the `onPull_Request` property of the `incrementalBuilds` setting to false to force full builds in Pull Requests.
8+
- `<workflow>Schedule` will be removed after October 1st 2025. The old setting, where the setting key was a combination of the workflow name and `Schedule` (dynamic setting key name) is deprecated. Instead you need to use a setting called [workflowSchedule](https://aka.ms/algosettings#workflowSchedule) and either use [Conditional Settings](https://aka.ms/algosettings#conditional-settings) or place the setting in a workflow specific settings file.
9+
10+
### Issues
11+
12+
- Issue 1433 Publish to Environment - DependencyInstallMode not found
13+
- Issue 1440 Create Release fails due to recent changes to the AL-Go
14+
- Issue 1330 CompilerFolder doesn't transfer installed Apps to NuGet resolution
15+
- Issue 1268 Do not throw an un-understandable error during nuGet download
16+
- Performance test sample code in 25.4 contains objects with ID 149201 and 149202, which are not renumbered
17+
- Issue 798 Publish To Environment breaks CI/CD pipelines
18+
- Issue 1182 Runs-on setting type is ambiguous - string or array
19+
20+
### New Workflow specific settings
21+
22+
- `workflowSchedule` - can be structure with a property named `cron`, which must be a valid crontab, defining the CRON schedule for when the specified workflow should run. Default is no scheduled runs, only manual triggers. Build your crontab string here: [https://crontab.guru](https://crontab.guru). You need to run the Update AL-Go System Files workflow for the schedule to take effect.<br/>**Note:** If you configure a WorkflowSchedule for the CI/CD workflow, AL-Go will stop triggering CICDs on push unless you have also added CICDPushBranches to your settings.<br/>**Note also:** If you define a schedule for Update AL-Go System Files, it uses direct Commit instead of creating a PR.
23+
- `workflowConcurrency` - is used to control concurrency of workflows. Like with the `workflowSchedule` setting, this setting should be applied in workflow specific settings files or conditional settings. By default, all workflows allows for concurrency, except for the Create Release workflow. If you are using incremental builds in CI/CD it is also recommented to set WorkflowConcurrency to:<br/>`[ "group: ${{ github.workflow }}-${{ github.ref }}", "cancel-in-progress: true" ]`<br />in order to cancel prior incremental builds on the same branch.<br />Read more about workflow concurrency [here](https://docs.github.com/en/actions/writing-workflows/choosing-what-your-workflow-does/control-the-concurrency-of-workflows-and-jobs).
24+
25+
### New Repository Settings
26+
27+
- `deployTo<environment>` now has two additional properties:
28+
- `includeTestAppsInSandboxEnvironment`, which deploys test apps and their dependencies to the specified sandbox environment if set to `true`. Deployment will fail if used on a Prod environment or if the test app has a dependency on Tests-TestLibraries. Default value is `false`.
29+
- `excludeAppIds`, which is an array of app ids which will be excluded from deployment. Default value is `[]`
30+
- `incrementalBuilds` - is a structure defining how you want AL-Go to handle incremental builds. When using incremental builds for a build, AL-Go will look for the latest successful build, newer than the defined `retentionDays` and only rebuild projects or apps (based on `mode`) which needs to be rebuilt. Properties in the structure includes:
31+
- `onPush` - set this property to **true** in order to enable incremental builds in CI/CD triggered by a merge/push event. Default is **false**.
32+
- `onPull_Request` - set this property to **false** in order to disable incremental builds in Pull Request workflows. Default is **true**.
33+
- `onSchedule` - set this property to **true** in order to enable incremental builds in CI/CD when running on a schedule. Default is **false**.
34+
- `retentionDays` - number of days a successful build is good (and can be used for incremental builds). Default is **30**.
35+
- `mode` - defines the mode for incremental builds. Currently, two values are supported. Use **modifiedProjects** when you want to rebuild all apps in modified projects and depending projects or **modifiedApps** if you only want to rebuild modified apps and depending apps.
36+
37+
> [!NOTE]
38+
> The projects mentioned here are AL-Go projects in a multi-project repository. A repository can contain multiple projects and a project can contain multiple apps.
39+
40+
### Run "Update AL-Go System Files" on multiple branches
41+
42+
_Update AL-Go System Files_ has a new input to specify a list of branches to be updated in a single workflow run.
43+
When running the workflow on a schedule, you can now also specify `includeBranches` in `workflowSchedule` setting, which allows you to update the specified branches. Read more at https://aka.ms/algosettings#workflowSchedule.
44+
45+
> [!NOTE]
46+
> When running "Update AL-Go System Files" on multiple branches, the template repository URL will be determined based on the branch the workflow runs on and it will be used for all of the specified branches.
47+
48+
### Support for incremental builds
49+
50+
AL-Go for GitHub now supports incremental builds, which means that unchanged projects or apps will be reused from the previous good build. Read [this](https://aka.ms/algosettings#incrementalBuilds) to learn more.
51+
52+
> [!NOTE]
53+
> When using incremental builds it is recommended to also set `workflowConcurrency` as defined [here](https://aka.ms/algosettings#workflowConcurrency).
54+
55+
### Support for GitHub App authentication
56+
57+
AL-Go for GitHub now supports using a GitHub App specification as the GhTokenWorkflow secret for a more secure way of allowing repositories to run Update AL-Go System Files and other workflows which are creating commits and pull requests. See [this description](https://github.com/microsoft/AL-Go/blob/main/Scenarios/GhTokenWorkflow.md) to learn how to use GitHub App authentication.
58+
59+
### Support for embedded secrets in installApps and installTestApps settings
60+
61+
If your installApps or installTestApps are secure URL, containing a secret token, you can now use a GitHub secret specification as part of or as the full URL of apps to install. An example could be:
62+
63+
`"installApps": [ "https://www.dropbox.com/${{SECRETNAME}}&dl=1" ]`
64+
65+
Which would hide the secret part of your URL instead of exposing it in clear text.
66+
167
## v6.3
268

369
### Deprecations
@@ -136,7 +202,7 @@ In the summary after a Test Run, you now also have the result of performance tes
136202
### Support Ubuntu runners for all AL-Go workflows
137203

138204
Previously, the workflows "Update AL-Go System Files" and "TroubleShooting" were hardcoded to always run on `windows-latest` to prevent deadlocks and security issues.
139-
From now on, `ubuntu-lates` will also be allowed for these mission critical workflows, when changing the `runs-on` setting. Additionally, only the value `pwsh` for `shell` setting is allowed when using `ubuntu-latest` runners.
205+
From now on, `ubuntu-latest` will also be allowed for these mission critical workflows, when changing the `runs-on` setting. Additionally, only the value `pwsh` for `shell` setting is allowed when using `ubuntu-latest` runners.
140206

141207
### Updated AL-Go telemetry
142208

@@ -629,7 +695,7 @@ In the latest version, we always use LF as line seperator, UTF8 without BOM and
629695
### Experimental Support
630696

631697
Setting the repo setting "shell" to "pwsh", followed by running Update AL-Go System Files, will cause all PowerShell code to be run using PowerShell 7 instead of PowerShell 5. This functionality is experimental. Please report any issues at https://github.com/microsoft/AL-Go/issues
632-
Setting the repo setting "runs-on" to "Ubuntu-Latest", followed by running Update AL-Go System Files, will cause all non-build jobs to run using Linux. This functionality is experimental. Please report any issues at https://github.com/microsoft/AL-Go/issues
698+
Setting the repo setting "runs-on" to "Ubuntu-latest", followed by running Update AL-Go System Files, will cause all non-build jobs to run using Linux. This functionality is experimental. Please report any issues at https://github.com/microsoft/AL-Go/issues
633699

634700
## v2.2
635701

‎.github/workflows/CICD.yaml

+40-22
Original file line numberDiff line numberDiff line change
@@ -39,13 +39,16 @@ jobs:
3939
githubRunner: ${{ steps.ReadSettings.outputs.GitHubRunnerJson }}
4040
githubRunnerShell: ${{ steps.ReadSettings.outputs.GitHubRunnerShell }}
4141
projects: ${{ steps.determineProjectsToBuild.outputs.ProjectsJson }}
42+
skippedProjects: ${{ steps.determineProjectsToBuild.outputs.SkippedProjectsJson }}
4243
projectDependenciesJson: ${{ steps.determineProjectsToBuild.outputs.ProjectDependenciesJson }}
4344
buildOrderJson: ${{ steps.determineProjectsToBuild.outputs.BuildOrderJson }}
44-
powerPlatformSolutionFolder: ${{ steps.DeterminePowerPlatformSolutionFolder.outputs.powerPlatformSolutionFolder }}
45+
baselineWorkflowRunId: ${{ steps.determineProjectsToBuild.outputs.BaselineWorkflowRunId }}
46+
baselineWorkflowSHA: ${{ steps.determineProjectsToBuild.outputs.BaselineWorkflowSHA }}
4547
workflowDepth: ${{ steps.DetermineWorkflowDepth.outputs.WorkflowDepth }}
48+
powerPlatformSolutionFolder: ${{ steps.DeterminePowerPlatformSolutionFolder.outputs.powerPlatformSolutionFolder }}
4649
steps:
4750
- name: Dump Workflow Information
48-
uses: microsoft/AL-Go-Actions/DumpWorkflowInfo@v6.3
51+
uses: microsoft/AL-Go/Actions/DumpWorkflowInfo@4dd210d3d780decee8e8b858fe216e559f7ce2bc
4952
with:
5053
shell: powershell
5154

@@ -56,21 +59,21 @@ jobs:
5659

5760
- name: Initialize the workflow
5861
id: init
59-
uses: microsoft/AL-Go-Actions/WorkflowInitialize@v6.3
62+
uses: microsoft/AL-Go/Actions/WorkflowInitialize@4dd210d3d780decee8e8b858fe216e559f7ce2bc
6063
with:
6164
shell: powershell
6265

6366
- name: Read settings
6467
id: ReadSettings
65-
uses: microsoft/AL-Go-Actions/ReadSettings@v6.3
68+
uses: microsoft/AL-Go/Actions/ReadSettings@4dd210d3d780decee8e8b858fe216e559f7ce2bc
6669
with:
6770
shell: powershell
6871
get: type,powerPlatformSolutionFolder,useGitSubmodules
6972

7073
- name: Read submodules token
7174
id: ReadSubmodulesToken
7275
if: env.useGitSubmodules != 'false' && env.useGitSubmodules != ''
73-
uses: microsoft/AL-Go-Actions/ReadSecrets@v6.3
76+
uses: microsoft/AL-Go/Actions/ReadSecrets@4dd210d3d780decee8e8b858fe216e559f7ce2bc
7477
with:
7578
shell: powershell
7679
gitHubSecrets: ${{ toJson(secrets) }}
@@ -91,7 +94,7 @@ jobs:
9194
9295
- name: Determine Projects To Build
9396
id: determineProjectsToBuild
94-
uses: microsoft/AL-Go-Actions/DetermineProjectsToBuild@v6.3
97+
uses: microsoft/AL-Go/Actions/DetermineProjectsToBuild@4dd210d3d780decee8e8b858fe216e559f7ce2bc
9598
with:
9699
shell: powershell
97100
maxBuildDepth: ${{ env.workflowDepth }}
@@ -104,23 +107,23 @@ jobs:
104107
105108
- name: Determine Delivery Target Secrets
106109
id: DetermineDeliveryTargetSecrets
107-
uses: microsoft/AL-Go-Actions/DetermineDeliveryTargets@v6.3
110+
uses: microsoft/AL-Go/Actions/DetermineDeliveryTargets@4dd210d3d780decee8e8b858fe216e559f7ce2bc
108111
with:
109112
shell: powershell
110113
projectsJson: '${{ steps.determineProjectsToBuild.outputs.ProjectsJson }}'
111114
checkContextSecrets: 'false'
112115

113116
- name: Read secrets
114117
id: ReadSecrets
115-
uses: microsoft/AL-Go-Actions/ReadSecrets@v6.3
118+
uses: microsoft/AL-Go/Actions/ReadSecrets@4dd210d3d780decee8e8b858fe216e559f7ce2bc
116119
with:
117120
shell: powershell
118121
gitHubSecrets: ${{ toJson(secrets) }}
119122
getSecrets: ${{ steps.DetermineDeliveryTargetSecrets.outputs.ContextSecrets }}
120123

121124
- name: Determine Delivery Targets
122125
id: DetermineDeliveryTargets
123-
uses: microsoft/AL-Go-Actions/DetermineDeliveryTargets@v6.3
126+
uses: microsoft/AL-Go/Actions/DetermineDeliveryTargets@4dd210d3d780decee8e8b858fe216e559f7ce2bc
124127
env:
125128
Secrets: '${{ steps.ReadSecrets.outputs.Secrets }}'
126129
with:
@@ -130,7 +133,7 @@ jobs:
130133

131134
- name: Determine Deployment Environments
132135
id: DetermineDeploymentEnvironments
133-
uses: microsoft/AL-Go-Actions/DetermineDeploymentEnvironments@v6.3
136+
uses: microsoft/AL-Go/Actions/DetermineDeploymentEnvironments@4dd210d3d780decee8e8b858fe216e559f7ce2bc
134137
env:
135138
GITHUB_TOKEN: ${{ github.token }}
136139
with:
@@ -146,16 +149,25 @@ jobs:
146149
uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
147150

148151
- name: Read settings
149-
uses: microsoft/AL-Go-Actions/ReadSettings@v6.3
152+
uses: microsoft/AL-Go/Actions/ReadSettings@4dd210d3d780decee8e8b858fe216e559f7ce2bc
150153
with:
151154
shell: powershell
152155
get: templateUrl
153156

157+
- name: Read secrets
158+
id: ReadSecrets
159+
uses: microsoft/AL-Go/Actions/ReadSecrets@4dd210d3d780decee8e8b858fe216e559f7ce2bc
160+
with:
161+
shell: powershell
162+
gitHubSecrets: ${{ toJson(secrets) }}
163+
getSecrets: 'ghTokenWorkflow'
164+
154165
- name: Check for updates to AL-Go system files
155-
uses: microsoft/AL-Go-Actions/CheckForUpdates@v6.3
166+
uses: microsoft/AL-Go/Actions/CheckForUpdates@4dd210d3d780decee8e8b858fe216e559f7ce2bc
156167
with:
157168
shell: powershell
158169
templateUrl: ${{ env.templateUrl }}
170+
token: ${{ fromJson(steps.ReadSecrets.outputs.Secrets).ghTokenWorkflow }}
159171
downloadLatest: true
160172

161173
Build1:
@@ -174,7 +186,10 @@ jobs:
174186
project: ${{ matrix.project }}
175187
projectName: ${{ matrix.projectName }}
176188
buildMode: ${{ matrix.buildMode }}
189+
skippedProjectsJson: ${{ needs.Initialization.outputs.skippedProjects }}
177190
projectDependenciesJson: ${{ needs.Initialization.outputs.projectDependenciesJson }}
191+
baselineWorkflowRunId: ${{ needs.Initialization.outputs.baselineWorkflowRunId }}
192+
baselineWorkflowSHA: ${{ needs.Initialization.outputs.baselineWorkflowSHA }}
178193
secrets: 'licenseFileUrl,codeSignCertificateUrl,*codeSignCertificatePassword,keyVaultCertificateUrl,*keyVaultCertificatePassword,keyVaultClientId,gitHubPackagesContext,applicationInsightsConnectionString'
179194
signArtifacts: true
180195
useArtifactCache: true
@@ -195,7 +210,10 @@ jobs:
195210
project: ${{ matrix.project }}
196211
projectName: ${{ matrix.projectName }}
197212
buildMode: ${{ matrix.buildMode }}
213+
skippedProjectsJson: ${{ needs.Initialization.outputs.skippedProjects }}
198214
projectDependenciesJson: ${{ needs.Initialization.outputs.projectDependenciesJson }}
215+
baselineWorkflowRunId: ${{ needs.Initialization.outputs.baselineWorkflowRunId }}
216+
baselineWorkflowSHA: ${{ needs.Initialization.outputs.baselineWorkflowSHA }}
199217
secrets: 'licenseFileUrl,codeSignCertificateUrl,*codeSignCertificatePassword,keyVaultCertificateUrl,*keyVaultCertificatePassword,keyVaultClientId,gitHubPackagesContext,applicationInsightsConnectionString'
200218
signArtifacts: true
201219
useArtifactCache: true
@@ -223,7 +241,7 @@ jobs:
223241
path: '.artifacts'
224242

225243
- name: Read settings
226-
uses: microsoft/AL-Go-Actions/ReadSettings@v6.3
244+
uses: microsoft/AL-Go/Actions/ReadSettings@4dd210d3d780decee8e8b858fe216e559f7ce2bc
227245
with:
228246
shell: powershell
229247

@@ -232,7 +250,7 @@ jobs:
232250
uses: actions/configure-pages@983d7736d9b0ae728b81ab479565c72886d7745b # v5.0.0
233251

234252
- name: Build Reference Documentation
235-
uses: microsoft/AL-Go-Actions/BuildReferenceDocumentation@v6.3
253+
uses: microsoft/AL-Go/Actions/BuildReferenceDocumentation@4dd210d3d780decee8e8b858fe216e559f7ce2bc
236254
with:
237255
shell: powershell
238256
artifacts: '.artifacts'
@@ -269,7 +287,7 @@ jobs:
269287
path: '.artifacts'
270288

271289
- name: Read settings
272-
uses: microsoft/AL-Go-Actions/ReadSettings@v6.3
290+
uses: microsoft/AL-Go/Actions/ReadSettings@4dd210d3d780decee8e8b858fe216e559f7ce2bc
273291
with:
274292
shell: ${{ matrix.shell }}
275293
get: type,powerPlatformSolutionFolder
@@ -283,15 +301,15 @@ jobs:
283301
284302
- name: Read secrets
285303
id: ReadSecrets
286-
uses: microsoft/AL-Go-Actions/ReadSecrets@v6.3
304+
uses: microsoft/AL-Go/Actions/ReadSecrets@4dd210d3d780decee8e8b858fe216e559f7ce2bc
287305
with:
288306
shell: ${{ matrix.shell }}
289307
gitHubSecrets: ${{ toJson(secrets) }}
290308
getSecrets: '${{ steps.envName.outputs.envName }}-AuthContext,${{ steps.envName.outputs.envName }}_AuthContext,AuthContext'
291309

292310
- name: Deploy to Business Central
293311
id: Deploy
294-
uses: microsoft/AL-Go-Actions/Deploy@v6.3
312+
uses: microsoft/AL-Go/Actions/Deploy@4dd210d3d780decee8e8b858fe216e559f7ce2bc
295313
env:
296314
Secrets: '${{ steps.ReadSecrets.outputs.Secrets }}'
297315
with:
@@ -303,7 +321,7 @@ jobs:
303321

304322
- name: Deploy to Power Platform
305323
if: env.type == 'PTE' && env.powerPlatformSolutionFolder != ''
306-
uses: microsoft/AL-Go-Actions/DeployPowerPlatform@v6.3
324+
uses: microsoft/AL-Go/Actions/DeployPowerPlatform@4dd210d3d780decee8e8b858fe216e559f7ce2bc
307325
env:
308326
Secrets: '${{ steps.ReadSecrets.outputs.Secrets }}'
309327
with:
@@ -331,20 +349,20 @@ jobs:
331349
path: '.artifacts'
332350

333351
- name: Read settings
334-
uses: microsoft/AL-Go-Actions/ReadSettings@v6.3
352+
uses: microsoft/AL-Go/Actions/ReadSettings@4dd210d3d780decee8e8b858fe216e559f7ce2bc
335353
with:
336354
shell: powershell
337355

338356
- name: Read secrets
339357
id: ReadSecrets
340-
uses: microsoft/AL-Go-Actions/ReadSecrets@v6.3
358+
uses: microsoft/AL-Go/Actions/ReadSecrets@4dd210d3d780decee8e8b858fe216e559f7ce2bc
341359
with:
342360
shell: powershell
343361
gitHubSecrets: ${{ toJson(secrets) }}
344362
getSecrets: '${{ matrix.deliveryTarget }}Context'
345363

346364
- name: Deliver
347-
uses: microsoft/AL-Go-Actions/Deliver@v6.3
365+
uses: microsoft/AL-Go/Actions/Deliver@4dd210d3d780decee8e8b858fe216e559f7ce2bc
348366
env:
349367
Secrets: '${{ steps.ReadSecrets.outputs.Secrets }}'
350368
with:
@@ -364,7 +382,7 @@ jobs:
364382

365383
- name: Finalize the workflow
366384
id: PostProcess
367-
uses: microsoft/AL-Go-Actions/WorkflowPostProcess@v6.3
385+
uses: microsoft/AL-Go/Actions/WorkflowPostProcess@4dd210d3d780decee8e8b858fe216e559f7ce2bc
368386
env:
369387
GITHUB_TOKEN: ${{ github.token }}
370388
with:

0 commit comments

Comments
 (0)