The Adaptavist Group LogoDocumentation

Importing Repos

Managing owners now have a better way to import repositories into Venue.sh—either one repo at a time or many at once—in a simple, user-friendly process. Gone are the days of creating yaml files from scratch and adding details to the catalog via template. Now you can import and manage as many repos as you like in a matter of minutes, all without writing a single line of code.

Importing repos is part of the onboarding process for Venue owners. The four onboarding steps appear on the Home screen until each step is completed.

To reiterate, the four onboarding steps for owners are as follows:

  1. Create a connection
  2. Create a team
  3. Enable plugins
  4. Import repositories
Note:

The Get started with Venue.sh onboarding will disappear from the Home screen once all four onboarding steps are complete.

Importing Repos into Venue.sh

Begin the import process from your Venue Home screen.

Note: Prerequisites

Ensure onboarding Steps 1-3 (outlined above) are complete before your import repos.

  1. Click one of the following options, each of which leads to the same import process
    • Run an import from the Quick Start tile
    • Step 4: Import repositories from the onboarding steps
    • Imports from the left-side navigation
    The New Import wizard appears.
  2. Select the Git connection from which you want to pull a list of repos, then click Next step.

    A list of available repos is generated on the screen.

  3. Select the repos you want to import into the venue, then click Next step.

    The configuration screen appears.

  4. Select your metadata preferences for each repo from the drop-down options, and type your desired values into the free-text fields, e.g., Namespace and Tags.
    Note:

    • Adding metadata details to new entities helps track entities within the Venue catalog.

    • You can only add a single value for Namespace and Tag; however, you can edit the component post-import (Step 8) and add additional values if you'd like.

  5. Optional: If active, click Configure optional fields to select and add fields from your enabled plugins to the configuration table. If no plugins are enabled, this button will be inactive.
  6. Click Next step.

    The Finalize import summary appears.

  7. Review the values and, once approved, click Import.
    The import runs, and a success message appears.
  8. Click Go to Catalog to view and/or edit the new components.
    Tip:

    In the catalog, filter results using the options on the left side of the page, or use the keyword search. Click Edit to make updates to a component or other entities within the catalog.

    You can update the title, description, add additional Namespace and Tag values, and more.

See Also

  • TechDocs - Publish and browse MkDocs documentation from catalog Components.
  • AI Settings - Index imported repositories for search, general AI usage, and repository-aware Assistant answers.

Search documentation

Start typing to search the docs.