Each project is linked to a specific Git repository. If your application is composed of several Git repositories, you will need to create several projects on Artifakt or gather your source code within the same repository.
Artifakt integrates with GitHub, GitLab and Bitbucket. If your Git repository is hosted by one of these providers, then you can easily connect it to your Artifakt project from the project settings. Just go to Project → Settings → Environment, click on Link to a different repository and follow the steps (selecting the version manager, the Git repository and the branch to deploy by default).
Artifakt can also integrate with any Git-based version-control system (via SSH or HTTPS) that you might host yourself.
If you want to use a private repository, you will need to allow Artifakt to clone your source code. Here are the steps to follow:
You specify the URL of your Git repository
We generate an SSH key pair
You add our public key to your Git account (if your project uses private submodules, you must also add the public SSH key to those repositories)
We then use that SSH key to clone your Git repository
You can modify a Git repository in any project at any time. Just go to Project → Settings → Environment and click on Link to a different repository.
The submodule option is enabled by default during the build steps on Artifakt.
To include an outside repository as a subdirectory in your own repository, always configure it as a submodule. If you do not, it may work locally via cloning, but the sub-repository content will not be pushed to your Git provider, and it will not be available to your build on Artifakt.
If a submodule repository is public, you can use
HTTPS format (for example,
https://github.com/owner/project) to link it in your submodule configuration. If the repository is private, or if you prefer to use
SSH format (for example,
[email protected]:owner/project.git), you will need to add the deploy key provided by Artifakt to the repository.