@zelty/cli-bb2gh v1.5.0

bb2gh: Bitbucket to GitHub Migration Tool

What is this repository for?

This repository is a cli tool to migrate a Bitbucket repository to GitHub.

Ensure you have access to the GitHub zelty-fr organization and your ssh key is set.

Ask Vincent in case of problem.

How do I get set up?

Please check you have Node.js >=20 installed before running the tool.

Install the tool from npm:

$ npm install -g @zelty/cli-bb2gh

Run the tool:

$ npx zelty-bb2gh

How do I use the CLI?

The tool can be used in different ways:

• Anywhere in your file path: In this case, you will have to set the name of the Bitbucket repo and change the Git remote url manually
• In a Git local repo: In this case, the tool will detect the remote url and set the Bitbucket repo name and change the remote url automatically

How to answer :

Quel est le nom du dépôt Bitbucket d'origine ? :

If no Git remote url is detected, you only have to put the name of the repository you want to migrate, without the Bitbucket project.
For example, if your repository is named "zelty-bo" in a "Core Web Backend" Bitbucket project, write only "zelty-bo".

Voulez-vous réutiliser le même nom ? :

If the repo name matches the Zelty rules, you can accept the old name as the new one by typing Y (or pressing Enter).

Quelle est l'équipe concernée par le projet ? :

Pick a team from the list.

Quel est le nom du projet ? :

Type the name of the project.

Quel est le type de projet (optionnel) ? :

Pick a type in the list or None if not applicable.

Quel est le token de l'API Gitub ? :

The GitHub API token available in 1Password: Zelty Tech > GitHub API Token - Migration from Bitbucket.

Où voulez-vous stocker le répertoire de travail ?

The path of the temporary folder used to store the git file

It starts from the user directory, just input the path from there : Documents/Workspace/Migration and don't use tilde (~).

Default is the /Users/[user]/Documents folder.

Voulez-vous renommer une branche en "[branch name]"

Zelty branching model uses 3 main branches:

• production
• staging
• develop

To match this model, the tool offers to rename some existing branches.

Just select the branch to rename with the selector.

Caution

The script creates a local folder, named bb2gh, in the path you have chosen.

This folder is deleted at the end of the process.

Develop

To test the tool locally, run:

$ npm run dev

Release

To bump the version and publish the tool on npm, run:

$ npm run release

and follow the instructions.