Projects let you manage multiple software projects from the Octopus Web Portal. For each project you have, you define a deployment process (the steps or actions required to deploy your software), configuration variables (for example, application settings, database connection strings), and the environments the software will be deployed to (for example, Development, Test, and Production).
Projects can consist of multiple steps and deliverable components, or they might only have a single step.
When deciding whether you need a single project or multiple projects, here are some points to consider:
- If the packages are delivered by different teams, or have different release schedules and deadlines, use separate projects.
- If the packages are always deployed at the same time, and there is good communication between the teams developing them (or they are the same team), use a single project.
For more options, see the Coordinating Multiple Projects docs.
Projects are managed from the Projects area of the Octopus Web Portal. From here you can see and manage all of your projects and project groups.
Add a Project
Before you can define your deployment process, you must create a project.
- Select Projects from the main navigation, and click ADD PROJECT.
- Give the project a name that's meaningful to you, and anybody else who'll work on the project.
- Add a description for the project.
- If you want to specify the project group or lifecycle, click Advanced Settings.
- Select the Project group from the dropdown menu. (Learn more about project groups).
- Select the lifecycle from the dropdown menu. (Learn more about Lifecycles).
- Click Save and you will be taken to the newly created project's overview page.
The project overview page is where you access settings for the project and define the release process. After you've deployed a few releases, the overview page will give you a visual summary of the project's releases and which environments they've been deployed to.
You can access the project settings menu from the project's overview page. From here it's possible to edit details about the project, such as the name, description, and the project group, add a logo, and control different aspects of the project's release behavior.
If you are likely to have a lot of projects, in addition to giving them meaningful names you can also add a project logo, and make it easier to quickly locate them on the project's page.
- From the project's overview page, select settings.
- Click the Logo section of the settings page.
- Click the file selector and select a file to upload.
- Click open to upload your logo image, and click Save.
Project groups are a way of organizing your projects.
Note, the Default Project group contains all of the projects that have not been added to another group.
Add a Project Group
- From the Projects tab, click ADD GROUP.
- Give the group a meaningful name and description.
- Click SAVE.
When the group is first created, and doesn't have any projects associated with it, you will need to click SHOW EMPTY GROUPS on the projects page to see the group.
Add Projects to a Group
After you have created a project group there are a number of ways you can add projects to the group:
- Navigate to the Projects page from the main navigation, find the group you want to add the project to, and click ADD PROJECT.
- Edit an existing project by navigating to the project, selecting Settings and editing the Project Group.
- Specify the Project Group under Advanced Settings when you create a new project.
Edit or Delete Project Groups
To edit or delete a project group click the project group’s overflow menu and select edit. From there you can edit the groups name or description. If you need to delete the group, click the overflow menu again and select Delete.
For information about project permissions, see managing users and teams.
In This Section
The following topics are explained further in this section: