Question: using SchemaHero without kubernetes or docker

[quenbyako]

To be honest, I am absolutely lost in the documentation, so here I ask you to help me understand what I should do to use SchemaHero.

I have a simple task: when prototyping my service, I want to immediately use a declarative architecture for describing both the database schema and queries. I don't want to install Kubernetes on my machine, or even Minikube, simply because SchemaHero suggests it as the main (only?) reason for using it. By the way, our team uses Hashicorp stack, and no adapters, Krew, Quay, or anything else will work. Even Docker is ineffective for prototyping on the knees (which is our current step).

In this regard, I want to ask you (I’m even ready to contribute to the documentation, just tell me where to start): how the hell can I run schemahero just on my MacBook, without Kubernetes, Dockers, Shmockers, without “very convenient applications inside the K8S runtime” and so on? What binaries do I need to download so that I can fully work with a bare metal database?

I tried just to download binary from release page, but only one thing i made sucessfully is generate yaml files from my db, (an even that it's incorrect: generate command thought that my views are base tables); planning sql — not working (or i didn't find in the docs right steps), direct patching of schema — not working, postgres built-in hstore type is named as USER-DEFINED which is also quite strange. In a short words — what's wrong with the docs? 🤔

[marccampbell]

@quenbyako It's a fair criticism. We built SchemeHero with Kubernetes in mind, and then learned that a lot of people (including us) want to make the K8s operator part optional. It's very possible to run it from the CLI only, assuming you can connect to your database from the CLI of course.

The docs attempt to explain this: https://schemahero.io/docs/advanced/operatorless-mode/

If you have that YAML file, you can then use the schemahero plan and schemahero apply commands. The docs are pretty weak here, IMO.

The schemahero team is at KubeCon this week, and has some time planned. Docs are on the short list of things we need to update!