Skip to content

PREREQUISITES.md

Latest commit

 

History

History
executable file
·
82 lines (57 loc) · 2.5 KB

PREREQUISITES.md

File metadata and controls

executable file
·
82 lines (57 loc) · 2.5 KB
Raw

Prerequisites

hyperfleet-api requires the following tools to be pre-installed:

Go

Go is an open-source programming language that makes it easy to build simple, reliable, and efficient software.

  • Purpose: Required for building and running the hyperfleet binary
  • Version: Go 1.26 or higher (FIPS-compliant crypto support)
  • Installation: Install Go from the official Go website
  • Verification: Run go version to verify installation

Podman

Podman is a daemonless container engine for developing, managing, and running OCI containers.

PostgreSQL Client Tools

PostgreSQL client tools provide the psql command-line interface for database interaction.

  • Purpose: Required for make db/login to connect to the database and inspect schema
  • Installation:
    • macOS: brew install postgresql
    • Ubuntu: apt-get install postgresql-client
    • Fedora: dnf install postgresql
  • Note: The PostgreSQL server itself runs in a container via make db/setup

jq

jq is a lightweight and flexible command-line JSON processor.

  • Purpose: Useful for parsing JSON outputs from API calls and commands
  • Installation: Follow the instructions on the jq official website
  • Verification: Run jq --version

pre-commit

pre-commit is a framework for managing and maintaining multi-language pre-commit hooks.

  • Purpose: Runs commit message validation and code quality checks locally before each commit
  • Installation:
    • macOS: brew install pre-commit
    • pip: pip install pre-commit
  • Verification: Run pre-commit --version

Quick Verification

Run these commands to verify all prerequisites are installed:

# Required tools
go version              # Should show 1.26 or higher
podman --version
psql --version          # PostgreSQL client
jq --version            # JSON processor
pre-commit --version    # Pre-commit hooks

Getting Started

Once all prerequisites are installed, follow the development workflow in README.md:

# Generate OpenAPI code (required before go mod download)
make generate

# Install Go dependencies
go mod download

# Start database
make db/setup

# Build and run
make build
./bin/hyperfleet-api migrate
make run-no-auth