Use this file to discover all available pages before exploring further.
Importing an existing repo from Git can get you quickly up and running with Diversion.
You can also enable bi-directional sync between your Git repo and Diversion, so that
changes made in either place are reflected in the other.
This is a great way to take Diversion for a test drive with no commitment.
Web UI
CLI
To import a repo using the Web UI, follow these steps:
Choose whether you want to import your entire repo and keep all of its history, or just the latest commit from a specific branch.If you choose to Import all branches with history, you’ll have the option to Enable continuous bi-directional sync.
This happens in the background, and depending on the size of your Git repo can take a few minutes.
You will receive an email when the import is complete.
To import a repo using the CLI, follow these steps:
If you want an interactive shell with nicer UI, open your terminal of choice and run the dv command.
It works the same as your regular terminal, and you can use any of the dv commands (commit, init, etc…) directly without prefacing them with dv.
3
Import
Run the following command:
dv import [git_url]
This will start importing your repo into Diversion with the default name - the same as the repo’s name in Git.There are several optional arguments for the import command. You can always run dv help import to see them in the terminal.
[repo-name]
Passing a repo name to the import command will save the repo to Diversion with that name, instead of the repo’s name in Git.
dv import [git_url] [repo-name]
--with-sync
Enables bi-directional sync between your new Diverson repo and your Git repo. This means that any change you make to one repo will be reflected in the other.This is useful for testing Diversion or for keeping any Git-based pipelines you have in place.
By default, Diversion will import the latest commit from the default branch of your Git repo. If you want to import the latest commit from a different branch, you can use the --git-branch flag.
dv import [git_url] --git-branch [branch-name]
--with-history
By default, Diversion will only import the latest commit from the default branch of your Git repo. If you want to import the entire repo with all of its history, you can use the --with-history flag.
dv import [git_url] --with-history
4
Wait for the import to complete
This happens in the background, and depending on the size of your Git repo can take a few minutes.
You will receive an email when the import is complete.
