Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -0,0 +1,62 @@
```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
}
}
}
```
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
```yaml showLineNumbers
resources:
- kind: release
selector:
query: 'true'
port:
entity:
mappings:
identifier: .__project.path_with_namespace + "/" + .tag_name | gsub(" "; "")
title: .name
blueprint: '"gitlabRelease"'
properties:
tagName: .tag_name
name: .name
description: .description
createdAt: .created_at
releasedAt: .released_at
author: .author.name
commitSha: .commit.id
upcomingRelease: .upcoming_release
relations:
service: .__project.path_with_namespace | gsub(" "; "")
gitlabMember: .author.username
```
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
```json showLineNumbers
{
"identifier": "gitlabTag",
"title": "GitLab Tag",
"icon": "GitVersion",
"schema": {
"properties": {
"tagName": {
"title": "Tag Name",
"type": "string"
},
"message": {
"title": "Message",
"type": "string"
},
"protected": {
"title": "Protected",
"type": "boolean"
},
"createdAt": {
"title": "Created At",
"type": "string",
"format": "date-time"
},
"commitSha": {
"title": "Commit SHA",
"type": "string"
},
"commitTitle": {
"title": "Commit Title",
"type": "string"
}
}
},
"calculationProperties": {},
"aggregationProperties": {},
"relations": {
"service": {
"title": "Service",
"target": "service",
"required": false,
"many": false
}
}
}
```
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
```yaml showLineNumbers
resources:
- kind: tag
selector:
query: 'true'
port:
entity:
mappings:
identifier: .__project.path_with_namespace + "/" + .name | gsub(" "; "")
title: .name
blueprint: '"gitlabTag"'
properties:
tagName: .name
message: .message
protected: .protected
createdAt: .created_at
commitSha: .commit.id
commitTitle: .commit.title
relations:
service: .__project.path_with_namespace | gsub(" "; "")
```
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,10 @@ import GroupMembersConfig from './example-groups/_gitlab_integration_example_gro
import PipelineBlueprint from './example-pipelines/_gitlab_integration_example_pipeline_blueprint.mdx'
import JobBlueprint from './example-jobs/_gitlab_integration_example_job_blueprint.mdx'
import PipelineJobConfig from './example-pipelines/_gitlab_integration_example_pipeline_job_config.mdx'
import ReleaseBlueprint from './example-releases/_gitlab_integration_example_release_blueprint.mdx'
import ReleaseConfig from './example-releases/_gitlab_integration_example_release_config.mdx'
import TagBlueprint from './example-tags/_gitlab_integration_example_tag_blueprint.mdx'
import TagConfig from './example-tags/_gitlab_integration_example_tag_config.mdx'

import Tabs from "@theme/Tabs"
import TabItem from "@theme/TabItem"
Expand Down Expand Up @@ -392,3 +396,49 @@ You can use the following Port blueprint definitions and integration configurati

:::

## Mapping releases

The following example demonstrates how to ingest your GitLab releases to Port.
You can use the following Port blueprint definitions and integration configuration:

<details>
<summary>Release blueprint</summary>
<ReleaseBlueprint />
</details>
Comment on lines +404 to +407
Copy link
Contributor

@sivanel97 sivanel97 Oct 19, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it's better to add the details and summary in the template itself, so when using it, this won't be repeated each time.

Also, please add bold and (click to expand) to the collapsible.
like so:

<details>
<summary><b>TItle (Click to expand)</b></summary>

...

</details>


<details>
<summary>Integration Mapping</summary>
<ReleaseConfig />
</details>

:::tip Learn more

- Refer to the [setup](/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/#setup) section to learn more about the integration configuration setup process.
- We leverage [JQ JSON processor](https://stedolan.github.io/jq/manual/) to map and transform GitLab objects to Port entities.
- Click [Here](https://docs.gitlab.com/api/releases/) for the GitLab release object structure.

:::

## Mapping tags

The following example demonstrates how to ingest your GitLab tags to Port.
You can use the following Port blueprint definitions and integration configuration:

<details>
<summary>Tag blueprint</summary>
<TagBlueprint />
</details>

<details>
<summary>Integration Mapping</summary>
<TagConfig />
</details>

:::tip Learn more

- Refer to the [setup](/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/#setup) section to learn more about the integration configuration setup process.
- We leverage [JQ JSON processor](https://stedolan.github.io/jq/manual/) to map and transform GitLab objects to Port entities.
- Click [Here](https://docs.gitlab.com/api/tags/) for the GitLab tag object structure.

:::

6 changes: 5 additions & 1 deletion src/components/ocean-saas-specifics/live-events.jsx
Original file line number Diff line number Diff line change
Expand Up @@ -139,7 +139,11 @@ export const liveEvents = {
\n\n**Jobs:** \
\n- build \
\n\n**Pipelines:** \
\n- pipeline ",
\n- pipeline \
\n\n**Releases:** \
\n- release \
\n\n**Tags:** \
\n- tag_push ",
Linear:
"\n- Issue \
\n- IssueLabel",
Expand Down