Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Missing documentation? #60

Open
mateusoliveira43 opened this issue Feb 2, 2024 · 0 comments
Open

Missing documentation? #60

mateusoliveira43 opened this issue Feb 2, 2024 · 0 comments

Comments

@mateusoliveira43
Copy link
Contributor

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
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant