Lite version of BRACELET, connecting scientific instruments running on old operating systems to 4CeeD cloud.
Based on the following open-source projects:
- Docker version 1.10.0+
- Docker Compose version 1.6.0+
- A running instance of cloud-based 4CeeD
- A NGINX reverse proxy running on BRACELET edge server
Configure 4ceeduploader
service in docker-compose.yml
file with information of 4CeeD instance:
UPLOADER_HOME
: Home address of this uploaderCURATOR_HOME
: Alias address of the cloud-based 4CeeD instance that uploader will communicate with on behalf of the instruments. This address is set asUPLOADER_HOME/curatorhome/
.CURATOR_API_URL
: Alias address of the cloud-based 4CeeD APIs' base URL that uploader will communicate with on behalf of the instruments. This address is set asUPLOADER_HOME/curatorapi/
.
Edit NGINX configuration file (i.e., often located at /etc/nginx/nginx.conf
), and add the following reverse proxy configuration to the http
server block:
location / {
proxy_pass http://127.0.0.1:8000/;
}
location /curatorhome/ {
proxy_pass http://[CURATOR_IP_ADDR];
}
location /curatorapi/ {
proxy_pass http://[CURATOR_IP_ADDR]/api/;
}
In the above configuration, the first location
block configures reverse proxy for accessing 4CeeD Uploader on BRACELET server, the second location
block configures reverse proxy for accessing cloud-based 4CeeD instance via BRACELET, and the third location
block configures reverse proxy for accessing APIs on cloud-based 4CeeD via BRACELET.
Run the following command for the new configurations to take effect:
sudo nginx -s reload
Configure bro
service in docker-compose.yml
to listen to different network interface (default is eth0
).
To run BRACELET-Lite:
docker-compose up
Or, to run BRACELET-Lite in detached mode:
docker-compose up -d
To stop BRACELET-Lite, simply press Ctrl+C
if running in foreground mode, or run the following command if running in detached mode:
docker-compose down
After deploying BRACELET-Lite, 4CeeD uploader can be accessed at the address specify in UPLOADER_HOME
.