Gateway2Gegevenslogger

Project for Frank applications deployed by JAR or Docker

• Skeleton Project for Frank applications deployed by JAR or Docker
  • Introduction
  • Included
  • Usage
    • Steps
    • Template variables

Introduction

This project serves as a starting point for new projects or as example for existing ones. This "empty" Frank! will have configuration files to build and deploy.

Included

• Dockerfile
• Docker compose
• Publicode (WIP)
• GitHub Actions
  • Continuous Integration workflow
  • Release workflow

Please check if you deem all these functionalities necessary, if not remove them.

Usage

Steps

1. Create a new repository and choose this as template repository
2. Clone the newly created project
3. Fill in the skeletonrc.json to replace the template strings
4. Run the skeleton.js script with node e.g. node ./skeleton.js
5. Add your own configuration files
6. Make sure that the GitHub action credentials are added
7. Commit & Profit!

Configure Docusaurus GitHub Pages deployment

1. Navigate to GitHub -> Repository -> Pages -> Build and deployment and select GitHub Actions from the source dropdown.
2. Navigate to GitHub -> Repository -> Environments and create a New Environment called github-pages if it does not exist yet.
3. Enable the "docusaurus-release" job in .github/workflows/release.yml by setting "if" to true.

Template variables

Template variable	Description	Example
Gateway2Gegevenslogger	The name of the Frank! to be deployed. It's best to keep this inline with the name of the repo	Frank2Skeleton
gateway2gegevenslogger	Lowercase version of the instance name.	frank2example
verwerkingenlogging-api-server	The name of the first configuration (others have to be added manually)	Sans