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.