GitLab

You can integrate your TeamRetro team with your GitLab account, and automatically publish action items as GitLab issues. To configure this integration you must be a TeamRetro Team Administrator or an Account Administrator.

Configure in TeamRetro

• Sign in to your TeamRetro account.

• On the TEAM > SETTINGS > INTEGRATIONS screen, click on CONNECT next to GitLab

  

• You will then have the option to choose between the connection type based on your needs

  

• Proceed to enter your Access Token (and the Server URL for GitLab Self Managed connection) that you had created on your account and click on the arrow '->'. If you don't have one, then follow the steps under the 'Creating an Access Token' heading below.

  

  

• If that succeeds, you'll be prompted to select the project you would like to publish your action items to

  

•  Upon a successful connection, you can test the integration by publishing an action item as a GitLab issue

  

  

• Click on SAVE CHANGES and you will see that the connection was successful back on the integrations pages

  

Testing your integration

Back on your TEAM> HOME screen, click the publish icon and you will see PUBLISH TO GITLAB as an option. You can also publish all action items at once. After selecting, TeamRetro will create a new Issue in GitLab and display the corresponding Issue ID on the card.

Creating an Access Token

• To create an access token in GitLab, click on your icon at the top right followed by 'Preferences'

  

• Click on the 'Access Tokens' tab on the left navigation bar

  
  

  

• Give your Access Token a name (e.g. TeamRetro or similar) and check the 'api' scope option underneath the "Select scopes" heading

  

• Click on 'Create personal access token' at the bottom and one will be created for you. Be sure you keep record of it so it isn't lost

  

GitLab APIs Used