Overview
A repository is where your code is stored. When developers make changes to code in a Gitness repository, those changes are tracked with version control. Gitness fosters collaboration and governance with code reviews, approvals, status checks, and more.
Create a repository
- In your project, select Repositories, and then select New Repository.
- Enter a repository Name and optional Description.
- Gitness repositories are initialized with a
main
branch, unless you specify a different name for the base branch. To change the base branch name, select main and enter a name for the base branch. - Select your preference for visibility (Public or Private).
- Optionally, you can add a License, .gitignore, or README file to your repository.
- Select Create Repository.
Import a repository
Gitness can import repositories from external sources such as GitLab or GitHub.
-
In your project, select Repositories.
-
Select the dropdown next to New Repository, and then select Import Repository.
-
Enter the Repository URL.
-
If the repository is private, select Requires Authorization and provide your authorization credentials to access the repository.
- Bitbucket Server
- GitHub
- GitLab
To import a Bitbucket Server repository, your token must have repository "Read" permissions.
For more information, refer to Bitbucket Server's Personal access tokens documentation.
To import a GitHub repository, your token must have repo and read:org permissions.
For more information, refer to GitHub's Creating classic personal access tokens and Available scopes documentation.
To import a GitLab repository, your token must have read_api and read_repository scopes.
For more information, refer to GitLab's Create a personal access token and Personal access token scopes documentation.
-
Enter a repository Name and optional Description.
-
Select your preference for visibility (Public or Private).
-
Select Import Repository.
Work with repositories
After creating a repository, you can:
- Clone your repository.
- Create a branch, commit changes, and open a pull request.
- Create tags.
- Create pipelines and configure webhooks.