konveyor / release-tools

Release tooling for Konveyor projects.
2 stars 12 forks source link

Missing documentation? #60

Open mateusoliveira43 opened 10 months ago

mateusoliveira43 commented 10 months ago

Only https://github.com/konveyor/release-tools/blob/main/.github/workflows/prep-release.yaml action is referenced in README. I would suggest creating a folder (like docs/) and adding a file for each action, then reference each file in the README. The format of the files could be something like this:

Prepare repository for release

This workflow should be called when a new release branch is created. When invoked, it does the following:

  • update specified base images in the Dockerfile to use the right release tags
  • update specified golang deps to track the right release branch
  • commits the results back to the originating branch

Before doing the actual changes, it checks if the originating branch matches the pattern release-X.Y where X and Y are integers representing major and minor versions for the release.

Usage

See workflow file here

steps:
- uses:  konveyor/release-tools/.github/workflows/prep-release.yaml@main
 with:
   # This is the ref of the branch. Only branches of format `refs/heads/release-X.Y`
   # will enable the workflow to do the actual replacement of tags in Dockerfile.
   # All other branches are ignored. `${{ github.ref }}` in the original repo
   # should be used to get the value for this variable.
   # Required
   branch_ref: ${{ github.ref }}
   # This is a list of images in the Dockerfile for which you want to update
   # the tags. It should be a JSON array string e.g.
   # `'["quay.io/konveyor/operator"]'`.
   # Default: '[]'
   images_to_update: '["quay.io/konveyor/jdtls-server-base"]'
   # This is a list of go deps in the go.mod file for which you want to update
   # the branches. It should be a JSON array string e.g.
   # `'["github.com/konveyor/analyzer-lsp"]'`.
   # Default: '[]'
   go_deps_to_update: '["github.com/my/dependencies"]'
   # This is the relative path to the Dockerfile in the repo.
   # Default: ./Dockerfile
   dockerfile: ./my.Dockerfile