dlcs-protagonist-recalculators

This repository contains a set of lambda functions designed to help recalculate tables in the database that have gone out of sync. These are as follows:

Entity Counter Recalculator

This resets customer-images and space-images within the EntityCounter table to match details from the Images table. This is completed by performing an UPSERT on the database. It passes details from these changes into cloudwatch metrics for the following details:

• difference between EntityCounter and Images for customer images and space images
• deletions required to match the EntityCounter table to Images for customer images and space images

Local development

environment variables

There are several environment variables that need to be set. The list of these variables has an example file at the root of this project called .env-dist. You need to copy and set the variables in this file into a .env file. There is also a powershell script to pull these variables into the console called SetEnvFile.ps1. This is required To be set before the lambda functions can be run.

prerequisites

prerequisites for the project can be installed from pip using the following command:

pip install -r requirements.txt

updating requirements

In order to avoid encoding issues in requirements.txt when running a pip freeze in powershell requires that the file format be set to UTF-8. This can be done with the following command:

pip freeze -l | Out-File -Encoding UTF8 requirements.txt

running

The lambda functions can be run directly with python or via the built docker container

running directly

First, the environment variables need to be added to the terminal using the .\setEnvFile.ps1 file

You can run directly using the below commands

python <file location>

An example of this is below, if running from the root of this project:

python .\entity-counter-recalculator\main.py

running via docker

the docker container can be built with the following command:

 docker build . -t dlcs-entity-counter-recalculator:local

then run with this command:

docker run rm -it --env-file { env file location } -p 9000:8080 dlcs-entity-counter-recalculator:local

you can then call the function using curl (technically Invoke-WebRequest):

curl "http://localhost:9000/2015-03-31/functions/function/invocations" -body '{}' -Method POST