Skip to content

Missing documentation? #60

@mateusoliveira43

Description

@mateusoliveira43

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions