Skip to content

admin.md

Latest commit

 

History

History
54 lines (42 loc) · 2.26 KB

admin.md

File metadata and controls

54 lines (42 loc) · 2.26 KB
Raw

Server administration

Job processing

See Job processing design for the processing architecture, job execution flow, Slicer CLI registration guidance, and the category scoping that keeps VolView tasks separate from HistomicsUI and DIVE-DSA tasks in a shared slicer_cli_web deployment.

Production task images

Publish custom task images to a container registry and list immutable versions under slicer-cli-image in the DSA provision YAML. See Building and deploying custom Slicer CLIs for the complete workflow, including private registries.

Local reference image

The development stack uses the VolView Radiology CLI as reference infrastructure to drive and test the processing backend. Clone it locally and set CLI_REPO in this repository's .env to that checkout:

git clone https://github.com/PaulHax/volview-radiology-cli
# In girder_volview/.env:
CLI_REPO=/path/to/volview-radiology-cli

When processing routes are present, script/deploy calls script/ensure-radiology-cli. That script builds the local volview-radiology-cli:latest image if it is missing, registers it with slicer_cli_web, and verifies the declared tasks are available. It does not pull this image from a registry.

Speedup S3 file downloading by disabling proxying

The VolView plugin proxies request to download files from S3 by default. This avoids a CORS error when loading a file from an S3 bucket asset store without CORS configuration. To speed up downloading of files from S3, the Girder admin can:

  1. Configure CORS in the S3 bucket for the Girder server.
  2. Change the global Girder configuration to add a [volview] section with a proxy_assetstores = False option. See below:
[volview]
# Workaround CORS configuration errors in S3 assetstores.
# If True, the Girder server will proxy file download requests from
# VolView clients to the S3 assetstore. This will use more server bandwidth.
# If False, VolView client requests to download files are redirected to S3.
# Defaults to True.
proxy_assetstores = False