Skip to main content

Welcome to AL-Go for GitHub

AL-Go for GitHub is a set of GitHub templates and actions that enable professional DevOps processes for your Business Central AL projects. It provides automated CI/CD pipelines, testing, deployment, and release management — all powered by GitHub Actions.
AL-Go for GitHub is maintained by Microsoft and is designed to keep your repositories current with the latest Business Central features and DevOps best practices through automated updates.

Key Features

Automated CI/CD

Build, test, and validate your AL apps automatically on every commit and pull request

Multi-Project Support

Manage multiple projects and apps within a single repository with independent build pipelines

AppSource Publishing

Streamlined workflows for publishing apps to Microsoft AppSource with automated validation

Continuous Deployment

Deploy to sandbox and production Business Central environments with S2S authentication

Test Automation

Run unit tests, performance tests (BCPT), and page scripting tests automatically

Self-Hosted Runners

Use your own GitHub runners to improve build performance and control costs

Azure KeyVault Integration

Secure secrets management with Azure KeyVault support

Power Platform Integration

Build and deploy Power Platform solutions alongside your Business Central apps

How It Works

AL-Go for GitHub provides two template repositories to get you started:

AL-Go-PTE

Template for Per Tenant Extensions (PTEs) — customizations for specific customers

AL-Go-AppSource

Template for AppSource apps — commercial extensions published to Microsoft AppSource
When you create a repository from one of these templates, you get:
  • Preconfigured workflows for CI/CD, releases, and deployments
  • GitHub Actions that handle building, testing, and publishing
  • Settings files to customize behavior for your specific needs
  • Update mechanisms to keep your DevOps infrastructure current

What You Can Do

1

Develop

Write AL code in VS Code with online development environments or local containers
2

Test

Run automated unit tests, performance tests, and page scripting tests on every build
3

Release

Create releases with automatically generated release notes and versioned artifacts
4

Deploy

Deploy to sandbox and production environments with automated workflows
5

Publish

Submit to AppSource with built-in validation and continuous delivery

Architecture

AL-Go consists of three main components:
  1. Template Repositories (AL-Go-PTE and AL-Go-AppSource) — Starting points for your projects
  2. GitHub Actions (AL-Go-Actions) — Reusable actions for build, test, and deployment
  3. This Repository (AL-Go) — Source code for templates and actions
When you use AL-Go:
  • Your repository is created from a template
  • Workflows call actions from AL-Go-Actions
  • Settings files control behavior
  • Update workflows keep everything current

Getting Started

Ready to set up AL-Go for your project?

Quickstart

Create your first AL-Go repository in minutes

Workshop

Complete the interactive AL-Go workshop

New PTE Project

Set up a Per Tenant Extension project

New AppSource App

Set up an AppSource app project

Community and Support

GitHub Repository

View source code, report issues, and contribute

Roadmap

See what’s coming next in AL-Go

Release Notes

Review changes in each version

Contributing

Learn how to contribute to AL-Go

Build docs developers (and LLMs) love