This software is licensed under GNU Affero General Public License.

Overview of current deployments

Deployment is done using GitHub actions in .github/workflows

Actions consist mostly of 3 jobs, test, build and deploy. Each job depends on previous job (needs keyword in action's YAML). When deploy job finishes, it also sends Slack notification to #devops chanel, and adds comment on PR (if PR build)

Production environment is deployed every time a new GitHub release is created.

Workflow .github/workflows/prod.yml is responsible for deployment.

Staging environment is deployed on every push to master (if tests pass and build is successful).

Workflow .github/workflows/stage.yml is responsible for deployment.

Use NOBUILD keyworkd in commit message to skip build (and deploy) for this commit (tests will still be ran). Use NODEPLOY keyworkd in commit message to skip deploy for this commit (image will still be build and pushed).

Create PR from a branch (in this repo, not fork) to master. Label PR with label deploy-preview and wait few minutes. Deployment should be available at https://pr-NUM.preview.sledilnik.org where NUM is number of your PR.

Only open PR with label deploy-preview are deployed. When PR is closed or label removed, deployment is stopped.

• yarn
• node
• .net core https://dotnet.microsoft.com/download
• probably something I forgot

yarn install

yarn run serve

yarn run build

Not really that we have any tests

yarn run test

yarn run lint

FSharpLint is used to check the F# code. In order to use it, you need to run build.bat script, which will

1. install FSharpLint locally (if it was not already installed),
2. run it on the source code,
3. run F# unit tests.

The configuration is stored in the fsharplint-config.json file. You can find more information on how to configure or suppress various rules here.

If you use JetBrains Rider as your IDE, you can integrate FSharpLint into your workflow inside IDE by following these steps:

1. Make sure you have FSharpLint installed (see the above section).
2. Click File | Settings menu option.
3. In the Settings window, find Tools/External Tools tree item.
4. Press on the plus (+) button to add a new external tool.
5. In the Edit Tool window, enter the following values:
   • Name: FSharpLint
   • Program: dotnet
   • Arguments: fsharplint --format msbuild lint -l fsharplint-config.json SloCovid19Website.sln
   • Advanced Options: check all checkboxes
   • Output filters: $FILE_PATH$\($LINE$\,$COLUMN$\,.*
6. Press OK button to confirm.

Now you should have a new menu item under Tools | External Tools | FSharpLint.

1. Rebuild the solution.
2. Run Owid.Analyzer highest in the command line. It should write out the new countries lists for the four categories.

Open slo-covid-19\website\src\visualizations\CountriesChartViz\CountrySets.fs file in IDE.

4. Replace existing countries lists with the ones returned by the tool. Example, in the following line, replace the value of CountriesCodes array with the new values:

let setHighestNewCases = {
    Label = "groupHighestNewCases"
    CountriesCodes = [| "URY"; "BHR"; "ARG"; "COL"; "MNG"; "PRY"; "CHL"; "KWT"; "NAM"; "CRI" |]
}

5. Rebuild, test and commit.

• vue (framework) https://vuejs.org/v2/guide/
• vue-router (view routing) https://router.vuejs.org/
• vue-bootstrap (styled components) https://bootstrap-vue.js.org/
• webpack (bundler) https://webpack.js.org/concepts/