History

Daniel Markstedt 85edd50047 Partition and format HFS/FAT volumes in the Web UI + SMB install (#946 ) - New "format as" option when creating new images; removing the image creation options from easyinstall - Bring in HFSer as new submodule providing the driver binaries; removing the Lido driver binary from this repo - Add SpeedTools driver option - Point to github mirror of hfdisk, since the original git server is down - While rearranging the easyinstall options, moved the CtrlBoard option up to the main section - Add an easyinstall script to configure Samba, while consolidating file sharing with Netatalk		2022-11-01 16:43:24 -07:00
..
pytest	Docker container for Pytest (#901 )	2022-10-14 19:30:08 -07:00
rascsi	Break out frontend and backend auth options into stand alone options (#925 )	2022-10-21 19:49:53 -07:00
rascsi-web	Partition and format HFS/FAT volumes in the Web UI + SMB install (#946 )	2022-11-01 16:43:24 -07:00
volumes	Add Docker environment for development and testing of the web UI	2022-09-08 12:19:30 +01:00
README.md	Add Docker environment for development and testing of the web UI	2022-09-08 12:19:30 +01:00
docker-compose.override.yml.example	Add Docker environment for development and testing of the web UI	2022-09-08 12:19:30 +01:00
docker-compose.yml	Docker container for Pytest (#901 )	2022-10-14 19:30:08 -07:00

README.md

Docker Environment for Development and Testing

⚠️ Important: The Docker environment is unable to connect to the RaSCSI board and is intended for development and testing purposes only. To setup RaSCSI on a Raspberry Pi refer to the setup instructions on the wiki instead.

Introduction

This documentation currently focuses on using Docker for developing and testing the web UI.

Additions, amendments and contributions for additional workflows are most welcome.

Getting Started

The easiest way to launch a new environment is to use Docker Compose.

cd docker
docker compose up

Containers will be built and started for the RaSCSI server and the web UI.

The web UI can be accessed at:

To stop the containers, press Ctrl + C, or run docker compose stop from another terminal.

Environment Variables

The following environment variables are available when using Docker Compose:

Environment Variable	Default
`OS_DISTRO`	debian
`OS_VERSION`	buster
`OS_ARCH`	amd64
`WEB_HTTP_PORT`	8080
`WEB_HTTPS_PORT`	8443
`WEB_LOG_LEVEL`	info
`RASCSI_HOST`	rascsi
`RASCSI_PORT`	6868
`RASCSI_PASSWORD`	[None]
`RASCSI_LOG_LEVEL`	debug

Examples:

Run Debian "bullseye":

OS_VERSION=bullseye docker compose up

Start the web UI with the log level set to debug:

WEB_LOG_LEVEL=debug docker compose up

Volumes

When using Docker Compose the following volumes will be mounted automatically:

Local Path	Container Path
docker/volumes/images/	/home/pi/images/
docker/volumes/config/	/home/pi/.config/rascsi/

How To

Rebuild Containers

You should rebuild the container images after checking out a different version of RaSCSI or making changes which affect the environment at build time, e.g. easyinstall.sh.

docker compose up --build

Open a Shell on a Running Container

Run the following command, replacing [CONTAINER] with rascsi or rascsi_web.

docker compose exec [CONTAINER] bash

Setup Live Editing for the Web UI

Use a docker-compose.override.yml to mount the local python directory to /home/pi/RASCSI/python/ in the rascsi_web container.

Any changes to *.py files on the host computer (i.e. in your IDE) will trigger the web UI process to be restarted in the container.

Example:

services:
  rascsi_web:
    volumes:
      - ../python:/home/pi/RASCSI/python:delegated

Connect the Web UI to a Real RaSCSI

This can be useful for testing, but there are some caveats, e.g. the RaSCSI and the web UI will be accessing separate images directories.

RASCSI_HOST=foo RASCSI_PASSWORD=bar docker compose up