feat: Service Catalog GitLab integration

app/_data/docs_nav_konnect.yml

@@ -160,6 +160,8 @@
           url: /service-catalog/integrations/traceable/
         - text: Datadog
           url: /service-catalog/integrations/datadog/
+        - text: GitLab
+          url: /service-catalog/integrations/gitlab/
 
 - title: API Products
   icon: /assets/images/icons/konnect/icn-api-product.svg

app/_data/tables/konnect/integrations.yml

@@ -21,6 +21,11 @@ integrations:
     slug: datadog
     events: true
     description: View the performance and health of your services by ingesting Datadog monitors and dashboards
+  - name: GitLab
+    icon: gitlab.svg
+    slug: gitlab
+    events: true
+    description: Associate a service to one or more GitLab projects
 
 ##### Using this file ######
   # - name: Name of the integration

app/_includes/service-catalog-discovery.html

@@ -1,4 +1,2 @@
-* Discovery {% if include.discovery_support == true %}is{% else %}isn't{% endif %} supported by this integration
-* Discovery {% if include.discovery_default == true %}is{% else %}isn't{% endif %} enabled by default
-* Bindable entities: {{ include.bindable_entities }}
-* Discovery mechanism: {{ include.mechanism }} 
+* Automatic resource discovery {% if include.discovery_support == true %}is{% else %}isn't{% endif %} supported by this integration
+* Resource types: {{ include.bindable_entities }}

app/konnect/service-catalog/integrations/datadog.md

@@ -3,9 +3,7 @@ title: Datadog Integration
 content-type: reference
 beta: true
 discovery_support: true
-discovery_default: true
 bindable_entities: "Datadog Monitor, Datadog Dashboard"
-mechanism: "pull/ingestion model"
 ---
 
 _Type: External_

app/konnect/service-catalog/integrations/github.md

@@ -4,9 +4,7 @@ content-type: reference
 beta: true
 
 discovery_support: true
-discovery_default: true
 bindable_entities: "Repositories"
-mechanism: "pull/ingestion model"
 ---
 
 _Type: External_

app/konnect/service-catalog/integrations/gitlab.md

@@ -0,0 +1,64 @@
+---
+title: GitLab Integration
+content-type: reference
+beta: true
+
+discovery_support: true
+bindable_entities: "Projects"
+---
+
+_Type: External_
+
+The GitLab integration allows you to associate your {{site.service_catalog_name}} service to one or more [GitLab projects](https://docs.gitlab.com/ee/user/get_started/get_started_projects.html). 
+
+For each linked project, the UI can show a **Project Summary** with simple data pulled from the GitLab API, such as the number of open issues, open merge requests, contributors, languages, and latest releases.
+
+## Prerequisites
+
+* You need the [Owner GitLab role](https://docs.gitlab.com/ee/user/permissions.html) to authorize the integration. This is required for event ingestion.
+* Only [GitLab.com subscriptions](https://docs.gitlab.com/ee/subscriptions/gitlab_com/) are supported at this time
+
+## Authorize the GitLab integration
+
+1. From the **{% konnect_icon servicehub %} Service Catalog** in {{site.konnect_product_name}}, select **[Integrations](https://cloud.konghq.com/us/service-catalog/integrations)**. 
+2. Select **GitLab**, then **Install GitLab**.
+3. Click **Authorize**. 
+
+## View GitLab specs in Service Catalog
+
+You can map specs to a Service Catalog service and view them in {{site.konnect_short_name}}.
+
+1. From the **{% konnect_icon servicehub %} Service Catalog** in {{site.konnect_product_name}}, select **[Services](https://cloud.konghq.com/us/service-catalog)**. 
+2. Select a service, then open the **API Specs** tab.
+2. Click **Add API Spec**.
+3. Choose GitLab as the **Source**, then pick your spec and name it.
+
+Once it's uploaded, you can view the rendered spec on the API Specs tab in structured (UI), YAML, or JSON format, and download it in either YAML or JSON format.
+
+## Resources
+
+Entity  | Description
+-------|-------------
+Projects | Organizes all the data for a specific development project that relates to a Service Catalog Service.
+
+## Events
+
+This integration supports events.
+
+You can view the following event types for linked projects from the {{site.konnect_product_name}} UI:
+
+* Opened merge requests
+* Merged merge requests
+
+
+## Discovery information
+
+<!-- vale off-->
+
+{% include_cached service-catalog-discovery.html 
+   discovery_support=page.discovery_support
+   discovery_default=page.discovery_default
+   bindable_entities=page.bindable_entities
+   mechanism=page.mechanism %}
+
+<!-- vale on-->

app/konnect/service-catalog/integrations/pagerduty.md

@@ -3,9 +3,7 @@ title: PagerDuty Integration
 content-type: reference
 beta: true
 discovery_support: true
-discovery_default: true
 bindable_entities: "PagerDuty Service"
-mechanism: "pull/ingestion model"
 ---
 
 _Type: External_

app/konnect/service-catalog/integrations/swaggerhub.md

@@ -3,9 +3,7 @@ title: SwaggerHub Integration
 content-type: reference
 beta: true
 discovery_support: true
-discovery_default: true
 bindable_entities: "SwaggerHub API version"
-mechanism: "pull/ingestion model"
 ---
 
 _Type: External_

app/konnect/service-catalog/integrations/traceable.md

@@ -3,9 +3,7 @@ title: Traceable Integration
 content-type: reference
 beta: true
 discovery_support: true
-discovery_default: true
 bindable_entities: "Traceable Service"
-mechanism: "pull/ingestion model"
 ---
 
 _Type: External_