FrontLineLive

Front Line Live code and target operating model

• Description of the platform
• Who built it
• Why it's important
• How to install your own instance

GitHub Secrets

* Should be environment specific.

Deployment secrets

Secret Name	Description
ARM_ACCESS_KEY	Azure Storage Account used for TF remote state. See here.
ARM_CLIENT_ID*
ARM_CLIENT_SECRET*
ARM_SUBSCRIPTION_ID*
ARM_TENANT_ID*
ACR_USERNAME	Username for ACR's Admin Account.
ACR_PASSWORD	Password for ACR's Admin Account.
ACR_SERVER	The login server for ACR

Application secrets

Secret Name	Description
APP_DATA_SUPPLIERS_SHEET*	-
APP_EMAIL_FROMADDRESS*	-
APP_EMAIL_SENDGRIDKEY*	-
APP_EMAIL_SENDGRIDUSER*	-
APP_EMAIL_TOADDRESS*	-
APP_MAPBOX_TOKEN*	Map Token
APP_RECAPTCHA_SECRETKEY*	-
APP_RECAPTCHA_SITEKEY*	-
APP_DATACONTEXT*	-
WEB_USERSECRETSID*	-
SQL_ADMIN_PASSWORD*	-
CONTENTFUL_DELIVERY_ACCESS_TOKEN*	Content Delivery API - access token
CONTENTFUL_SPACE_ID*	Contentful Space ID
CONTENTFUL_ENVIRONMENT*	Name of Contentful environment in use
POSTTAG_ENDPOINT*	-
POSTTAG_ID*	-
POSTTAG_API_KEY*	-

Domain names and CORS allowed origins setting

Check build_and_deploy.yml. For list values, they should be JSON encoded.

Local development

Technologies

• Docker
• Docker Compose
• .NET core 3.1.401
• PgSQL
• Node.js 14 + React.js 17
• Python 3.9 + FastAPI 0.71.0
• SQL Server
• Azure Data Studio (Non-Windows environment only)
• GNU Make (For Linux/ macOS users)

Setup (Using GNU Make)

# Prepare local development settings
$ make setup

# Start servers in Docker
$ make dev

# For those who want to start development on website without Docker
#
# You can start depending services in docker
$ make -f Makefile.nodocker.mk docker-start-db
# And then run the dotnet process in local for admin portal
$ NO_DOCKER=1 MODULE=Web make dev
#
# For public-web
$ NO_DOCKER=1 PORT=3002 MODULE=public-web make dev
# For core API server
$ NO_DOCKER=1 MODULE=core make dev

After running above commands,

• visit http://localhost:3000 on browser and you should be able to see the admin portal website;
• visit http://localhost:3002 on browser and you should be able to see the public website.

Setup (Using Visual Studio, Windows only)

TODO: Provide Powershell setup script

1. Copy Web/appsettings.Development.json.template to Web/appsettings.Development.json
2. Start db container specified in docker-compose.dev.yml by docker-compose command

Diagrams

• ER diagram