Polaris Local Forge

What it does

Polaris Local Forge provides a full local development environment for Apache Polaris: automated init, cluster creation, RustFS S3-compatible storage, PostgreSQL metastore, Apache Polaris deployment, catalog setup, and verification via DuckDB. It also includes an L2C (Local-to-Cloud) migration workflow to move Iceberg tables to real AWS S3 and register External Iceberg Tables in Snowflake. The skill emphasizes safe, idempotent CLI usage via the plf wrapper and manifest-driven replay/resume flows.

When to use it

Use this for local development, testing, or demos that require a reproducible Polaris environment. Typical triggers include: creating a local polaris cluster, verifying catalog queries, running DuckDB checks, preparing for L2C migration, or exporting a manifest to share setup. Avoid using it for production deployments.

What's included

• Scripts: Extensive CLI patterns and Ansible playbooks invoked via ./bin/plf (init, prepare, cluster create, polaris deploy, catalog setup, l2c commands).
• References: Detailed guidance on manifest management, credential masking, scrubbed AWS environment for L2C, and troubleshooting steps.
• Instructions: Step-by-step flow for init → doctor → prepare → cluster create → deploy → bootstrap → catalog setup → verify, plus teardown and replay flows.

Compatible agents

Agents that can run shell commands and manage work directories (Cursor, Claude Code with uv/CLI support) are compatible. The skill expects an interactive confirmation pattern for destructive operations and uses a manifest in .snow-utils/ to track state.