GiteaInstall

Overview

This node enables creating a new release in a specified repository on a Gitea server via its API. It is useful for automating the release management process, such as tagging versions, publishing draft or prerelease versions, and adding descriptive notes to releases.

Common scenarios include:

• Automatically creating a release when code is merged into a main branch.
• Tagging a specific commit with a release version.
• Managing draft or prerelease states programmatically during CI/CD workflows.

Example: After pushing code changes, this node can create a release tagged "v1.0.0" with release notes, marking it as a prerelease or draft depending on your workflow needs.

Properties

Output

The node outputs JSON data representing the newly created release object returned by the Gitea API. This typically includes details such as:

• Release ID
• Tag name
• Release name
• Description/body
• Draft and prerelease status
• URLs related to the release (e.g., HTML URL)
• Timestamps for creation and publication

No binary data output is involved.

Dependencies

• Requires connection to a Gitea instance with appropriate API access.
• Needs an API authentication token credential configured in n8n to authorize requests.
• The base URL for the Gitea API must be set in the credentials.

Troubleshooting

• Authentication errors: Ensure the API token has sufficient permissions to create releases in the target repository.
• Repository not found: Verify the owner and repo names are correct and accessible by the authenticated user.
• Invalid tag name: The tag name must follow Git tag naming conventions; invalid characters may cause errors.
• Network issues: Confirm the Gitea server URL is reachable from the n8n environment.
• Draft/Prerelease flags: If unexpected release visibility occurs, double-check the boolean values for draft and prerelease properties.

Links and References

• Gitea API Documentation - Create a Release
• Gitea Official Website
• Git Tag Naming Conventions