Skip to content

Commit bc6aa61

Browse files
committed
added gitlab to bulk import docs
1 parent ea2ea45 commit bc6aa61

4 files changed

+28
-20
lines changed

modules/importing-repositories/proc-importing-multiple-repositories-from-gitlab.adoc

Lines changed: 10 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,16 +4,23 @@
44
= Importing multiple repositories from GitLab
55

66
In {product}, you can select your GitLab projects and automate their onboarding to the {product-short} catalog.
7+
This feature is a Technology preview.
8+
9+
[IMPORTANT]
10+
====
11+
Technology Preview features provide early access to upcoming product innovations, enabling you to test functionality and provide feedback during the development process.
12+
However, these features are not fully supported under Red Hat Subscription Level Agreements, may not be functionally complete, and are not intended for production use.
13+
As Red Hat considers making future iterations of Technology Preview features generally available, we will attempt to resolve any issues that customers experience when using these features.
14+
See: link:https://access.redhat.com/support/offerings/techpreview/[Technology Preview support scope].
15+
====
716

817
.Prerequisites
918
* You have xref:enabling-and-giving-access-to-the-bulk-import-feature[enabled the Bulk Import feature and gave access to it].
10-
//link to official GitLab documentation for PAT creation?
11-
* You have set up a GitLab personal access token (PAT).
19+
* You have set up a link:https://docs.gitlab.com/user/profile/personal_access_tokens/[GitLab personal access token (PAT)].
1220

1321
.Procedure
1422
. In {product-very-short}, click *Bulk Import*
1523
. Click *Import*.
16-
//next step is from Luke's video for the upstream Backstage feature. is the downstream setup the same?
1724
. Select GitLab as your *Approval tool* option.
1825
. Use the *Project* and *Group* views to see the list of all available GitLab projects and groups:
1926
** Use the *Project* view to select GitLab projects for importing.

modules/importing-repositories/procedure-enabling-the-bulk-import-from-github-feature.adoc

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,8 +8,7 @@ This feature is available for GitHub repositories and GitLab projects.
88

99
.Prerequisites
1010
* For GitHub only: You have {integrating-with-github-book-link}#enabling-github-repository-discovery[enabled GitHub repository discovery].
11-
//is this the correct prerequisite for GitLab? if yes, is it documented in RHDH?
12-
* For GitLab only: You have enabled GitLab repository discovery.
11+
1312

1413
.Procedure
1514
. The Bulk Import plugins are installed but disabled by default.
@@ -41,5 +40,5 @@ See {authorization-book-link}#ref-rbac-permission-policies_title-authorization[P
4140

4241
.Verification
4342
* The sidebar displays a *Bulk Import* option.
44-
* The *Bulk Import* page shows a list of *Added Repositories*.
43+
* The *Bulk Import* page shows a list of added GitHub repositories and GitLab projects.
4544

modules/importing-repositories/procedure-importing-multiple-repositories-from-github.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,6 +33,6 @@ To view more details about the reasons, click *Edit*.
3333
. Review and merge each pull request that creates a `catalog-info.yml` file.
3434

3535
.Verification
36-
* The *Added repositories* list displays the repositories you imported, each with an appropriate status: either _Waiting for approval_ or _Added_.
36+
* The *Added entities* list displays the repositories you imported, each with an appropriate status: either _Waiting for approval_ or _Added_.
3737
* For each _Waiting for approval_ import job listed, there is a corresponding pull request adding the `catalog-info.yaml` file in the corresponding repository.
3838

Lines changed: 15 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,32 +1,34 @@
11
:_mod-docs-content-type: PROCEDURE
22

33
[id="managing-the-added-repositories"]
4-
= Managing the added repositories
4+
= Managing the added Git repositories
55

6-
You can oversee and manage the repositories that are imported to the {product-short}.
6+
You can oversee and manage the Git repositories that are imported to the {product-short}.
77

88
.Prerequisites
99
* You have xref:importing-multiple-github-repositories[imported GitHub repositories].
1010

1111

1212
.Procedure
13-
. Click *Bulk Import* in the left sidebar to display all the current repositories that are being tracked as Import jobs, along with their status.
13+
. Click *Bulk Import* in the left sidebar to display all the current GitHub repositories and GitLab projects that are being tracked as Import jobs, along with their status.
1414

15-
Added:: The repository is added to the {product-short} catalog after the import pull request is merged or if the repository already contained a `catalog-info.yaml` file during the bulk import.
15+
Added:: The Git repository is added to the {product-short} catalog after the import pull request is merged
16+
or if the Git repository already contained a `catalog-info.yaml` file during the bulk import.
1617
Note that it may take a few minutes for the entities to be available in the catalog.
1718

18-
Waiting for approval:: There is an open pull request adding a `catalog-info.yaml` file to the repository.
19+
Waiting for approval:: There is an open pull request or merge request
20+
adding a `catalog-info.yaml` file to the GitHub repository or GitLab project.
1921
You can:
20-
* Click the *pencil icon* on the right to see details about the pull request or edit the pull request content right from {product-short}.
21-
* Delete the Import job, this action closes the import PR as well.
22-
* To transition the Import job to the _Added_ state, merge the import pull request from the Git repository.
22+
* Click the *pencil icon* on the right to see details about the pull request or merge request. You can use the detailed view to edit the request content right from {product-short}.
23+
* Delete the Import job, this action closes the import pull request or merge request as well.
24+
* To transition the Import job to the _Added_ state, merge the import pull request or merge request from the Git repository.
2325

24-
Empty:: {product-short} is unable to determine the import job status because the repository is imported from other sources but does not have a `catalog-info.yaml` file and lacks any import pull request adding it.
26+
Empty:: {product-short} is unable to determine the import job status because the Git repository is imported from other sources but does not have a `catalog-info.yaml` file and lacks any import pull or merge request adding it.
2527

2628
[NOTE]
2729
====
28-
* After an import pull request is merged, the import status is marked as _Added_ in the list of Added Repositories, but it might take a few seconds for the corresponding entities to appear in the {product-short} Catalog.
29-
* A location added through other sources (like statically in an `{my-app-config-file}` file, dynamically when {integrating-with-github-book-link}#enabling-github-repository-discovery[enabling GitHub discovery], or registered manually using the "Register an existing component" page) might show up in the Bulk Import list of Added Repositories if the following conditions are met:
30-
** The target repository is accessible from the configured GitHub integrations.
31-
** The location URL points to a `catalog-info.yaml` file at the root of the repository default branch.
30+
* After an import pull request or merge request is merged, the import status is marked as _Added_ in the list of *Added entities*, but it might take a few seconds for the corresponding entities to appear in the {product-short} Catalog.
31+
* A location added through other sources (for example, statically in an `{my-app-config-file}` file, dynamically when {integrating-with-github-book-link}#enabling-github-repository-discovery[enabling GitHub discovery], or registered manually using the "Register an existing component" page) might show up in the Bulk Import list of Added Repositories if the following conditions are met:
32+
** The location URL points to a `catalog-info.yaml` file at the root of the Git repository default branch.
33+
** For GitHub only: The target repository is accessible from the configured GitHub integrations.
3234
====

0 commit comments

Comments
 (0)