concourse-gitea-release-resource

concourse-gitea-release-resource

A Concourse CI resource for monitoring and pushing artifacts to gitea releases.

• Examples
• Source Configuration
• Behavior
  • check
  • get
  • put
• Contributing

Examples

resource_types:
  - name: gitea-release
    type: docker-image
    source:
      repository: yorinasub17/gitea-release-resource

resources:
- name: myrepo-release
  type: gitea-release
  source:
    gitea_url: https://gitea.com
    owner: yorinasub17
    repository: concourse-gitea-release-resource
    access_token: abcdef1234567890

- get: myrepo-release

- put: myrepo-release
  params:
    name_path: path/to/name/file
    tag_path: path/to/tag/file
    body_path: path/to/body/file
    target_path: path/to/target/file
    globs:
    - paths/to/files/to/upload-*.tgz

To get a specific version of a release:

- get: myrepo-release
  version: { tag: 'v0.0.1' }

Source Configuration

Behavior

check: Check for released versions

List releases in the default order returned by Gitea (tag commit timestamp). The releases returned can be constrained using the source configuration parameters.

The returned list contains an object of the following format for each release (with timestamp in the RFC3339 format):

{
    "id": "12345",
    "tag": "v1.2.3",
    "timestamp": "2006-01-02T15:04:05.999999999Z"
}

When check is given such an object as the version parameter, it returns releases from the specified version on, as ordered by Gitea. Otherwise it returns the latest release that matches the filters in the source configuration.

get: Fetch assets and metadata from a release

Fetches release artifacts and metadata from the chosen release. The artifacts will be stored in a subfolder assets in the destination directory.

By default all release assets will be downloaded. You can control this behavior using the globs input parameter. When provided, only assets that have a file name matching the file globs will be downloaded.

The following metadata files will be available:

• id: The Gitea ID of the release.
• name: The release title.
• tag: The Git tag for the release.
• target: The target Git ref for the release.
• url: The direct URL to the release page.
• body: The release notes body for the release.
• timestamp: When the release was published.

put: Publish or update a release

Publishes a new release on the repository if there isn't one mathing the provided tag. Otherwise, the existing release will be updated with the provided information.

Parameters

Contributing

• If you think you've found a bug in the code or you have a question regarding the usage of this software, please reach out to us by opening an issue in this GitHub repository.
• Contributions to this project are welcome: if you want to add a feature or fix a bug, please do so by opening a Pull Request in this GitHub repository. In case of feature contribution, we kindly ask you to open an issue to discuss it beforehand.
• Running tests:
  • This repo only contains integration tests with an active Gitea server. This means that you must have a running Gitea server with test data to run all the tests in this repo.
  • You can run a test Gitea server using the provided Dockerfile in the test/env folder.
  • All test data can be loaded using the Go CLI provided in test/setup.
  • To make running the tests easier, you can trigger the tests by running the bash script scripts/run_test.sh. This script will:
    1. Build the test Gitea container image.
    2. Start the test Gitea server in the background using the built image.
    3. Run the setup command to load the test data.
    4. Trigger tests using go test.