README
¶
Helldivers 2 Client
[!IMPORTANT]
Currently in very active development, please don't use unless you are ready for chaos!
Summary
Goal
Storing metrics as historic data for later processing (i.e. visualization)
Procedure
- Query the Helldivers 2 API at regular intervals
- Write the received data into snapshots, each associated with the current time
Setup
Use the following docker-compose.yaml to get started:
version: '3.8'
networks:
default:
driver: bridge
services:
app:
image: ghcr.io/stnokott/helldivers-client:latest
depends_on:
- api
- db
environment:
POSTGRES_URI: postgresql://root:REPLACEME@db:5432/helldivers # IMPORTANT: use same credentials as in the <db> container.
API_URL: http://api:8080
WORKER_CRON: "*/5 * * * *" # Cron expression defining how frequent the API is queried. Should be no less than API update interval below. (optional, default is every 5min)
HEALTHCHECKS_URL: https://hc-ping.com/aaaaaaaa-1111-bbbb-2222-dddddddddddd # healthchecks.io URL. (optional)
TZ: Europe/Berlin
networks:
- default
api:
build:
# Needs to be built from GitHub as there is currently no public Docker image available
context: https://github.com/helldivers-2/api.git#9c6869c0fa93d41f715fd55b8cce1f11ca257475 # pin version
dockerfile: ./src/Helldivers-2-API/Dockerfile
networks:
- default
environment:
Helldivers__API__Authentication__Enabled: false # Set to true if exposed
Helldivers__Synchronization__IntervalSeconds: 300 # How frequent the API data is updated.
Helldivers__Synchronization__DefaultLanguage: en-US # Language of strings such as Major Order text.
db:
image: postgres:16.2
environment:
POSTGRES_USER: root
POSTGRES_PASSWORD: REPLACEME
POSTGRES_DB: helldivers
volumes:
- /path/to/persistent/storage:/var/lib/postgresql/data # Persist your DB data
networks:
- default
Development
PGO
We use PGO for build optimization.
To collect a new CPU profile from a representative productive environment, do the following:
-
Run the "Release snapshot" action on your current working branch. This will build and publish a snapshot release of the code on your branch without PGO.
-
Pull the
ghcr.io/stnokott/helldivers-client:latest-snapshotDocker image -
Run this image in the same Docker stack as you would do with the regular image. Use the following parameters to control profiling behaviour:
--pprof-duration=30m-> How long the profiling should run for.--pprof-out=default.pprof-> Where to save the generated profile to. -
Once finished, commit the newly generated profile file as
build/default.pprofto your branch. It will be automatically picked up for the next release.
Documentation
¶
Overview ¶
Package main provides the very simplest main function
Package main provides the very simplest main function
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
internal
|
|
|
api
Package api provides primitives to interact with the openapi HTTP API.
|
Package api provides primitives to interact with the openapi HTTP API. |
|
client
Package client wraps the API specs into a client
|
Package client wraps the API specs into a client |
|
config
Package config handles configuration via environment variables
|
Package config handles configuration via environment variables |
|
copytest
Package copytest provides testing utilites relating to struct copying
|
Package copytest provides testing utilites relating to struct copying |
|
db
Package db handles interactions with the MongoDB instance and works as an abstraction layer
|
Package db handles interactions with the MongoDB instance and works as an abstraction layer |
|
db/gen
Code generated by sqlc-gen-enum.
|
Code generated by sqlc-gen-enum. |
|
db/sqlc-gen-enum
command
package main implements a custom `sqlc` generator.
|
package main implements a custom `sqlc` generator. |
|
db/stats
Package stats provides utilities for collecting and printing statistics
|
Package stats provides utilities for collecting and printing statistics |
|
transform
Package transform converts API structs to DB structs
|
Package transform converts API structs to DB structs |
|
worker
Package worker synchronizes data between API and DB.
|
Package worker synchronizes data between API and DB. |