Harness Organizations (Orgs) allow you to group projects that share the same goal. For example, all projects for a business unit or division.
A Harness Project is a group of Harness modules and their Pipelines. For example, a Project might have a Harness CI Pipeline to build code and push an image to a repo and a Harness CD Pipeline to pull and deploy that image to a cloud platform.
You can add an unlimited number of Harness Projects to an Org. All Projects in the Org can use the Org's resources.
This topic describes how to create an Org, invite Harness Users to it as members, and create a Project within the Org.
Before you begin
- Make sure you have the Create permissions for Organizations to create an Org.
- Make sure you have the Create permissions for Project to create a Project.
Within a Harness account, you have Orgs, and within Orgs you have Projects.
The resources in the Org are available to all of its Projects.
Step 1: Create a Harness Org
- In Harness, in Account Settings click Organizations.
- Click +New Organization. The new Organization settings appear.
- In Name, enter a name for your Organization.
- Enter Description, and Tags for your new Org.
- Click Save and Continue.
Step 2: Invite Collaborators
The Org and any Projects added to it are used by their members only.
You don't have to add the same members to an Org and its Projects. You can add Org-level members, and then add Project-level members later when you set up or edit a Project.
In Invite People to Collaborate, type a member's name and select it.
In Role, select the role the member will have in this Org, such as Organization Admin or Organization Member.
Members receive invites via their email addresses.
You can always invite more members from within the Org later.
Click Finish. The Org is added to the list in Account Settings Organizations.
Step 3: Create a Project
You can create Projects in the Org from the Projects section of Harness, or from within the Org. In this example, we'll create Projects in Projects.
- In Harness, go to Home and click Projects.
- Click +Project.
- Name the Project, and select a color. The ID of the project is generated automatically. See Harness Entity Reference.
- In Organization, select the Org you created.
- Add a description and tags, and then click Save and Continue.
- In Invite Collaborators, type a member's name and select it.
- Select a role for the member, and click Add.
- Click Save and Continue to create the Project.
Step 4: Add Modules
Next, the Harness modules appear.
- Select the modules you want to use in your Project. You can select more at any time.
- Close the modules and open your Project in Projects or in its Organization.
- When you open the Project, all of the modules are displayed.
- Pick a module and click Create New Pipeline to get started!