In this blog, I will take you through a step-by-step process to set up CI/CD workflows using GitHub actions for MuleSoft Anypoint Platform integration projects with GitHub as the project repository.
First, you need to create a sample MuleSoft 4 application in Anypoint Studio. Run and test the application in Anypoint Studio. Check the project into GitHub for automatic build and deploy to Anypoint Platform for any new code check-ins or updates to existing code.
GitHub Action Prerequisites
- Repo access
- Anypoint Platform Access
- To deploy an application to the CloudHub Anypoint Environment Org/Business Group: Environment, Client ID, and Client Secret credentials are required
MuleSoft Application Configurations
All MuleSoft 4 applications are Maven compliant. In order to effectively use Maven for build and development, the following configurations should be available for every project that needs to be enabled for CI/CD in DevOps.
Maven Project Pom.xml Configuration: Every pom.xml file in a MuleSoft project should have this configuration to enable CI/CD.
MUnit Maven Plugin Configuration: This configuration helps run MUnit tests and validate for minimum test coverage before allowing successful build and deployment.
| <plugin>
<groupId>com.mulesoft.munit.tools</groupId> <artifactId>munit-maven-plugin</artifactId> <version>${munit.version}</version> <executions> <execution> <id>test</id> <phase>test</phase> <goals> <goal>test</goal> <goal>coverage-report</goal> </goals> </execution> </executions> <configuration> <coverage> <runCoverage>true</runCoverage> <failBuild>true</failBuild> <requiredApplicationCoverage>0</requiredApplicationCoverage> <requiredResourceCoverage>0</requiredResourceCoverage> <requiredFlowCoverage>80</requiredFlowCoverage> <formats> <format>html</format> </formats> <ignoreFiles/> <ignoreFlows/> </coverage> </configuration> </plugin> |
Make sure you have a license to access the MuleSoft Enterprise Repository to execute an MUnit test in GitHub Action. For further documentation and instruction, click here.
Mule Maven Plugin Configuration: This plugin is used for CLI-based application deployment using Maven deploy goal.
The below configuration is an example for deployment to a CloudHub environment:
| <plugin>
<groupId>org.mule.tools.maven</groupId> <artifactId>mule-maven-plugin</artifactId> <version>${mule.maven.plugin.version}</version> <extensions>true</extensions> <configuration> <cloudHubDeployment> <uri>https://anypoint.mulesoft.com</uri> <muleVersion>${app.runtime}</muleVersion> <username>${username}</username> <password>${password}</password> <applicationName>${project.name}</applicationName> <environment>Sandbox</environment> <workerType>MICRO</workerType> <region>us-east-2</region> <workers>1</workers> <objectStoreV2>true</objectStoreV2> </cloudHubDeployment> </configuration> </plugin> |
Make Salesforce Stick
To ensure your Salesforce implementation or migration goes as planned, our team of change management professionals discuss how to manage the transition process to ensure your team is ready, willing, and able to perform effectively in the new environment.
The variables that appear between ${} are externalized and supplied during GitHub Action execution using secrets.
GitHub Action Configurations
The below configuration assumes that the MuleSoft project is maintained in its own GitHub Repository.
Build and deploy to any environment. Any push to the branch will trigger GitHub Actions tasks. As part of these Actions, it would trigger build, test, and package, then deploy the application. If any test fails or the test coverage is below the set threshold, the workflow execution will fail and the deployment will be aborted.
Workflow setup: Under Action, set up GitHub Action workflow. Create a workflow file in .github/workflows and name it as <<app-name>-build-deploy.yaml. This workflow will trigger the build and deploy process every time a user pushes the change to the dev branch or raises a pull request on the dev branch.
Replace the action yaml details with the following sample Action workflow. This will check out MuleSoft code that is available in the current GitHub repository and deploy the application to Anypoint Platform based on the username and password provided in the repository secrets section.
| # This workflow will build and deploy a MuleSoft project
name: MuleSoft deployment with GitHub Actions CI
# Controls when the action will run. on: # Triggers the workflow on push or pull request events on dev branch push: branches: [dev ] pull_request: branches: [ dev ]
# Allows you to run this workflow manually from the Actions tab workflow_dispatch:
# A workflow run is made up of one or more jobs jobs: # “build” build: # The type of runner that the job will run on runs-on: ubuntu-latest
# Steps represent a sequence of tasks that will be executed as part of the job steps:
# Checks-out your repository – uses: actions/checkout@v2 – uses: actions/cache@v1 with: path: ~/.m2/repository key: ${{ runner.os }}-maven-${{ hashFiles(‘**/pom.xml’) }} restore-keys: | ${{ runner.os }}-maven- – name: Set up JDK 1.8 uses: actions/setup-java@v1 with: java-version: 1.8
– name : build run: mvn -B package –file pom.xml
– name: Artifact file name with commit hash run: | artifactName1=$(ls target/*.jar | head -1) commitHash=$(git rev-parse –short “$GITHUB_SHA”) artifactName2=$(ls target/*.jar | head -1 | sed “s/.jar/.$commitHash.jar/g”) mv $artifactName1 $artifactName2
– uses: actions/upload-artifact@master with: name: artifacts path: target/*.jar
deploy: needs: build runs-on: ubuntu-latest steps: – uses: actions/checkout@v2 – uses: actions/cache@v1 with: path: ~/.m2/repository key: ${{ runner.os }}-maven-${{ hashFiles(‘**/pom.xml’) }} restore-keys: | ${{ runner.os }}-maven- – uses: actions/download-artifact@master with: name: artifacts
– name: Deploy to Anypoint Platform env: USERNAME: ${{ secrets.ANYPOINT_USERNAME }} PASSWORD: ${{ secrets.ANYPOINT_PASSWORD }} run: | artifactName=$(ls *.jar | head -1)
mvn mule:deploy -Dmule.artifact=$artifactName -Dusername=$USERNAME -Dpassword=$PASSWORD |
Define secrets such as the Anypoint Platform username and password to be used in the workflow to deploy an application.
Build and deploy the application. The GitHub Action build and deploy flow will be triggered either by updating a file or by checking in a new file to the repository:
By following these simple steps, you can set up streamlined and effective CI/CD workflows using MuleSoft’s Anypoint Platform.
Contact us to learn more about what you can do with MuleSoft.
