Introduction to GitLab integration
Ally’s GitLab integration allows you to update your OKR progress automatically depending on the progress of issues in your GitLab repositories. Let’s say you use GitLab to track the status of issues, and you have an objective in Ally.io for resolving 30 issues every quarter. When you link this objective to the corresponding repository in GitLab, the status of your OKR will be updated as the issues under the associated repository get resolved. You can also track the progress of issues being handled by a specific user for objectives that are user-centric. Ally.io will automatically sync the values for you and chart your progress toward the goal, thus saving time while keeping your OKRs current.
Enabling the GitLab integration
Admins can enable this integration, and here’s how it can be done:
- From the sidebar, click on Admin > select the Integrations tab.
- Against GitLab, you will have an option to Enable the integration. If a connection has been made previously or if the integration has been enabled already, you will have the option to Manage the enabled integration.
- This integration can also be disabled from the same section by clicking on Change, and choosing Disable integration from the dropdown.
Configuring the GitLab connection
- After enabling the integration, the first step is to configure a GitLab connection.
- Select New Connection, and sign into your GitLab account.
- Provide a name for the connection.
- It is optional to share this connection with other users in the organization. Click on Next to get up and running with this integration. You can edit the saved connection at any time.
Ally.io allows you to connect with multiple repositories. Select New Connection to fetch data from another repository. You can differentiate these connections using names, and the names will be displayed to other users when they link their OKRs with GitLab data.
Connecting the GitLab connection to an OKR
Once you have configured the connection, the next step is to start linking OKRs to the GitLab repositories.
- While creating or editing an OKR, click on Connect data source to auto-update progress. From the drop down menu, select GitLab.
- If you have already created a connection, or if your administrator has shared a connection with you, that connection will be selected automatically. Ally.io will prompt you to create a new connection only if there are no connections created or shared.
- Choose the method using which you want to measure the progress — percent complete or KPI (success metric). If you are choosing KPI, provide a metric, starting value, and target value.
- Select a connection, and all the associated repositories will be available in the drop-down. Choose a repository and select a Milestone.
- Select an Assignee to keep tabs on the issues being handled by a specific user. Select the custom labels as applicable.
- You can track the status of issues that are closed, and open. Choose an appropriate status.
- The progress will be computed based on the count of issues (if you have chosen KPI metric to track progress), or will be calculated based on the percentage of issues closed (if you have chosen percent complete to track progress).
Note: If you choose percent complete to track progress, the progress will be computed only based on the percentage of issues resolved. On the other hand, if you want to keep track of the issues that are open as well, you will have to choose a KPI metric to track progress.
- Click Next > Save.
You have successfully linked your objective to a repository in GitLab to track the progress of your issues, and update the status of the corresponding OKR automatically.
The colors of the progress bar indicated the status of the objective.
- If the progress is 0 - 25% less than the expected progress at any given point in time, the OKR status is Behind, and the progress bar color will be Orange.
- If the progress is over 25% less than the expected progress at any given point in time, the OKR status is At Risk, and the progress bar color will be Red.
Setting up the GitLab on-premise integration
To set up the GitLab on-prem integration, please follow the following steps:
- Log into your GitLab account and click on the Applications tab found within the User Settings
- Enter the application name followed by the redirect URL - https://app.ally.io/members/auth/gitlab/callback
- Check the API checkbox within Scopes
- Click on Save Application to generate the Application ID and the Secret
- Once these are generated, please have an account admin reach out to [email protected] or your CSM with the request to set up the integration. Please mention the Application ID and the Secret when you send in your request.
To learn more about Ally’s other integrations, please visit our Integrations page.