Using Git Provider Integration
Was this helpful?
Was this helpful?
Click New Capsule and select Clone from Git.
Enter the HTTPS link of the Git repo to clone.
If the repo had a metadata, environment, code, or data folder, files in those folders will be stored under the corresponding directory in the Capsule. Otherwise all files will be stored in the "Other Files" section of the Capsule and can subsequently be reorganized.
New changes in the Capsule can be committed in the Capsule Timeline. After changes are committed, Sync with GitHub can be used to push changes to the GitHub repo.
If changes to the repo have been made outside of the Capsule, Check for updates can be used to identify unsynced commits. Sync with GitHub can subsequently be used to pull any new commits from GitHub.
When developing a Capsule with a collaborator, only one person can edit the Capsule at once. Git Provider Integration provides the ability for collaborators to develop a project concurrently by working in multiple Capsules that are all linked to the same GitHub repo. This can be achieved by creating multiple Capsules by cloning the same GitHub repo, or by duplicating a GitHub integrated Capsule and choosing to "Link to Git Repository".
There are two options when duplicating a Capsule linked to a GitHub repo:
Link to Git Repository: the new Capsule will be linked to the same GitHub repo.
Create a new repository in Code Ocean: the new Capsule will be independent of the source Capsule as it will have its own Git repo in Code Ocean's internal Git server.
When developing a new feature or collaboratively developing a repo, it's a good practice to work on a new branch. If the GitHub repo has multiple branches, they will be available in the Capsule upon creation or after syncing with GitHub.
A new branch can be created in the Capsule by opening a Cloud Workstation with access to the terminal and running git branch <new_branch_name> to create the branch or git checkout -b <new_branch_name> to create the branch and immediately switch to it.
Switching between branches in a Capsule's Git repo can be done from the Capsule IDE.
Once changes on a branch have been pushed, a pull request can be opened in GitHub and changes can be merged into the main branch.
Merge conflicts can be resolved in GitHub.
After adding Git credentials to the Account Page, they will automatically be available during runtime and during the environment build stage as the GIT_ACCESS_TOKEN environment variable.
The existence of this variable enables the use of Git commands without providing credentials. This can be used to clone private Git repos for installation as part of the environment, as well as for convenient use of Git commands during a Cloud Workstation session.
If a Capsule wasn’t initially cloned from a GitHub repo, it’s still possible to link a Capsule to an external repo by importing the Capsule to GitHub and then creating a new Capsule from the repo. You can import a Capsule to a new Github repository by completing the following steps.
Create an empty GitHub repo and follow the link to to import a repository.
Complete the "Your source repository details" section using the information from your Code Ocean Capsule and account as shown below.
The URL for your source repository: This is the Code Ocean managed repository of the Capsule or Pipeline. Click on the Pipeline or Capsule drop-down menu in Code Ocean and select "clone via Git" to get the URL of its repository.
Your username for your source repository: The email address you use to log in to Code Ocean.
You can then finish filling out the details on the page as you otherwise would when creating a new Github repository.
When you , the release version will be created from the main branch. A new Git repo is created for the release version within Code Ocean’s internal Git server. As new versions are released, commits are squashed so that there is one tagged commit per release version.
Your access token or password for your source repository: The access token from your Code Ocean Account page. If you haven't created one, you can do so by following . This token only requires read permissions to Capsules and Pipelines.
