Git Repository

Before you can start building, you will need to provide Ascend with a repository in which to store your code for your Project. Ascend uses public/private key-pair authentication to access your repository. This means that you will need to generate an SSH key pair, add the public key to your repository, and provide the private key to Ascend.

Before you begin

1. You must have your Instance Vault and Instance Store set up.
2. You must have an Environment Vault and Environment Dataplane set up.
3. You have access to a Git Repository hosted on of the supported platforms.

Create the SSH key pair

1. On your local machine, open a bash terminal and run the following command:

ssh-keygen -t ed25519 -b 4096 -f ~/.ssh/ascend_io_repo_key -q -N ""

2. This command will generate a new SSH key pair in the ~/.ssh directory.
3. The public key will be saved in ~/.ssh/ascend_io_repo_key.pub
4. The private key will be saved in ~/.ssh/ascend_io_repo_key.

Add the public key to your repository

Bit Bucket

To allow for Ascend to have write access to your Bit Bucket repository, you will need to add your public key to a BitBucket account with write access, not to the repository itself.

Please follow the instructions under Provide Bitbucket Cloud with your public key to add the public ssh key to a Bit Bucket user.

Github

Please follow the instructions here to setup the public ssh key in your Github repository.

Gitlab

Please follow the instructions here to setup the public ssh key in your Gitlab repository. You will to need to grant write permissions to the key.

Add the private key to Ascend

1. In the Ascend UI, navigate to the instance settings (Ascend.io Instance: <instance-name> -> Settings -> Repositories)
2. Click the Add Repository button.
3. Fill in the Repository URL and the private key you generated in the previous step.

tip

You can copy the private key to your clipboard by running cat ~/.ssh/ascend_io_repo_key | pbcopy in your terminal.

4. Click Create.

Next Steps

Now that you have added your repository to Ascend, you can create your first Ascend Project!