Skip to content

feat(Console): Add quick setup feature#209

Open
vignesh-manel wants to merge 1 commit intoapache:mainfrom
vignesh-manel:feature/quickstart
Open

feat(Console): Add quick setup feature#209
vignesh-manel wants to merge 1 commit intoapache:mainfrom
vignesh-manel:feature/quickstart

Conversation

@vignesh-manel
Copy link
Copy Markdown
Contributor

@vignesh-manel vignesh-manel commented Apr 5, 2026

Adds an interactive wizard to the console that lets users bootstrap Polaris from scratch — creating principal roles, principals, catalogs, namespaces, and catalog roles in one guided flow using either preset examples or user-provided YAML.

Features & Changes

  • Two setup modes — choose a ready-made preset (Local File, AWS S3, Azure ADLS, Google Cloud) or paste/upload a custom YAML config in the same format as polaris setup apply
  • Guided preset flow — parameterized inputs (catalog name, storage location, role ARN, etc.) with required-field validation before proceeding
  • YAML mode with live validation — 300ms debounce parse with inline feedback; validates structure, required fields (storage_type, default_base_location), and storage type values
  • Step preview — review all planned actions before applying; existing entities are automatically skipped (409 treated as success)
  • Live progress view — each step updates in real-time as it executes; failed steps are clearly flagged while remaining steps continue where possible
  • Credential display — generated principal credentials are shown with copy buttons at the end of the flow; not persisted anywhere
  • Error resilience — catalog sub-steps are skipped gracefully if catalog creation fails; a fatal API error (e.g. 403 on list) halts remaining steps cleanly with a summary

Limitations / Known Issues

  • No partial resume — if the wizard is closed mid-execution, there is no way to resume; re-running from the start is safe (idempotent) but will skip already-created entities
  • YAML validation is structural only — the wizard validates shape and required fields but does not verify that referenced roles, catalogs, or principals actually exist in Polaris before running
  • Preset YAML view is read-only — the generated config from a preset cannot be edited in the wizard before applying; switch to YAML mode for full control
  • Credentials shown once — generated client secrets are displayed only in the final step and are not recoverable after closing the wizard
  • No teardown support — the wizard only creates entities; there is no corresponding flow to delete or clean up the resources it provisioned
Screen.Recording.2026-04-05.at.4.13.41.PM.mov

@vignesh-manel vignesh-manel marked this pull request as ready for review April 5, 2026 15:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant