Makefile Reference

CLI reference for managing the infrastructure lifecycle.

Command Interface

The Makefile in the root of the arya-banking-infra repository is the primary interface for all infrastructure operations. It encapsulates complex Docker Compose commands into simple, memorable targets.

Core Lifecycle Commands

Target	Action
`make up`	Starts the entire stack (creates network first).
`make down`	Stops all containers (preserves volumes).
`make restart`	Restarts all containers.
`make clean`	Destructive: Stops all + removes all volumes + orphans.

Targeted Operations

If you only need a specific subset of the infrastructure, use these scoped commands:

Event Batch (Kafka)

make kafka: Start Kafka, Schema Registry, and Connect.
make kafka-down: Stop the Kafka stack.

Identity Batch (Keycloak)

make keycloak: Start Keycloak and PostgreSQL.
make keycloak-down: Stop the Keycloak stack.

Platform Batch (Eureka/Config/Gateway)

make platform: Start Service Registry, Config Server, and API Gateway.
make platform-down: Stop the platform services.

Vault Batch (Secrets)

make vault: Start HashiCorp Vault.
make vault-down: Stop Vault.
make vault-unseal: Auto-initialise and unseal Vault (requires 3 of 5 unseal keys).

Diagnostic Commands

Use these targets to inspect the health and logs of the running infrastructure:

Bash code-highlight

# Show status of all containers
make ps

# Tail logs from all containers
make logs

# View logs for a specific service (native docker compose)
docker compose -f compose/keycloak.yml logs -f keycloak

Network Management

The arya-banking-net network must exist for the services to link correctly.

make network-create: Idempotent creation of the bridge network.
make network-remove: Removes the bridge network.

Docker Compose

Networking