Requirements
- A private Azure Devops repository
- A Valohai project
- A tool that generates SSH keys. You can either use Valohai’s user interface for this or
ssh-keygen
Recommended reading
Git for Data Science: What every data scientist should know about Git
Generate an SSH key pair
The easiest way to generate SSH key pair is to click the Generate new SSH key button in the Valohai web app. Go to Valohai and navigate to the repository settings in your Valohai Project through Settings > Repository.
Click on the “Generate SSH Key” button.
This will generate you a new SSH key pair and you can download/copy both the Public (.pub) and Private key (.pem).
Generate an SSH key pair locally
If you want you can also use ssh-keygen to create a new SSH key pair.
ssh-keygen -t rsa -b 4096 -f my-project-deploy-key
This will generate two files:
-
my-project-deploy-key.pub
is the public key you add to GitHub. -
my-project-deploy-key
is the private key you add to Valohai.
Don’t include the keys in your version control
You should not include these keys in the version control. Anybody that gains access to the my-project-deploy-key file contents will have read access to your repository, so use appropriate caution.
Add the public key to Azure DevOps
Find the my-project-deploy-key.pub file we generated in the last section, and it should contain one line that starts with ssh-rsa AAAA.... This line is the public key that we’ll be adding to Azure DevOps.
Now go to your Azure DevOps repository and navigate to the add deploy key page by clicking on User settings > SSH Public Keys
Add new deploy key
- Copy and paste the contents of .pub into the Key field.
- Give the deploy key an identifying Title such as Valohai.
- Valohai doesn’t require write access, make sure that is off.
Add the private key to Valohai
Go back to Valohai and navigate to the repository settings in your Valohai Project through Settings > Repository.
To make sure you get the correct repository URL, open Azure DevOps in another tab. On Azure DevOps, navigate to your project > Repository page and under Clone to your computer
Make sure you Clone with SSH. By default, the HTTPS is selected so make sure you click the SSH button to get the right URL.
Then copy the text field with git@ssh.dev.azure.com:<owner>/<repository>.git
Next, paste the SSH URL (git@ssh.dev.azure.com:<owner>/<repository>.git
) into the URL field in the Valohai Repository settings.
- On your local machine, locate the private key file generated earlier:
valohai-public_xxx.pem
ormy-project-deploy-key
(without the.pub
extension). - Open the file, which should contain multiple lines starting with
-----BEGIN RSA PRIVATE KEY-----
or a similar header. - Copy the entire contents of the
.pem
file ormy-project-deploy-key
. - In the Valohai UI, locate the SSH private key field.
- Paste the copied private key contents into this field.
After you click Save, Valohai links the Azure DevOps repository to the project and automatically fetches your code.
After you add new commits to your Azure Devops repository, remember to press the Fetch repository to update the code in Valohai.