Forgejo icon

Forgejo

Interact with Forgejo API
Join our community

Actions73

Overview

This node operation creates a new release in a specified repository on Forgejo. It allows users to define the release by specifying the repository owner, repository name, tag name, release name, release notes, and flags indicating whether the release is a draft or a prerelease. This operation is useful for automating the release process in software development workflows, enabling continuous delivery and version management.

Use Case Examples

  1. Automatically create a release when a new version is tagged in the repository.
  2. Generate release notes and publish a prerelease for testing purposes before the final release.

Properties

Name Meaning
Owner The username or organization that owns the repository where the release will be created.
Repository The name of the repository where the release will be created.
Tag Name The tag name associated with the release, typically representing the version.
Release Name The name of the release, which can be a descriptive title.
Body The release notes or description providing details about the release.
Draft A boolean flag indicating whether the release is a draft (not yet published).
Prerelease A boolean flag indicating whether the release is a prerelease (a release for testing or preview).

Output

JSON

  • json
    • tag_name - The tag name of the created release.
    • name - The name of the created release.
    • body - The release notes or description.
    • draft - Indicates if the release is a draft.
    • prerelease - Indicates if the release is a prerelease.
    • id - The unique identifier of the created release.
    • url - The URL to access the release.

Dependencies

  • An API key credential for Forgejo API authentication

Troubleshooting

  • Ensure that the 'owner' and 'repository' fields are correctly specified and that the user has permission to create releases in the repository.
  • Verify that the 'tagName' corresponds to an existing or intended tag in the repository; otherwise, the release creation may fail.
  • Check the API credentials and server URL configuration to ensure proper authentication and connectivity.
  • If the API returns errors related to permissions or invalid data, review the input parameters for correctness and completeness.

Links

Discussion