Using AL-Go with GitHub to Simplify CI/CD for Business Central

-

Introduction

In today’s fast-moving world of software development, Continuous Integration (CI) and Continuous Deployment (CD) are key to building and releasing updates quickly and reliably.
For Business Central developers, AL-Go for GitHub makes this process easy by using GitHub Actions to automate builds, testing, and deployments.
It comes with ready-to-use templates that help you set up a complete CI/CD pipeline in minutes so you can focus more on coding and less on managing workflows.

Each build typically takes around 20 minutes when using containers, which fits comfortably within GitHub’s free limits for most projects 2,000 minutes per month for private repositories on the Free tier, 3,000 minutes on the Team tier, and up to 50,000 minutes on the Enterprise tier.
Since public repositories get unlimited free minutes, AL-Go for GitHub offers an affordable and powerful way to maintain professional DevOps practices without extra costs.
Overall, it’s a simple, cost-efficient, and developer-friendly solution to keep your Business Central environments up to date and running smoothly.

References

Al-Go ReadMe
AL Go - Overview
GitHub - Pricing
freddysblog - Al Go for Github
freddysblog - Deployment strategies and al go for github

Configuration

Go to Al-Go-PTE


Click on "Use this template" button.

Once the repo is created, click on Actions.
You'll see that you have an Initial commit workflow running.
On the left side, click on "Create a new app" to get started with creating a new AL app.


Click on Run Workflow and specify the name, publisher and ID range for the new AL app.
If you want the workflow to make a commit directly, set the "Direct Commit" flag.
If this is not set, then the workflow will create a pull request, which will fail if the appropriate permissions are not granted.


To allow the workflow to create a pull request go to repository settings, click on Actions on left and then scroll down.
Tick the "Allow Github Actions to create and approve pull requests" and click on Save.


Once you click on "Run workflow", we will see a new entry in the workflow runs window.


Clicking on it shows all the different tasks involved in this workflow.


Clicking on the individual task will show the logs and additional details of the task.


Once this is completed, in the commit history, we can see that there is new commit with a new app.



Now, I'll clone this repo locally so I can add some of my own files.
I've cloned the repo and added a permission set and a list page.


Next, we need to define a way for Github to access our Business Central environment.
For that, we need to set up an environment on Github.


Go to repository settings -> Environments -> New Environment.


Give it a proper name and click on "Configure environment"


Now, we need to get a value for the environment secret.
We can do that via powershell.

First install BcContainerHelp module.
Install-Module -Name BcContainerHelper
Then, run the following command to get the authcontext that needs to be added on Github.
$AuthContext = New-BcAuthContext -includeDeviceLogin

Get-ALGoAuthContext -bcAuthContext $AuthContext | Set-Clipboard 


Now, after running both the commands, the auth context will be available on your clipboard.
Then, go back to Github, click on "Add Environment Secret" and name it "AUTHCONTEXT" and paste the value.


Now, we are all set.

Now, I will commit all my changes to the main branch to verify whether the workflow is CI/CD as expected.
After commiting the changes, we can see a new entry in the workflow runs under the CI/CD workflow.


    After sometime, the pipeline run has been completed.


In Business Central, we can see that the extension has been installed successfully.

Conclusion

AL-Go for GitHub makes it much easier for Business Central developers to build, test, and deploy their apps automatically.
It takes care of most of the setup work, so you can focus on writing code instead of managing deployments.

Once everything is configured, any change you push to GitHub can be built and deployed to your environment automatically.
This helps keep your extensions up to date, reduces manual effort, and avoids mistakes.

Comments

Post a Comment

Popular posts from this blog

Event-Driven Architecture: How to Create Custom Business Events in Business Central

-
Image
Introduction Events are notifications that signal something has happened in the system. A record getting created, updated or deleted, a sales order getting posted, etc are all examples of events. An event driven architecture provides asynchrony and decoupled communication between different components of the system supporting flexibility, scalability and modularity. In Business Central, we have two main types of events - Business and Integration. Integration Events are related to things within Business Central. They are use for extending the functionality of the Base Application without modifying it directly. Business Events are related to things outside of Business Central. They are used for notifying external systems (e.g., via Power Automate or Logic Apps) regarding any changes that happen within Business Central. Microsoft allows us to create custom Integration and Business Events based on our requirements. In this blog, we'll see how to create a custom Business Event and...
Read more

Visualizing Data: How to Add Power BI Reports to Business Central

-
Image
Introduction Power BI is a great tool for turning data into clear, interactive reports and the best part?  It works smoothly with Business Central, right out of the box.  You just need to set it up, and you can start viewing powerful reports right inside within Business Central dashboard.  Microsoft provides several ready-made reports, grouped into different apps, so you can pick and install only what you need.  Once set up, these reports help you track key business insights without switching between systems.  In this blog, we’ll walk you through how to set up and use Power BI reports in Business Central to make smarter decisions. References Introduction to Business Central and Power BI Install Power BI apps for Business Central Configuration Open your Business Central and search for "Assisted Setup". Click on "Connect to Power BI" Once the set up page opens, click on Next. Fiscal : A 12-month calendar that begins in any month and ends 12 months after. Standard ...
Read more