insta-infra

A simple, fast CLI tool for spinning up data infrastructure services using Docker or Podman.

Features

• Run data infrastructure services with a single command
• Supports both Docker and Podman container runtimes
• Embed all configuration files in the binary for easy distribution
• Optional data persistence
• Connect to services with pre-configured environment variables

Installation

Using Homebrew

# Add the tap
brew tap data-catering/insta-infra

# Install insta-infra
brew install insta-infra

From Source

# Clone the repository
git clone https://github.com/data-catering/insta-infra.git
cd insta-infra

# Build and install
make install

Using Go

go install github.com/data-catering/insta-infra/v2/cmd/[email protected]

Manual Installation

If you prefer to install manually from release archives:

1. Visit the GitHub releases page

2. Download the appropriate archive for your system:

   • For macOS ARM64: insta-v2.0.2-darwin-arm64.tar.gz
   • For macOS Intel: insta-v2.0.2-darwin-amd64.tar.gz
   • For Linux ARM64: insta-v2.0.2-linux-arm64.tar.gz
   • For Linux Intel: insta-v2.0.2-linux-amd64.tar.gz
   • For Windows ARM64: insta-v2.0.2-windows-arm64.zip
   • For Windows Intel: insta-v2.0.2-windows-amd64.zip

3. Extract the archive:

   # For .tar.gz files
   tar -xzf insta-v2.0.2-<os>-<arch>.tar.gz
   
   # For .zip files (Windows)
   unzip insta-v2.0.2-windows-<arch>.zip

4. Move the binary to a directory in your PATH:

   # For macOS/Linux
   sudo mv insta /usr/local/bin/
   
   # For Windows (PowerShell as Administrator)
   Move-Item insta.exe C:\Windows\System32\

5. Make the binary executable (macOS/Linux only):

   chmod +x /usr/local/bin/insta

Requirements

• Docker (20.10+) or Podman (3.0+)
• For Docker: Docker Compose plugin
• For Podman: Podman Compose plugin or podman-compose

Usage

# List available services
insta -l

# Start a service
insta postgres

# Start multiple services
insta postgres mysql elasticsearch

# Start a service with persistent data
insta -p postgres

# Connect to a running service
insta -c postgres

# Shutdown services
insta -d postgres

# Shutdown all services
insta -d

# Explicitly start a service in docker or podman
insta -r docker postgres
insta -r podman postgres

# Show help
insta -h

# Show version
insta -v

Data Persistence

By default, all data is stored in memory and will be lost when the containers are stopped. To enable persistence, use the -p flag:

insta -p postgres

This will store data in ~/.insta/data/<service_name>/persist/.

Development

Project Structure

.
├── cmd/
│   └── insta/          # Main CLI application
│       ├── container/  # Container runtime implementations
│       ├── resources/  # Embedded resources
│       │   ├── data/   # Service configuration files
│       │   └── *.yaml  # Docker compose files
│       ├── models.go   # Service definitions
│       └── main.go     # CLI entry point
├── tests/              # Integration tests
├── Makefile            # Build and development tasks
└── README.md           # Documentation

Development Workflow

1. Clone the repository
2. Make changes
3. Run tests: make test
4. Build: make build
5. Run: ./insta

Adding a New Service

1. Add service configuration to docker-compose.yaml
2. Add service definition to models.go
3. Add any necessary initialization scripts to cmd/insta/resources/data/<service_name>/
4. Update tests

Services

Service Type	Service	Supported
Api Gateway	kong	✅
Cache	redis	✅
Change Data Capture	debezium	✅
Code Analysis	sonarqube	✅
Database	cassandra	✅
Database	cockroachdb	✅
Database	elasticsearch	✅
Database	influxdb	✅
Database	mariadb	✅
Database	milvus	✅
Database	mongodb	✅
Database	mssql	✅
Database	mysql	✅
Database	neo4j	✅
Database	opensearch	✅
Database	postgres	✅
Database	qdrant	✅
Database	spanner	✅
Database	sqlite	✅
Database	timescaledb	✅
Database	weaviate	✅
Data Catalog	amundsen	✅
Data Catalog	datahub	✅
Data Catalog	lakekeeper	✅
Data Catalog	marquez	✅
Data Catalog	openmetadata	✅
Data Catalog	polaris	✅
Data Catalog	unitycatalog	✅
Data Collector	fluentd	✅
Data Collector	logstash	✅
Data Visualisation	blazer	✅
Data Visualisation	evidence	✅
Data Visualisation	grafana	✅
Data Visualisation	metabase	✅
Data Visualisation	redash	✅
Data Visualisation	superset	✅
Distributed Coordination	zookeeper	✅
Distributed Data Processing	flink	✅
Distributed Data Processing	ray	✅
Feature Store	feast	✅
Identity Management	keycloak	✅
Job Orchestrator	airflow	✅
Job Orchestrator	dagster	✅
Job Orchestrator	mage-ai	✅
Job Orchestrator	prefect	✅
Messaging	activemq	✅
Messaging	kafka	✅
Messaging	nats	✅
Messaging	pulsar	✅
Messaging	rabbitmq	✅
Messaging	solace	✅
ML Platform	mlflow	✅
Monitoring	loki	✅
Monitoring	prometheus	✅
Notebook	jupyter	✅
Object Storage	minio	✅
Query Engine	duckdb	✅
Query Engine	flight-sql	✅
Query Engine	presto	✅
Query Engine	trino	✅
Real-time OLAP	clickhouse	✅
Real-time OLAP	doris	✅
Real-time OLAP	druid	✅
Real-time OLAP	pinot	✅
Schema Registry	confluent-schema-registry	✅
Secret Management	vault	✅
Test Data Management	data-caterer	✅
Tracing	jaeger	✅
Web Server	httpbin	✅
Web Server	httpd	✅
Workflow	maestro	✅
Workflow	temporal	✅

Updating

Using the CLI

The easiest way to update is using the built-in update command:

insta -u

This will automatically:

1. Check for the latest version
2. Download the appropriate binary for your platform
3. Install the update
4. Create a backup of the old version

Using Package Managers

If you installed via a package manager, you can update using the standard update commands:

# Debian/Ubuntu
sudo apt update && sudo apt upgrade

# RHEL/CentOS/Fedora
sudo dnf update
# or
sudo yum update

# Arch Linux
sudo pacman -Syu

# macOS (Homebrew)
brew upgrade

# Windows (Chocolatey)
choco upgrade insta

Manual Update

If you prefer to update manually:

1. Download the latest release from the GitHub releases page
2. Replace your existing binary with the new one
3. Make sure the binary is executable: chmod +x insta