{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":32211,"path":"it-service-management/devops-change-velocity/sc-gitlab.md","title":"Onboard GitLab to DevOps Change Velocity — Service Catalog","bundle":null,"doc_type":null,"release":"australia","body":"\n# Onboard GitLab to DevOps Change Velocity — Service Catalog\n\nCreate, connect, discover, and configure your GitLab instance using the ServiceNow Service Catalog.\n\n## Before you begin\n\nRole required: sn\\_devops.admin or sn\\_devops.tool\\_owner\n\n## Procedure\n\n1.  Navigate to **All** &gt; **Service Catalog** &gt; **Catalog Definitions** &gt; **Maintain Items** and search for DevOps.\n\n    **Note:** You can also access the service catalog from Employee Center or Service portal.\n\n2.  From the DevOps catalog items, select and activate **DevOps App Onboarding** and **DevOps Tool Onboarding**.\n\n3.  After activating, select **DevOps Tool Onboarding** and select **Try it**.\n\n4.  In the DevOps Tool Onboarding form, enter the tool details:\n\n<table id=\"table_ubw_p1p_gwb\"><thead><tr><th>\n\nField\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nTool name\n\n</td><td>\n\nName for your GitLab integration.\n\n</td></tr><tr><td>\n\nTool integration\n\n</td><td>\n\nSelect GitLab.\n\n</td></tr><tr><td>\n\nTool URL\n\n</td><td>\n\nURL of your GitLab instance.\n\n</td></tr><tr><td>\n\nCredential type\n\n</td><td>\n\nSelect Basic Auth or OAuth, depending on the credentials you're using.-   For Basic Auth, enter the username and password or access token.\n-   For OAuth, enter the credentials.\n\n\n</td></tr><tr><td>\n\nTool password/ Access token/API Key\n\n</td><td>\n\nGitLab password or access token.\n\n</td></tr><tr><td>\n\nUse MidServer\n\n</td><td>\n\nOptional. Select MID Server for an on-premises tool that is attached to a MID Server. Application is automatically set to  DevOps and capability is set to REST.\n\n</td></tr></tbody>\n</table>    For a list of all the permissions required on the credentials for connecting to GitLab, see GitLab permissions in [Permissions required for DevOps tools](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/devops-change-velocity/tool-req-permission.md).\n\n5.  Select **Order Now**.\n\n    A request is created. When the request is approved, the tool is created, connected, and discovered.\n\n6.  From the DevOps catalog items, select **DevOps App Onboarding**.\n\n7.  In the DevOps App Onboarding form, enter the details:\n\n<table id=\"table_vb5_s3p_gwb\"><tbody><tr><td>\n\nAre you creating a new app or adding to an existing one?\n\n</td><td>\n\nSelect from the options whether to create a new app or use an existing app.\n\n</td></tr><tr><td>\n\nApp\n\n</td><td>\n\nEnter the name for the app that you're creating or using.\n\n</td></tr><tr><td>\n\nOnboarding pipelines\n\n</td><td>\n\nLeave empty.\n\n</td></tr><tr><td>\n\nOnboarding repositories\n\n</td><td>\n\nEnter the connected GitLab tool name.\n\n</td></tr><tr><td>\n\nRepositories\n\n</td><td>\n\nSelect the repositories for which you want to configure webhooks and import historical data.\n\n</td></tr><tr><td>\n\nImport from and Import to\n\n</td><td>\n\nSelect the dates for which you want to import the data. By default, the last 30 days are selected. You can choose to import data for a maximum of 90 days.\n\n</td></tr><tr><td>\n\nDo you wish to configure webhook for the tool?\n\n</td><td>\n\nSelect the check box if you want to configure webhooks for the selected repositories.\n\n</td></tr><tr><td>\n\nOnboarding plans\n\n</td><td>\n\nEnter the connected GitLab tool name.\n\n</td></tr><tr><td>\n\nPlans\n\n</td><td>\n\nSelect the plans for which you want to import historical data.\n\n</td></tr><tr><td>\n\nImport from and Import to\n\n</td><td>\n\nSelect the dates for which you want to import the Plans data. By default, the last 30 days are selected. You can choose to import data for a maximum of 90 days.\n\n</td></tr></tbody>\n</table>8.  Select **Order Now**.\n\n    A request is created. When the request is approved, the plan and repository objects are associated to the app record and webhooks are configured for real-time tracking. Historical data is imported for the selected plans and repositories. The **Track** field is automatically enabled for imported repositories.\n\n\n**Parent Topic:**[GitLab integration with DevOps Change Velocity](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/devops-change-velocity/gitlab-integration-dev-ops.md)\n\n"}}