Build Your Own Library

Library steps refer to customizable and reusable executions that can be incorporated into Valohai projects. These steps can be either predefined by Valohai’s Ecosystem or custom ones created by users.

Unlike project-specific steps defined in each project’s own valohai.yaml file, library steps are shared across an entire organization.

This articles shows you how to add custom library steps from your public and private Git repositories. For instructions on how to build the library step, see the Docker Image builder from the valohai-toolkit repository.

Requirements

• A Git repository containing a valohai.yaml with at least one step and all the other required code files.

• Admin account in your Valohai organization.

Add a Git-repository with library steps

• Click on Hi, <username>! in the top-right corner.

• Select Manage <organization>.

• Open the Libraries tab.

• Click on the Add a new Library button.

• Name your library. Note that the name can only consist of letters, numbers, underscores or hyphens.

Public Repositories

• Add HTTPS URL of the public repository in the respective field.

  • The URL looks like git+https://github.com/<usename>/<repository>.git

Private Repositories

• Add SSH URL of the private repository in the respective field.

  • The URL looks like [email protected]:<username>/<repository>.git

• Add the SSH private key in the field.

• You can either use the Generate new SSH key button in Valohai or generate the key on your command line with the following command

ssh-keygen -t rsa -b 4096 -f my-project-deploy-key

• Click on the Add Library button.

• Click on the Update button to fetch the commits.

You will need to add the public key as a deploy key for your repository, see the instructions for different hosting services under the Git integration section.

\