A simple tool to search Salt branches and tags for pull requests.
This tool takes a pull request number and outputs the list of branches and/or tags it is included in.
Note: A git fetch is performed at the beginning of the main Python function. This provides the most up-to-date search results for the query. This functionality can be avoided by passing the skip-fetch flag.
The following steps will walk you through building the Docker image needed to use this tool.
These steps assume Docker is already installed. If you haven't previously installed Docker, follow these installation instructions.
First, clone this repo. Then, change directories to the new clone:
$ git clone https://github.com/rallytime/version-check.git $ cd version-check/
Next, build the Docker container:
$ docker build -t version_check .
You should now be ready to use
version_check to identify the branches and
tags that your pull request is contained in.
docker build step above copies
version_check.py into the image and
entrypoint to run the file with
Python. That way, you can provide
the script arguments for the tool directly to the container:
$ docker run --rm -it version_check -h
version_check allows you to provide a pull request number or a commit hash
(but not both) to query Salt branches and releases.
$ docker run --rm -it version_check -p 42890 Branches: 2016.11 2016.11.8 2017.7 2017.7.2 develop Tags: v2016.11.8 v2017.7.2
Commit Example (same PR number, but using a commit hash instead):
$ docker run --rm -it version_check -c 999388680ca67d9d2aafa6c0fbc3acc5d8389208 Branches: 2016.11 2016.11.8 2017.7 2017.7.2 develop Tags: v2016.11.8 v2017.7.2
Narrowing Search Results
You can also narrow your search to scan specific branches or tags:
$ docker run --rm -it version_check -p 42890 -b 2017.7 -t v2016.11.8 Branches: 2017.7 Tags: v2016.11.8
Multiple branches or tags can also be used:
$ docker run --rm -it version_check -p 42890 -b 2017.7 -b develop Branches: 2017.7 develop
It's possible to avoid running a
git fetch every time the
is executed by passing the
--skip-fetch flag. This is desirable when a container
already contains the latest references from GitHub.
--skip-fetch will decrease search times significantly, but be
aware it may cause inconsistent search results if the clone is not up-to-date.