Skip to main content

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 Backstage 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.

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 sceen.

  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.