Merge pull request #15888 from dpfaffenbauer/gitlab-org-catalog-provider

Implement gitlab Organization catalog provider for Users and Groups

docs/integrations/gitlab/org.md

@@ -0,0 +1,34 @@
+---
+id: org
+title: GitLab Org
+sidebar_label: Org Data
+description: Importing users and groups from a GitLab organization into Backstage
+---
+
+The Backstage catalog can be set up to ingest organizational data - users and
+teams - directly from an organization in GitLab. The result
+is a hierarchy of
+[`User`](../../features/software-catalog/descriptor-format.md#kind-user) and
+[`Group`](../../features/software-catalog/descriptor-format.md#kind-group) kind
+entities that mirror your org setup.
+
+```yaml
+integrations:
+  gitlab:
+    - host: gitlab.com
+      token: ${GITLAB_TOKEN}
+```
+
+This will query all users and groups from your gitlab installation. Depending on the size
+of the Gitlab Instance, this can take some time our resources.
+
+The token that is used for the Organization Integration, has to be an Admin PAT.
+
+```yaml
+catalog:
+  providers:
+    gitlab:
+      yourProviderId:
+        host: gitlab.com
+        orgEnabled: true
+```