Gitness projects contain your repositories and pipelines. They represent organizational divisions, such as products or teams, and Gitness provides granular user access controls at the project level.
Create a project
If this is your first project, select New Project from your Gitness home page.
Otherwise, from your Gitness home page, select Select project, and then select New Project.
Enter a project Name and optional Description.
Select Create Project.
Import a project
Gitness supports importing projects from external sources such as GitLab groups and GitHub organizations.
If this is your first project, expand the dropdown next to New Project from your Gitness home page, then select Import Project.
If you are adding a project, select Select project from your Gitness home page, expand the dropdown next to New Project, then select Import Project.
Select your Git Provider and optionally enter the Host URL if required.
Provide your authorization credentials to access your group or organization.
For Password/Token, provide a token with permission to access the group or organization.
To import a Bitbucket Server project, your token must have project and repository "Read" permissions.
- Bitbucket Server
For more information, refer to Bitbucket Server's Personal access tokens documentation.To import a GitHub organization, 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.
Select Next step.
Enter the Name of the group or organization that you want to import.
For What to import, you can select Pipelines if you want Gitness to import pipelines from your repositories.
Enter the Project name that you want the group or organization to have in Gitness. The Description is optional.
Select Import Project.
Edit or delete a project
You can delete projects and edit project names and descriptions from the Settings page in your project.
Deleting a project permanently removes the project and all contents, including repositories.
This can't be undone.
To switch projects, you can either select a project from the project drawer on the navigation menu, or go to your Gitness home page and select Select project.
- In your project, select Members, and then select Add Member.
- Select a user from the dropdown.
- Assign a Role to the user.
- Select Add member to this Project.
Each project member is assigned a particular role. The following table summarizes the roles and access levels.
|Owner||Create, Edit, Delete||Add, Remove||Create, Edit, Delete||Create, Edit, Delete||Create, Edit, Execute, Delete|
|Contributor||View access||View access||Push access||View access||Edit YAML|
|Executor||View access||View access||View status check report||View access||Execute|
|Reader||View access||View access||Read only||View access||Read only|