Skip to main content
The Deploy action deploys built artifacts to a specified Business Central environment. It supports both continuous deployment (CD) and publish scenarios.

Usage

- uses: microsoft/AL-Go/Actions/[email protected]
  with:
    environmentName: 'Production'
    artifactsFolder: '.artifacts'
    type: 'CD'
    deploymentEnvironmentsJson: ${{ needs.determine.outputs.DeploymentEnvironmentsJson }}

Inputs

shell
string
default:"powershell"
Shell in which you want to run the action (powershell or pwsh)
token
string
default:"${{ github.token }}"
The GitHub token running the action
environmentName
string
required
Name of environment to deploy to
artifactsFolder
string
required
Path to the downloaded artifacts to deploy
type
string
default:"CD"
Type of deployment (CD or Publish)
deploymentEnvironmentsJson
string
required
The settings for all Deployment Environments in compressed JSON format
artifactsVersion
string
default:""
Artifacts version. Used to check if this is a deployment from a PR

Outputs

environmentUrl
string
The URL of the deployed environment

Example Workflow

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      
      - name: Download artifacts
        uses: actions/download-artifact@v4
        with:
          name: build-artifacts
          path: .artifacts
      
      - name: Deploy to environment
        uses: microsoft/AL-Go/Actions/[email protected]
        with:
          environmentName: 'Production'
          artifactsFolder: '.artifacts'
          deploymentEnvironmentsJson: ${{ needs.determine.outputs.DeploymentEnvironmentsJson }}
The deploymentEnvironmentsJson input is typically obtained from the DetermineDeploymentEnvironments action.
Ensure that the artifacts folder contains valid Business Central app files (.app) before running the deployment.

Build docs developers (and LLMs) love