This service runs on CCAO's Shiny server/Ubuntu VM and is responsible directing traffic from the Data Department subdomain to various Data Department applications and services. It utilizes a containerized version of NGINX (pronounced "engine-x") to direct traffic.
To start this service, first connect to the Shiny server via SSH (ask IT for login details). Next, go to the folder containing this repository (usually ~/services/service_nginx
) or clone the repo if it doesn't exist locally. Finally, start the service using Docker Compose by typing docker-compose up -d
while in the same folder as docker-compose.yml
.
This service is configured using the nginx.conf
file. See this guide for general NGINX configuration.
NGINX requires SSL or TLS certificates in order to serve websites via HTTPS. These certificates must exist in a subfolder named secrets
and must have a specific names (see below). To generate certificates see this wiki article. The final directory structure should be:
service_nginx
├── docker-compose.yml
├── nginx.conf
└── secrets
├── nginx-selfsigned-datascience.crt
└── nginx-selfsigned-datascience.key