GitHub Version Tags
GitHub Actions allows you to perform numerous tasks automatically, including using the cURL command to insert a new tag when a release is made or when a pull request is closed for example.
This tutorial demonstrates how to build an automation that will create a new tag in Coralogix upon publishing a new release of your code.
Coralogix Version Tags API Endpoint
This document includes cluster-dependent URLs.
Refer to Coralogix endpoints to select the correct Coralogix GitHub version tags API endpoint for the domain associated with your Coralogix account.
Tutorial
STEP 1. Create your Action as a .yml file inside our repository in the workflows directory .github/workflows/my-tag-automation.yml.
Note:
- Remember to place the .github folder inside the root folder of your repository.
STEP 2. Add the content of your action.
- Add the name of the automation and the events that activate it.
- Add the 'job' of our automation -- the action that it will execute.
name: "Create a tag"
on:
release:
types: [published]
jobs:
run-updater:
runs-on: ubuntu-latest
steps:
- name: create a tag
run: |
curl --location --request POST '<cluster_endpoint>' \
--header 'Authorization: Bearer <cx_api_key>' \
--header 'Content-Type: application/json' \
--data-raw '{
"name": "'"${GITHUB_REF##*/}"'",
"application": ["<my_app>"],
"subsystem": ["<my_subsystem>"]
}'
${GITHUB_REF##*/} = a github action variable holding the reference of the action , in this context its the tag of the release.
<my_app>
- Your Application name. You can input more than one name, use the comma delimiter ‘,’ between the names.
<my_subsystem>
- Your Subsystem name. You can input more than one name, use the comma delimiter ‘,’ between the names.
<cluster_endpoint>
- The endpoint depending on your Coralogix domain.
<cx_api_key>
- To use this API you need to create a personal or team API key. It’s recommended to use permission presets, as they are automatically updated with all relevant permissions. Alternatively, you can manually add individual permissions.
Preset | Action | Description |
---|---|---|
CICDIntegration | VERSION-BENCHMARK-TAGS:READ VERSION-BENCHMARKS-REPORTS:READ VERSION-BENCHMARK-TAGS:UPDATE | View Version Benchmark Tags View Version Benchmark Reports Modify Version Benchmark Tags |
STEP 3. After publishing a new release, the Action will run, and a new tag in Coralogix will be created.
Additional Resources
For more information about GitHub Actions visit: https://docs.github.com/en/actions/learn-github-actions/understanding-github-actions.
For more information about the usage of the cURL command with Coralogix tags click here.
Support
Need help?
Our world-class customer success team is available 24/7 to walk you through your setup and answer any questions that may come up.
Feel free to reach out to us via our in-app chat or by sending us an email at support@coralogix.com.