IMPORTANT: This documentation has been discontinued. Read the updated Projects documentation on our new documentation portal.
Projects are like folders that have the function of organizing and grouping pipelines, allowing effective control of which users have access to particular pipelines. Read below what you can do with the betaversion of Projects:
Creating a Project
To create a project follow the steps below:
Click the “+ CREATE” button in the upper right corner on the Build page;
Select the "Project" option;
A form requesting project information will be displayed next to it, with the following fields:
Name: project name;
Description: complementary field to hold project information;
Assigned groups: list of groups whose users must have access to the project;
Assigned users: specific users who will have access to the project.
It is possible to select the checkbox "Select all users" so that all users registered in the realm will have access to the project.
At least one user must be associated with the project.
How to edit a project
To edit a project follow the steps below:
Locate the project in the side listing to the left of the screen;
Click on the options’ button next to the project;
Select the “Edit” option.
After doing the changes click on “SAVE” in the lower right corner.
How to archive a Project
To archive a project follow the steps below:
Locate the project in the side listing to the left of the screen;
Click on the options’ button next to the project;
Select the “Archive” option.
The project can only be archived if there are no pipelines inside of it.
IMPORTANT: all existing pipelines will be in the default project when you access the beta version of the Projects functionality. When a new pipeline is created without “Projects”, it is kept in the project Default.
Project access management
Using the division of pipelines into projects, we manage the users who can interact with them through the fields:
Assigned groups
Assigned users
We can give or remove users’ access to pipelines that are inside the project.
How to organize pipelines in Projects
If you don't have any projects created yet, all your pipelines are grouped on the Default project.
After creating your projects, open the Default project and drag the pipelines to the desired project.
Note: Whenever you are viewing a project and create a pipeline, this pipeline will be linked to the project that was being viewed.
Reorganizing pipelines and projects
To move a pipeline from one project to another, click the highlighted icon (containing six dots) in the image below and drag a pipeline to any created project. It is also possible to select multiple pipelines to be included in a project. To do this, hold the CTRL-key (or CMD for Mac) and click on the pipelines to drag them using the indicated icon: