Merge pull request #2905 from port-labs/PORT-16593-Update-docs-on-Gitlab-v2-for-Release-and-Tag-Kinds-Addition

sivanel97 · web-flow · commit 8ceba14c11a0 · 2025-10-21T10:01:25.000+03:00
docs: Support for Release and Tag kinds for Gitlab v2 integration
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-files/_gitlab_integration_example_package_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-files/_gitlab_integration_example_package_blueprint.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary><b>Package blueprint (click to expand)</b></summary>
 ```json showLineNumbers
 {
   "identifier": "package",
@@ -26,4 +28,5 @@
   "aggregationProperties": {},
   "relations": {}
 }
-```
+```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-files/_gitlab_integration_example_package_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-files/_gitlab_integration_example_package_config.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary><b>Integration mapping (click to expand)</b></summary>
 ```yaml showLineNumbers
 resources:
   - kind: file
@@ -21,3 +23,4 @@ resources:
             package: .item.key
             version: .item.value
 ```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-folders/_gitlab_export_example_monorepo_port_app_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-folders/_gitlab_export_example_monorepo_port_app_config.mdx
@@ -1,6 +1,6 @@
 <details>
 
-<summary> Integration mapping </summary>
+<summary><b>Integration mapping (click to expand)</b></summary>
 
 ```yaml showLineNumbers
 resources:
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-folders/_gitlab_integration_example_folder_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-folders/_gitlab_integration_example_folder_blueprint.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary><b>Folder blueprint (click to expand)</b></summary>
 ```json showLineNumbers
 {
   "identifier": "gitlabFolder",
@@ -32,4 +34,5 @@
     }
   }
 }
-```
+```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-folders/_gitlab_integration_example_folder_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-folders/_gitlab_integration_example_folder_config.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary><b>Integration mapping (click to expand)</b></summary>
 ```yaml showLineNumbers
 resources:
   - kind: project
@@ -40,4 +42,5 @@ resources:
             readme: file://README.md
           relations:
             project: .references.full | gsub("!.+"; "")
-```
+```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-groups/_gitlab_exporter_example_group_repository_port_app_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-groups/_gitlab_exporter_example_group_repository_port_app_config.mdx
@@ -1,7 +1,5 @@
 <details>
-
-<summary> Integration mapping </summary>
-
+<summary><b>Integration mapping (click to expand)</b></summary>
 ```yaml showLineNumbers
 deleteDependentEntities: true
 createMissingRelatedEntities: true
@@ -43,5 +41,4 @@ resources:
               .path_with_namespace | gsub(" "; "") | split("/") | .[:-1] |
               join("/")
 ```
-
 </details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-groups/_gitlab_integration_example_group_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-groups/_gitlab_integration_example_group_blueprint.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary><b>Group blueprint (click to expand)</b></summary>
 ```json
 {
   "identifier": "gitlabGroup",
@@ -39,4 +41,5 @@
   "aggregationProperties": {},
   "relations": {}
 }
-```
+```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-groups/_gitlab_integration_example_group_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-groups/_gitlab_integration_example_group_config.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary><b>Integration mapping (click to expand)</b></summary>
 ```yaml showLineNumbers
 resources:
   - kind: group
@@ -13,4 +15,5 @@ resources:
             url: .web_url
             visibility: .visibility
             description: .description
-```
+```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-groups/_gitlab_integration_example_group_members_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-groups/_gitlab_integration_example_group_members_blueprint.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary><b>Group with members blueprint (click to expand)</b></summary>
 ```json showLineNumbers
 {
   "identifier": "gitlabGroup",
@@ -46,4 +48,5 @@
     }
   }
 }
-```
+```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-groups/_gitlab_integration_example_group_members_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-groups/_gitlab_integration_example_group_members_config.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary><b>Integration mapping (click to expand)</b></summary>
 ```yaml showLineNumbers
 resources:
   - kind: group-with-members
@@ -15,4 +17,5 @@ resources:
             description: .description
           relations:
             gitlabMembers: .__members | map(.username)
-```
+```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-groups/_gitlab_integration_example_group_project_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-groups/_gitlab_integration_example_group_project_blueprint.mdx
@@ -1,5 +1,5 @@
 <details>
-<summary>Project blueprint</summary>
+<summary><b>Project blueprint (click to expand)</b></summary>
 ```json showLineNumbers
 {
   "identifier": "service",
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-issues/_gitlab_integration_example_issue_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-issues/_gitlab_integration_example_issue_blueprint.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary><b>Issue blueprint (click to expand)</b></summary>
 ```json
 {
   "identifier": "gitlabIssue",
@@ -57,4 +59,5 @@
     }
   }
 }
-```
+```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-issues/_gitlab_integration_example_issue_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-issues/_gitlab_integration_example_issue_config.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary><b>Integration mapping (click to expand)</b></summary>
 ```yaml showLineNumbers
 resources:
   - kind: project
@@ -37,4 +39,5 @@ resources:
             labels: "[.labels[]]"
           relations:
             project: .references.full | gsub("#.+"; "")
-```
+```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-jobs/_gitlab_integration_example_job_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-jobs/_gitlab_integration_example_job_blueprint.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary><b>Job blueprint (click to expand)</b></summary>
 ```json showLineNumbers
 {
   "identifier": "gitlabJob",
@@ -59,4 +61,5 @@
     }
   }
 }
-```
+```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-members/_gitlab_integration_example_member_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-members/_gitlab_integration_example_member_blueprint.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary><b>Member blueprint (click to expand)</b></summary>
 ```json showLineNumbers
 {
   "identifier": "gitlabMember",
@@ -35,4 +37,5 @@
   "aggregationProperties": {},
   "relations": {}
 }
-```
+```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-members/_gitlab_integration_example_member_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-members/_gitlab_integration_example_member_config.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary><b>Integration Mapping (click to expand)</b></summary>
 ```yaml showLineNumbers
 resources:
   - kind: member
@@ -14,4 +16,5 @@ resources:
             state: .state
             email: .email
             created_by: .created_by.name
-```
+```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-merge-requests/_gitlab_integration_example_merge_request_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-merge-requests/_gitlab_integration_example_merge_request_blueprint.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary><b>Merge request blueprint (click to expand)</b></summary>
 ```json showLineNumbers
 {
   "identifier": "gitlabMergeRequest",
@@ -71,4 +73,5 @@
     }
   }
 }
-```
+```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-merge-requests/_gitlab_integration_example_merge_request_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-merge-requests/_gitlab_integration_example_merge_request_config.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary><b>Integration configuration (click to expand)</b></summary>
 ```yaml showLineNumbers
 resources:
   - kind: project
@@ -44,4 +46,5 @@ resources:
             reviewers: .reviewers | map(.name)
           relations:
             project: .references.full | gsub("!.+"; "")
-```
+```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-pipelines/_gitlab_integration_example_pipeline_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-pipelines/_gitlab_integration_example_pipeline_blueprint.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary><b>Pipeline blueprint (click to expand)</b></summary>
 ```json showLineNumbers
 {
   "identifier": "gitlabPipeline",
@@ -50,4 +52,5 @@
     }
   }
 }
-```
+```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-pipelines/_gitlab_integration_example_pipeline_job_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-pipelines/_gitlab_integration_example_pipeline_job_config.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary><b>Integration Mapping (click to expand)</b></summary>
 ```yaml showLineNumbers
 resources:
   - kind: pipeline
@@ -37,4 +39,5 @@ resources:
             link: .web_url
           relations:
             pipeline: .pipeline.id | tostring
-```
+```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-projects/_gitlab_integration_example_project_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-projects/_gitlab_integration_example_project_blueprint.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary><b>Project blueprint (click to expand)</b></summary>
 ```json showLineNumbers
 {
   "identifier": "service",
@@ -42,4 +44,5 @@
   "calculationProperties": {},
   "relations": {}
 }
-```
+```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-projects/_gitlab_integration_example_project_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-projects/_gitlab_integration_example_project_config.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary><b>Integration Mapping (click to expand)</b></summary>
 ```yaml showLineNumbers
 resources:
   - kind: project
@@ -18,4 +20,5 @@ resources:
             namespace: .namespace.name
             fullPath: .namespace.full_path
             defaultBranch: .default_branch
-```
+```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-releases/_gitlab_integration_example_release_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-releases/_gitlab_integration_example_release_blueprint.mdx
@@ -0,0 +1,65 @@
+<details>
+<summary><b>Release blueprint (click to expand)</b></summary>
+```json showLineNumbers
+{
+    "identifier": "gitlabRelease",
+    "title": "GitLab Release",
+    "icon": "GitVersion",
+    "schema": {
+      "properties": {
+        "tagName": {
+          "title": "Tag Name",
+          "type": "string"
+        },
+        "name": {
+          "title": "Name",
+          "type": "string"
+        },
+        "description": {
+          "title": "Description",
+          "type": "string",
+          "format": "markdown"
+        },
+        "createdAt": {
+          "title": "Created At",
+          "type": "string",
+          "format": "date-time"
+        },
+        "releasedAt": {
+          "title": "Released At",
+          "type": "string",
+          "format": "date-time"
+        },
+        "author": {
+          "title": "Author",
+          "type": "string"
+        },
+        "commitSha": {
+          "title": "Commit SHA",
+          "type": "string"
+        },
+        "upcomingRelease": {
+          "title": "Upcoming Release",
+          "type": "boolean"
+        }
+      }
+    },
+    "calculationProperties": {},
+    "aggregationProperties": {},
+    "relations": {
+      "service": {
+        "title": "Service",
+        "target": "service",
+        "required": false,
+        "many": false
+      },
+      "gitlabMember": {
+        "title": "Author",
+        "target": "gitlabMember",
+        "required": false,
+        "many": false
+      }
+    }
+}
+```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-releases/_gitlab_integration_example_release_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-releases/_gitlab_integration_example_release_config.mdx
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-tags/_gitlab_integration_example_tag_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-tags/_gitlab_integration_example_tag_blueprint.mdx
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-tags/_gitlab_integration_example_tag_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-tags/_gitlab_integration_example_tag_config.mdx
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/examples.md b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/examples.md
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/mapping_extensions.md b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/mapping_extensions.md
diff --git a/src/components/ocean-saas-specifics/live-events.jsx b/src/components/ocean-saas-specifics/live-events.jsx

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,5 @@`
	`1`	`+<details>`
	`2`	`+<summary><b>Package blueprint (click to expand)</b></summary>`
`1`	`3`	```json showLineNumbers
`2`	`4`	`{`
`3`	`5`	`"identifier": "package",`
`@@ -26,4 +28,5 @@`
`26`	`28`	`"aggregationProperties": {},`
`27`	`29`	`"relations": {}`
`28`	`30`	`}`
`29`		-```
	`31`	+```
	`32`	`+</details>`
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,5 @@`
	`1`	`+<details>`
	`2`	`+<summary><b>Folder blueprint (click to expand)</b></summary>`
`1`	`3`	```json showLineNumbers
`2`	`4`	`{`
`3`	`5`	`"identifier": "gitlabFolder",`
`@@ -32,4 +34,5 @@`
`32`	`34`	`}`
`33`	`35`	`}`
`34`	`36`	`}`
`35`		-```
	`37`	+```
	`38`	`+</details>`
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,5 @@`
	`1`	`+<details>`
	`2`	`+<summary><b>Group blueprint (click to expand)</b></summary>`
`1`	`3`	```json
`2`	`4`	`{`
`3`	`5`	`"identifier": "gitlabGroup",`
`@@ -39,4 +41,5 @@`
`39`	`41`	`"aggregationProperties": {},`
`40`	`42`	`"relations": {}`
`41`	`43`	`}`
`42`		-```
	`44`	+```
	`45`	`+</details>`
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,5 @@`
	`1`	`+<details>`
	`2`	`+<summary><b>Group with members blueprint (click to expand)</b></summary>`
`1`	`3`	```json showLineNumbers
`2`	`4`	`{`
`3`	`5`	`"identifier": "gitlabGroup",`
`@@ -46,4 +48,5 @@`
`46`	`48`	`}`
`47`	`49`	`}`
`48`	`50`	`}`
`49`		-```
	`51`	+```
	`52`	`+</details>`