Skip to main content

Add Git to an Existing Application

If you have been building an application on your own and want to bring in other team members, Add Git to Application connects it to a Git repository. Once the application is in Git, your team can collaborate on it, every change is tracked, and you can return to a previous version when something goes wrong.

Before you begin​

  • An empty Git repository. Koodisi treats a repository with existing history — including a readme-only repository — as content to be cloned rather than initialized. If the repository already holds an application, use Clone from git instead. See Cloning Git Applications.
  • Git credentials for that repository: a username and a personal access token.
  • The application must be an orchestration application. Bundle applications cannot use Git.

Adding the application to Git​

  1. In the Applications panel, right-click the application.
  2. Select Add Git to Application.
  3. Enter the Remote Url of your repository.
  4. Select the Multi module repository checkbox if this repository holds several applications, each in its own folder.
  5. Provide your Git credentials, using Use Existing Credentials, New Credentials, or Continue Without Credential. For guidance on each option, see Creating a Git-Enabled Application.
  6. Select Save.

How you know it worked​

The Version Control icon becomes available in the right sidebar when the application is selected. Open it and the panel shows your application's files on the Changes tab, ready to be staged.

Your application is not in the repository yet — connecting it does not push it. Stage the content on the Changes tab and commit it. That first commit creates the branch and puts the application on the remote. See Using Git with Applications.

When it does not work​

SymptomCauseWhat to do
The repository contains application content. Use Clone from Git instead.The repository already holds an application.Use an empty repository, or clone the existing application as a new one.
Repository already has history, including README-only repositories. Use Clone from Git to preserve it.The repository has commits.Use an empty repository, or clone.
The repository README conflicts with this application's documentation. Use an empty repository or Clone from Git as a new application.The repository readme collides with the application's own documentation file.Use an empty repository, or clone as a new application.
Bundle applications can't be used with GitThe application is a bundle.Git control is available for orchestration applications.

Next steps​