1. What is jen2bit

A CLI Tool for Jenkinsfile to bitbucket-pipelines.yml

2. Install

npm install -g jen2bit

3. Commands

convert

descriptions

• Convert Jenkinsfile to bitbucket-pipelines.yml

grammars

jen2bit convert [Jenkinsfile] [options]

options

option	description	default
-o, --output <file>	Output file path	bitbucket-pipelines.yml
-r, --runner <runners...>	Runner labels added as runs-on in each step. Labels containing windows → Windows mode, otherwise Linux mode	-
-a, --all	Merge all stages into a single step	-

examples

# No runner specified (Linux mode, no runs-on)
jen2bit convert Jenkinsfile

# Linux self-hosted runner
jen2bit convert Jenkinsfile -r self.hosted linux

# Windows self-hosted runner
jen2bit convert Jenkinsfile -r self.hosted windows

# Merge all stages into a single step
jen2bit convert Jenkinsfile -a

# Combine with runner
jen2bit convert Jenkinsfile -a -r self.hosted linux

# Specify output file
jen2bit convert Jenkinsfile -o my-pipeline.yml

output

bitbucket-pipelines.yml

invert

descriptions

• Invert from bitbucket-pipelines.yml to Jenkinsfile

grammars

jen2bit invert [bitbucket-pipelines.yml] [options]

options

option	description	default
-o, --output <file>	Output file path	Jenkinsfile

examples

# Default (reads bitbucket-pipelines.yml, outputs Jenkinsfile)
jen2bit invert

# Specify input file
jen2bit invert my-pipeline.yml

# Specify output file
jen2bit invert bitbucket-pipelines.yml -o MyJenkinsfile

output

Jenkinsfile

4. Versioning

major.minor.patch

• major : Delete or Rename commands (Compatibility Ignored)
• minor : Add new commands
• patch : Edit commands

5. Dependencies

package	description
commander	CLI framework for parsing commands and options
js-yaml	YAML parser used to read bitbucket-pipelines.yml in the invert command