55655efabf
Before this fix there were various issues with the test server framework, most noticeably servers stopping when they shouldn't causing timeouts. This was caused by the reference counting in the Go code not being engineered to work in multiple processes so it was not working at all properly. This fix moves the reference counting logic to the start scripts and in turn removes that logic from the Go code. This means that the reference counting is now global and works correctly over multiple processes.
1.8 KiB
This directory contains scripts to start and stop servers for testing.
The commands are named after the remotes in use. They are executable files with the following parameters:
start - starts the server if not running
stop - stops the server if nothing is using it
status - returns non-zero exit code if the server is not running
reset - stops the server and resets any reference counts
These will be called automatically by test_all if that remote is required.
When start is run it should output config parameters for that remote.
If a _connect parameter is output then that will be used for a
connection test. For example if _connect=127.0.0.1:80 then a TCP
connection will be made to 127.0.0.1:80 and only when that succeeds
will the test continue.
If in addition to _connect, _connect_delay=5s is also present then
after the connection succeeds rclone will wait 5s before continuing.
This is for servers that aren't quite ready even though they have
opened their TCP ports.
Writing new scripts
A docker based server or an rclone serve based server should be easy
to write. Look at once of the examples.
run.bash contains boilerplate to be included in a bash script for
interpreting the command line parameters. This does reference counting
to ensure multiple copies of the server aren't running at once.
Including this is mandatory. It will call your start(), stop() and
status() functions.
docker.bash contains library functions to help with docker
implementations. It contains implementations of stop() and
status() so all you have to do is write a start() function.
rclone-serve.bash contains functions to help with rclone serve
based implementations. It contains implementations of stop() and
status() so all you have to do is write a start() function which
should call the run() function provided.