Skip to content

Missing documentation? #60

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

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

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