This repository is the public facing front end for the BC Parks Day Use Pass reservation system. Everything you see when you enter https://reserve.bcparks.ca/dayuse/ is what this repository works on.
Associated repos:
- https://github.com/bcgov/parks-reso-public
- https://github.com/bcgov/parks-reso-admin
- https://github.com/bcgov/parks-reso-api
Follow the steps to collaborate on our code: https://bcgov.github.io/bcparks/collaborate
yarn install
yarn start
Navigate to http://localhost:4200/. The application will automatically reload if you change any of the source files.
Along with
yarn test-ci -- to run all tests.
yarn test-ci -- --include src/app/shared/components/metrics to run on a specific file
On push to the Main branch, three actions run:
- Lint
- Unit Tests
- Deploy to dev
The deploy to dev orchestrates deployment to AWS dev.
There are three places where secrets and variables are stored.
The secrets stored in Github are required for the AWS configuration in Github actions. The variables are as follows:
- AWS_REGION
These secrets are permanent and will not have to be changed in the future.
These environment variables need to be set for each dev/test/prod environment:
- ACCOUNT_ID
- AWS_ROLE_ARN_TO_USE
There are a few secrets and variables that must be stored in Terraform Cloud. This is because they are required for provider initilization. This initialization happens before we are able to get variables from Github so they cannot be passed from AWS Parameter store. The variables are as follows:
- target_env
- aws_region
- target_aws_account_id
These variables and secrets are permanent and will not have to be changed in the future.
These variables are required by Github Actions as well as Terraform. The variables themselves are stored in AWS Parameter Store. These parameters are organized into four categories:
- parks-reso-api/
- parks-reso-admin/
- parks-reso-public/
- parks-reso-shared/
These variables are passed to Terraform Cloud in the following steps:
AWS Parameter Store -> Github -> Terragrunt -> *.auto.tfvars -> Terraform Cloud
If a variable must be updated, you must update it from AWS Parameter store.
We run this step to generate env.js which a variable configEndpoint to true. This sets the application to get configurations from the AWS API Gateway instead of assuming localhost:3000.
S3 requires the static files generated from Angular. To get these files we yarn install and yarn build. By doing this, a directory named dist which holds the static version of the site. This dist folder is uploaded to S3.
This creates several things in AWS:
- DynamoDB
- Cloudfront Distribution
- Connections among S3, Cloudfront, DynamoDB and API Gateway.
Test pipeline is triggered by publishing a release that is marked as a pre-release.
Prod pipeline is triggered by removing the pre-release tag from a release.
Config service is used to alter frontend via DynamoDB. In Dynamo, an item with the PK and SK of config must exist. Within the attributes, you are able to set certain configurations such as KEYCLOAK_ENABLED, API_LOCATION, and debugMode.
This item is request by the front ends upon client connection.
CloudFront is set to deny all requests. Change the API key in the env.js file to what is required for your local configuration.