Project Management
Harness Open Source projects contain your repositories and pipelines. They represent organizational divisions, such as products or teams, and you're provided with granular user access controls at the project level.
Create a project
-
If this is your first project, select New Project from the home page.
Otherwise, from the home page, select Select project, and then select New Project.
-
Enter a project Name and optional Description.
-
Select Create Project.
Import a project
Harness Open Source 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 the home page, then select Import Project.
If you are adding a project, select Select project from the 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.
- Bitbucket Server
- GitHub
- GitLab
To import a Bitbucket Server project, your token must have project and repository "Read" permissions.
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.
To import a GitLab group, 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.
-
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 Harness Open Source to import pipelines from your repositories.
-
Enter the Project name that you want the group or organization to have. 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.
Switch projects
To switch projects, you can either select a project from the project drawer on the navigation menu, or go to the home page and select Select project.
Project members
Administrators and project owners can manage users who are members of the project and their roles.
- 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.
Project roles
Each project member is assigned a particular role. The following table summarizes the roles and access levels.
Project | Members | Repositories | Webhooks | Pipelines | |
---|---|---|---|---|---|
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 |