This open-source library helps in fetching and versioning the tags of your GIT repositories and Google Cloud Platform images.
It can be used either inside a node repository or as a CLI tool.
- Node 7.0.0 or later
- Git or gcloud as per the usage
It can be installed locally or globally or both as per different use cases. Local installation is preferred if this library will be used inside a node module. Global installation is preferred if it will be used as a CLI tool.
For Local Repository
# via npm
npm install marque
# via yarn
yarn add marqueGlobal Installation
# via npm
npm install -g marque
# via yarn
yarn global add marqueAs per the use case, this library can be used in multiple ways:
Node Module
It can be integrated with any Node.js service. It will return the incremented tag version based on the configuration.
const marque = require('marque');
marque.increment({ type: 'git', version: 'minor' })Options:
type: Usage type i.e. git or gcloudversion: Version type to increment i.e. major, minor or patchimageName: Image or resource name on gcloud. (Only for GCP)limit: Number of previous tags to fetch from gcloud to evaluate the latest tag. Normally this won't be required. (Only for GCP)
| Config Keys | default | accepts |
|---|---|---|
| type | git | git or gcloud |
| version | patch | major, minor or patch |
| imageName | undefined | string |
| limit | 10 | number |
Command line interface
It can be used in your terminal with interactive CLI just using the command:
marqueIt can also be used directly using:
# GIT
marque git <version>
marque <version> # Can omit git as it's default# Google Cloud Platform
marque gcloud <version> <image-name>
marque gcloud <version> <image-name> --limit=50 # with limitTools like Jenkins
newTag=$(marque gcloud <version> <image-name>)
if [[ $newTag == *"Error"* ]]; then
exit 0
fiRefer third-party-attributions.txt
Please go through our contributing guidelines