corgi

🐶 CORGI 🐶

Send someone your project yml file, init and run it in minutes.

No more long meetings, explanations of how to run new project with multiple microservices and configs. Just send corgi-compose.yml file to your team and corgi will do the rest.

Auto git cloning, db seeding, concurrent running and much more.

While in services you can create whatever you want, but in db services for now it supports:

• postgres, example
• mongodb, example
• rabbitmq, example
• aws sqs, example
• redis, example
• redis-server
• mysql
• mariadb
• dynamodb
• kafka
• mssql
• cassandra
• cockroachDb
• clickhouse
• scylla
• keydb
• influxdb
• surrealdb
• neo4j
• arangodb
• elasticsearch
• timescaledb
• couchdb
• dgraph
• meilisearch
• faunadb
• yugabytedb
• skytable
• dragonfly
• redict
• valkey
• postgis
• pgvector — postgres + pgvector extension. Uses prefix DB_, same as plain postgres
• localstack — single container for multiple AWS services (sqs, s3, …), with queues / buckets auto-created from config

Preflight & healthcheck

• corgi doctor (alias: check) — before corgi run: verifies every tool in required:, Docker is up, and every port in db_services.*.port / services.*.port is free (lists the offending process if not)
• corgi status (aliases: health, healthcheck) — after corgi run: TCP-probes every declared port. If a service sets healthCheck: /some/path, corgi does an HTTP probe and accepts any non-5xx response as healthy. The localstack driver defaults to GET /_localstack/health.

Documentation

You can check documentation on https://andriiklymiuk.github.io/corgi/

And here is small 2 min video showcase https://youtu.be/rlMCjs4EoFs?si=o3SQaymM55zxBCUY

VSCODE users