|
| 1 | +## v7.3 |
| 2 | + |
| 3 | +### Configurable merge method for pull request auto-merge |
| 4 | + |
| 5 | +A new setting `pullRequestMergeMethod` has been added to the `commitOptions` structure, allowing you to configure which merge method to use when `pullRequestAutoMerge` is enabled. Valid values are "merge" or "squash". The default value is "squash" to maintain backward compatibility. |
| 6 | + |
| 7 | +Example |
| 8 | + |
| 9 | +```json |
| 10 | +{ |
| 11 | + "commitOptions": { |
| 12 | + "pullRequestAutoMerge": true, |
| 13 | + "pullRequestMergeMethod": "merge" |
| 14 | + } |
| 15 | +} |
| 16 | +``` |
| 17 | + |
| 18 | +### AL-Go Telemetry |
| 19 | + |
| 20 | +AL-Go now offers a dataexplorer dashboard to get started with AL-Go telemetry. Additionally, we've updated the documentation to include a couple of kusto queries if you would rather build your own reports. |
| 21 | + |
| 22 | +### Support for AL-Go settings as GitHub environment variable: ALGoEnvSettings |
| 23 | + |
| 24 | +AL-Go settings can now be defined in GitHub environment variables. To use this feature, create a new variable under your GitHub environment called `ALGoEnvironmentSettings`. Please note that this variable should not include your environment name. |
| 25 | + |
| 26 | +Settings loaded this way, will only be available during the Deploy step of the CI/CD or Publish to Environment actions, but not the Build step, making it most suitable for the [DeployTo setting](https://aka.ms/algosettings#deployto). Settings defined in this variable will take priority over any setting defined in AL-Go repo, org or settings files. |
| 27 | + |
| 28 | +The contents of the variable should be a JSON block, similar to any other settings file or variable. When defining the `DeployTo\<EnvName>` setting in this variable, it should still include the environment name. Eg: |
| 29 | + |
| 30 | +``` |
| 31 | +{ |
| 32 | + DeployToProduction { |
| 33 | + "Branches": [ |
| 34 | + "*" |
| 35 | + ], |
| 36 | + "includeTestAppsInSandboxEnvironment": false, |
| 37 | + "excludeAppIds": [ 1234 ] |
| 38 | + } |
| 39 | +} |
| 40 | +``` |
| 41 | + |
| 42 | +Please note, that due to certain security limitations, the properties `runs-on`, `shell` and `ContinousDeployment` of the `DeployTo` setting will <ins>**NOT**</ins> be respected if defined in a GitHub environment variable. To use these properties, please keep them defined elsewhere, such as your AL-Go settings file or Org/Repo settings variables. |
| 43 | + |
| 44 | +### Issues |
| 45 | + |
| 46 | +- Issue 1770 Wrong type of _projects_ setting in settings schema |
| 47 | +- Issue 1787 Publish to Environment from PR fails in private repos |
| 48 | +- Issue 1722 Check if apps are already installed on a higher version before deploying |
| 49 | +- Issue 1774 Increment Version Number with +0.1 can increment some version numbers twice |
| 50 | +- Issue 1837 Deployment from PR builds fail if PR branch name includes forward slashes (e.g., `feature/branch-name`). |
| 51 | +- Issue 1852 Page Scripting Tests are not added to build summary |
| 52 | +- Issue 1829 Added custom jobs cannot be removed |
| 53 | +- Idea 1856 Include workflow name as input for action ReadSetting |
| 54 | + |
| 55 | +### Additional debug logging functionality |
| 56 | + |
| 57 | +We have improved how logging is handled in AL-Go, and now make better use of GitHub built-in extended debug logging functionality. Extended debug logging can be enabled when re-running actions by clicking the 'Enable debug logging' checkbox in the pop-up window. This can be done both for jobs that failed and jobs that succeeded, but did not produce the correct result. |
| 58 | + |
| 59 | +### Add custom jobs to AL-Go workflows |
| 60 | + |
| 61 | +It is now possible to add custom jobs to AL-Go workflows. The Custom Job needs to be named `CustomJob<something>` and should be placed after all other jobs in the .yaml file. The order of which jobs are executed is determined by the Needs statements. Your custom job will be executed after all jobs specified in the Needs clause in your job and if you need the job to be executed before other jobs, you should add the job name in the Needs clause of that job. See [https://aka.ms/algosettings#customjobs](https://aka.ms/algosettings#customjobs) for details. |
| 62 | + |
| 63 | +Note that custom jobs might break by future changes to AL-Go for GitHub workflows. If you have customizations to AL-Go for GitHub workflows, you should always doublecheck the pull request generated by Update AL-Go System Files. |
| 64 | + |
| 65 | +### Support for Custom AL-Go template repositories |
| 66 | + |
| 67 | +Create an AL-Go for GitHub repository based on [https://aka.ms/algopte](https://aka.ms/algopte) or [https://aka.ms/algoappsource](https://aka.ms/algoappsource), add custom workflows, custom jobs and/or settings to this repository and then use that repository as the template repository for other repositories. Using custom template repositories allows you to create and use highly customized template repositories and control the uptake of this in all repositories. See [https://aka.ms/algosettings#customtemplate](https://aka.ms/algosettings#customtemplate) for details. |
| 68 | + |
| 69 | +> [!NOTE] |
| 70 | +> Customized repositories might break by future changes to AL-Go for GitHub. If you are customizing AL-Go for GitHub, you should always double-check the pull request when updating AL-Go system files in your custom template repositories. |
| 71 | +
|
1 | 72 | ## v7.2 |
2 | 73 |
|
3 | 74 | ### Removed functionality |
|
0 commit comments