Skip to content

Latest commit

 

History

History
111 lines (85 loc) · 2.78 KB

DEVELOPMENT.md

File metadata and controls

111 lines (85 loc) · 2.78 KB

Getting Started

This document provides instructions for setting up the Bencher development environment.

Prerequisites

In order to get started with the project, you will need to have the following prerequisites installed on your machine.

Installation

  1. Fork the repository (optional)
  2. Clone the repository 
    git clone [email protected]:bencherdev/bencher.git
  3. Checkout the devel branch 
    git checkout devel
  4. Build the project 
    cargo build
  5. Run the API service 
    cd services/api
cargo run
  6. Run the Console 
    cd services/console
npm run dev
  7. Configure the CLI environment 
    cd ./services/cli 
. ./env.sh

Accessing the Console

Once the application is running, you can access it by visiting http://localhost:3000 in your browser.

  1. Sign up for an account by entering your name and email address.
  2. Click on the "Confirm Email" link that is provided in the API logs.

Accessing the API

The API is accessible at http://localhost:61016.

Seeding the Database

To seed the database with sample data, run the following command:

cargo test-api seed

Accessing the Database

The data is stored in a SQLite database that is created in the services/api/data directory when the application is started. The database can be accessed using the sqlite3 command:

sqlite3 services/api/data/bencher.db

Architecture and Entity Relationship Diagram

For additional development references, see the Architecture and Schema documents.

Testing with Docker

To test the application using Docker, follow these steps:

  1. Build and run the project

    docker/run.sh

    or run directly with docker compose using the following command:

    X64

    ARCH=amd64 docker compose up --file docker/docker-compose.yml --build

    ARM64

    ARCH=arm64 docker compose up --file docker/docker-compose.yml --build

  2. Open the console in your browser http://localhost:3000.

  3. Sign up for an account by entering your name and email address.

  4. Click on the "Confirm Email" link that is provided in the docker compose logs.