Skip to main content

Portal Mode Walkthrough

You've selected Managed by Portal mode. Here's what happens next as you complete the remaining steps.

Step 4: Select Repositories​

Choose the repositories you want to turn into components. In Portal mode:

  • Each repository becomes exactly one component (1:1 mapping)
  • Any existing catalog-info.yaml files are ignored
  • Portal will attempt to detect metadata from the repository

Portal shows all repositories from the organizations you selected in Step 3, regardless of whether they have a catalog-info.yaml file.

Step 5: Fill Missing Details (Optional)​

Portal auto-detects what it can from your repositories, but some information may be missing.

This step is optional. You can:

  • Fill in details now for complete metadata
  • Skip and update later through the Portal UI

Catalog Builder Missing Steps

Step 6: Review and Complete​

Review your selected components before finalizing. This screen shows:

  • All components that will be created
  • Their metadata (name, owner, lifecycle, type)
  • Any warnings or missing information

Click Complete to finish the ingestion.

What Happens Next​

When you complete the workflow:

  1. Components are immediately registered in the catalog
  2. They appear in Portal within 1-2 minutes
  3. All metadata is stored in Portal's database

You can now:

Managing Your Components​

Since these components are managed by Portal:

  • Updates are made using the edit and bulk edit dialogs, not by editing files
  • Metadata lives in Portal's database, not in your repositories
  • No catalog-info.yaml files will be created or used

Need to switch to YAML management later? See the FAQ.

Troubleshooting​

Having issues? Check the Troubleshooting guide for common problems and solutions.