- Create a group
- Create a project
- Set up an iteration cadence
- Create scoped labels
- Create your epics and issues
- Create an issue board
To run an Agile development iteration in GitLab, you use multiple GitLab features that work together.
To run an Agile iteration from GitLab:
- Create a group.
- Create a project.
- Set up an iteration cadence.
- Create scoped labels.
- Create your epics and issues.
- Create an issue board.
After you’ve created these core components, you can begin running your iterations.
Iteration cadences are created at the group level, so start by creating one if you don’t have one already.
You use groups to manage one or more related projects at the same time. You add your users as members in the group, and assign them a role. Roles determine the level of permissions each user has on the projects in the group. Membership automatically cascades down to all subgroups and projects.
Now create one or more projects in your group. There are several different ways to create a project. A project contains your code and pipelines, but also the issues that are used for planning your upcoming code changes.
Before you start creating epics or issues, create an iteration cadence. Iteration cadences contain the individual, sequential iteration timeboxes for planning and reporting on your issues.
When creating an iteration cadence, you can decide whether to automatically manage the iterations or disable the automated scheduling to manually manage the iterations.
Similar to membership, iterations cascade down your group, subgroup, and project hierarchy. If your team has multiple groups and projects, create the iteration cadence in the top-most shared group:
You should also create scoped labels in the same group where you created
your iteration cadence. Labels help you
organize your epics, issues, and merge requests, as well as help you
to visualize the flow of issues in boards. For example, you can use scoped labels like
workflow::ready for development,
workflow::in development, and
to indicate the status of an issue. You can also leverage scoped labels to denote the type of issue
or epic such as
Now you can get started planning your iterations. Start by creating epics in the group where you created your iteration cadence, then create child issues in one or more of your projects. Add labels to each as needed.
Issue boards help you plan your upcoming iterations or visualize the workflow of the iteration currently in progress. List columns can be created based on label, assignee, iteration, or milestone. You can also filter the board by multiple attributes and group issues by their epic.
In the group where you created your iteration cadence and labels, create an issue board and name it “Iteration Planning.” Then, create lists for each of your iterations. You can then drag issues from the “Open” list into iteration lists to schedule them for upcoming iterations.
To visualize the workflow for issues in the current iteration, create another issue board called “Current Iteration.” When you’re creating the board:
- Select Edit board.
- Next to Iteration, select Edit.
- From the dropdown list, select Current iteration.
- Select Save changes.
Your board will now only ever show issues that are in the current iteration.
You can start adding lists for each of the
workflow::... labels you created previously.
Now you’re ready to start development.