This Azure DevOps add-on integrates with ARCAD-CodeChecker to facilitate seamless campaign execution directly from your Azure environment. The add-on is tailored to work with IBM i systems, providing an automated solution for code quality and security checks. It allows users to execute campaigns on a specified ARCAD version, targeting an IBM i library,predefined targets and target files uploaded from Azure
Installation
To install the ARCAD-CodeChecker Azure Add-On, follow these steps:
Navigate to the Azure DevOps Marketplace and search for the ARCAD-CodeChecker Azure Add-On.
Click on the Get it free button to install the add-on.
Select the organization you want to install the add-on for and click on the Install button.
Once the installation is complete, you will be redirected to the organization's Azure DevOps page.
Available ARCAD-CodeChecker Tasks
The ARCAD-CodeChecker Azure Add-On provides the following tasks:
ARCAD-CodeChecker Campaign Execution on ARCAD Version: This task allows you to execute a campaign on a specified ARCAD version.
ARCAD-CodeChecker Campaign Execution on IBM i Library: This task allows you to execute a campaign on a specified IBM i library.
ARCAD-CodeChecker Campaign Execution on Predefined Targets: This task allows you to execute a campaign on predefined targets.
ARCAD-CodeChecker Campaign Execution on Target Files: This task allows you to execute a campaign on target files uploaded from Azure.
Add a CodeChecker Service Connection
To add a CodeChecker service connection, follow these steps:
Before using any tasks, yau have to configure a Code Checker Server Connection in the Project Settings, section Service Connection.
Field Description
Server URL (required)
Enter the CodeChecker server URL including the port number
Note that the server must be the one used in the certificate
Server Key
The CodeChecker Server Certificate in .pem format
Accept untrusted SSL Certificates
Cheks this box if you want to allow the CodeChecker clients to accept self-signed SSL server certificates without installing them into the Azure DevOps service role and/or Build Agent computers.
Username (required)
The name of the user used to connect the CodeChecker Server
Password (required)
The password of the user used to connect the CodeChecker Server
Inputs
Code Review: The code review to be executed. Required
Code Checker Campaign: The campaign to be executed. Required
IBM i Server: The IBM i server to be used for the campaign. Required
ARCAD Instance: The ARCAD instance to be used for the campaign. Required
ARCAD Language: The ARCAD language to be used for the campaign. Required
Application Code: The application code to be used for the campaign. Required
Environment ID: The environment ID to be used for the campaign. Required
Version Number: The version number to be used for the campaign. Required
IASP: The IASP to be used for the campaign. Optional
Source Path: The source path to an IBM i library. It Supports wild card entry so it could be a Physical File or Members. Required
Reference Target: The reference target will be used to perform the delta comparison. Optional
Target Code: The target code to be used for the campaign. Required
Description: The description of the campaign. Optional
Source Folder: The source folder to be used for the campaign. Required
Upload to SonarQube: Check this box if you want to upload the campaign results to SonarQube. Optional
Note
For the ARCAD-CodeChecker Campaign Execution on Source Uploaded from Azure task, the Source Folder inputs is required. The source folder should contain the target files to be analyzed. The Folder must be accessible by the agent running the build pipeline. If the Folder is outside the repository, you can use azure variables to set the path to the folder.
Execution
Navigate to the Azure DevOps project where you want to execute the campaign.
Click on the Pipelines tab and select the pipeline where you want to add the ARCAD-CodeChecker task.
Click on the Edit button to edit the pipeline.
Click on the + button to add a new task.
Search for the ARCAD-CodeChecker task and click on the Add button.
Fill in the required inputs for the task.
Click on the Save button to save the pipeline.
Click on the Run button to execute the pipeline.
Once the pipeline execution is complete, you can view the campaign results in the ARCAD-CodeChecker dashboard.
If you have checked the Upload to SonarQube option, you can view the campaign results in the SonarQube dashboard.
