Add tags to SonarQube project
This guide shows how to quickly add tags to a SonarQube project via Port's self-service actions with ease. Tagging projects in SonarQube allows you to categorize and label your projects based on various attributes such as technology stack, business domain, team ownership etc. In this action, we will add tags to enable you to more easily connect a SonarQube project to a service in Port.
Prerequisitesโ
-
Port's GitHub app needs to be installed.
-
SonarQube instance URL, SonarQube API token. Check SonarQube's documentation on how to retrieve your API Token
-
In your GitHub repository, go to Settings > Secrets and add the following secrets:
SONARQUBE_HOST_URL
- SonarQube instance URL.https://sonarqube.com
if using Sonarcloud.SONARQUBE_API_TOKEN
- SonarQube API token. This can be a Project Analysis token for the specific project, a Global Analysis token or a user token. Requires the following permission: 'Administer' rights on the specified project.PORT_CLIENT_ID
- Port Client ID learn morePORT_CLIENT_SECRET
- Port Client Secret learn more
-
Optional - Install Port's SonarQube integration learn more
The above step is not required for this example, but it will create all the blueprint boilerplate for you, and also update the catalog in real time with the new incident created.
- In case you decided not to install the SonarQube integration, you will need to create a blueprint for the SonarQube Project in Port.
SonarQube Project Blueprint (Click to expand)
{
"identifier": "sonarQubeProject",
"title": "SonarQube Project",
"icon": "sonarqube",
"schema": {
"properties": {
"organization": {
"type": "string",
"title": "Organization",
"icon": "TwoUsers"
},
"link": {
"type": "string",
"format": "url",
"title": "Link",
"icon": "Link"
},
"lastAnalysisDate": {
"type": "string",
"format": "date-time",
"icon": "Clock",
"title": "Last Analysis Date"
},
"numberOfBugs": {
"type": "number",
"title": "Number Of Bugs"
},
"numberOfCodeSmells": {
"type": "number",
"title": "Number Of CodeSmells"
},
"numberOfVulnerabilities": {
"type": "number",
"title": "Number Of Vulnerabilities"
},
"numberOfHotSpots": {
"type": "number",
"title": "Number Of HotSpots"
},
"numberOfDuplications": {
"type": "number",
"title": "Number Of Duplications"
},
"coverage": {
"type": "number",
"title": "Coverage"
},
"mainBranch": {
"type": "string",
"icon": "Git",
"title": "Main Branch"
},
"tags": {
"type": "array",
"title": "Tags"
}
},
"required": []
},
"mirrorProperties": {},
"calculationProperties": {},
"relations": {}
}
GitHub Workflowโ
Create the file add-tags-to-sonarqube-project.yml
in the .github/workflows
folder of your repository and copy the content of the workflow configuration below:
We recommend creating a dedicated repository for the workflows that are used by Port actions.
Add tags to SonarQube project workflow (Click to expand)
name: Add tags to SonarQube project
on:
workflow_dispatch:
inputs:
tags:
type: string
required: true
port_context:
required: true
type: string
jobs:
create-entity-in-port-and-update-run:
runs-on: ubuntu-latest
steps:
- name: Inform Port of start of request to SonarQube
uses: port-labs/port-github-action@v1
with:
clientId: ${{ secrets.PORT_CLIENT_ID }}
clientSecret: ${{ secrets.PORT_CLIENT_SECRET }}
baseUrl: https://api.getport.io
operation: PATCH_RUN
runId: ${{ fromJson(inputs.port_context).run_id}}
logMessage: Starting request to add tags to SonarQube project
- name: Add tags to SonarQube project
uses: fjogeleit/http-request-action@v1
with:
url: "${{ secrets.SONARQUBE_HOST_URL }}/api/project_tags/set?project=${{ fromJson(inputs.port_context).entity }}&tags=${{ inputs.tags }}"
method: "POST"
bearerToken: ${{ secrets.SONARQUBE_API_TOKEN }}
customHeaders: '{"Content-Type": "application/json"}'
- name: Inform Port of completion of request to SonarQube
uses: port-labs/port-github-action@v1
with:
clientId: ${{ secrets.PORT_CLIENT_ID }}
clientSecret: ${{ secrets.PORT_CLIENT_SECRET }}
baseUrl: https://api.getport.io
operation: PATCH_RUN
runId: ${{ fromJson(inputs.port_context).run_id }}
logMessage: Finished request to create SonarQube project
Port Configurationโ
On the self-service page, create the Port action against the SonarQube Project
blueprint. This will trigger the GitHub workflow.
Add tags to SonarQube project action (Click to expand)
Make sure to replace <GITHUB_ORG>
and <GITHUB_REPO>
with your GitHub organization and repository names respectively.
{
"identifier": "sonarQubeProject_add_tags_to_sonar_qube_project",
"title": "Add Tags to SonarQube project",
"icon": "sonarqube",
"description": "Adds additional tags to a project in SonarQube",
"trigger": {
"type": "self-service",
"operation": "DAY-2",
"userInputs": {
"properties": {
"tags": {
"title": "Tags",
"description": "Comma separated list of tags",
"icon": "DefaultProperty",
"type": "string"
}
},
"required": [
"tags"
],
"order": [
"tags"
]
},
"blueprintIdentifier": "sonarQubeProject"
},
"invocationMethod": {
"type": "GITHUB",
"org": "<Enter GitHub organization>",
"repo": "<Enter GitHub repository>",
"workflow": "add-tags-to-sonarqube-project.yml",
"workflowInputs": {
"tags": "{{.inputs.\"tags\"}}",
"port_context": {
"entity": "{{.entity.identifier}}",
"run_id": "{{.run.id}}"
}
},
"reportWorkflowStatus": true
},
"requiredApproval": false,
"publish": true
}
Due to SonarQube API's limitation, this action replaces the tags on the project with the new ones specified. If you want to add to the already existing tags, copy the existing tags and add it with the new ones you are adding.
Let's test itโ
-
Trigger the action from Port's Self Serve
-
Done! wait for the project tags to be updated in SonarQube
Congrats ๐ You've added tags to your SonarQube project from Port!