Exporting Iguana 6 code to a Repository

This is a guide on how to export your channels to a Git repository with Iguana 6 if you have not done it before or need a refresher! We focus on Bitbucket, but many of the concepts will apply if you are using Github or another git hosting provider.

For Bitbucket - go to https://www.bitbucket.com/, click on Get it free and follow the steps to get a free account.

First create a Workspace, name it anything you like.

Create the repository:

The repository Access Level can be public or private.
You must name the Default branch name: master - Iguana 6 looks for this specific branch name. Naming it ‘main’ may cause an error in future steps.
Then click Create Repository

Note: The following instructions are for Windows users, if you’re using Mac or Linux, please refer to this document for detailed instruction: https://confluence.atlassian.com/bitbucketserver081/creating-ssh-keys-1141482338.html#:~:text=The%20SSH%20key%20needs%20to,you%20use%20other%20key%20types

Check for existing SSH keys:

Open the Command Prompt as Administrator
Run the following command:
cd %userprofile%/.ssh
- If you see "No such file or directory", then there aren't any existing keys, you can create a new one.
- If you can go to the directory, then you need to check to see if you have a key already:
  dir id_*

Generate a new SSH key:

Open Command Prompt as Administrator
Run the following command:
ssh-keygen -t rsa -b 4096 -C "your_email@example.com" -m PEM
The terminal will ask you to enter a filename like C:\Users|<your user name>\.ssh\<private key>. Press Enter.
When prompted to enter a passphrase, do not enter any text, just press Enter twice.
Note: Iguana only accepts keys without a passphrase (password).
The process may look like this:
Copy the generated key using this command:
clip < id_rsa.pub
Open BitBucket, on the top right corner, click the Settings icon, then choose Personal Bitbucket settings option
In Security tab, choose SSH keys
Select Add key button
In the Add SSH key dialog, fill in the necessary fields like Name, SSH Public Key, Expiry date, then click Add key
Navigate back to your repo, click Clone. A dialog will open as below:

Copy the SSH URL (as highlighted above). It should be:
git@bitbucket.org:[your_workspace]/[your_repo].git

In Iguana 6:

Go to to Settings
Select Add/Configure Repositories
Click New Repository. You’ll see a screen like this:
Fill in necessary fields like Name, paste the SSH URL, and choose the private key file. By default, it’s stored at C:\Users\user_name\.ssh\
Click Save Repository

In Iguana 6, go to Dashboard.
Click the channel name:
Export the channel:

Select which channels you want to export. Don’t forget to include sample data.
Make sure you are exporting to the correct repository and click Export selected channels.
You’ll be prompted for a commit message. Enter the message and click OK
If you see this message, congratulations, the channels have successfully exported!