Skip to content

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 the following table to select the correct Coralogix Version Tags API endpoint for the domain associated with your Coralogix account.

DomainRegionEndpoint
coralogix.usUS1https://webapi.coralogix.us/api/v1/external/tags/
coralogix.comEU1https://webapi.coralogix.com/api/v1/external/tags/
eu2.coralogix.comEU2https://webapi.eu2.coralogix.com/api/v1/external/tags/
app.coralogix.inAP1 (IN)https://webapi.app.coralogix.in/api/v1/external/tags/
coralogixsg.comAP2 (SG)https://webapi.coralogixsg.com/api/v1/external/tags/

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.
name: "Create a tag"

on:
  release:
    types: [published]
  • 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 <Tags-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 depended on your Coralogix domain

<Tags-api-key> - Alerts, Rules, and Tags API Key should be taken from Data Flow –> API Keys –> “Alerts, Rules and Tags API Key”

API Access Github Version tags

STEP 3. After publishing a new release, the Action will run, and a new tag in Coralogix will be created.

Additional Resources

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 [email protected].