Creating a Release

Creating a Release

This page describes how to publish a new released version of sql-action by creating a Git tag through the GitHub web UI.

Releases are created directly from GitHub's Releases page. Publishing a release also creates the underlying Git tag that consumers reference in their workflows (for example, uses: azure/sql-action@v2.3).

Prerequisites

• You have write (or maintainer) access to the Azure/sql-action repository.
• The master branch contains the changes you want to release, including the rebuilt lib/main.js bundle.

Versioning convention

Tags follow the vMAJOR.MINOR format (for example, v2.3). Increment the:

• MAJOR version for breaking changes.
• MINOR version for new, backward-compatible features and fixes.

Steps

1. Go to the Releases page.
2. Click Draft a new release.
3. Click Choose a tag, type the new version tag (for example, v2.3), and select Create new tag: v2.3 on publish.
4. Leave Target set to master.
5. In the Release title field, enter a title based on the main feature of the release.
6. Click Generate release notes to auto-populate the description from merged pull requests.
7. Leave the release label set to Set as the latest release.
8. Click Publish release.

Once published, GitHub creates the tag and the release becomes available for workflows to reference.