web-ci/README.md

# Hugo Extended CI Container

Based on alpine:3.20

Contains nodejs, hugo, npm, rsync

## To use

Run the following in your hugo directory: 
```
docker run -v .:/home/app -ti --network=host git.myco.systems/mycosystems/hugo-ci:latest
```
To also host locally: 
```
docker run -p 1313:1313 -v .:/home/app -ti --network=host git.myco.systems/mycosystems/hugo-ci:latest
```

## Building

Building requires docker, buildx. Nodejs is included in the ci workflow becuase of it's use in many actions scripts.

I recommend changing the option `JOBS` in the Dockerfile as the current number is optimized for a custom KVM machine that's being used as our runner. Though even at 32 the specs are under-utalized
Our runner is given these resources:
- 64 GB DDR4
- 128 vcores passed as EPYC 7763 (host) using NUMA
- 64 GB emulated SSD




## Links  

- ~~[BetterWeb Docker](https://hub.docker.com/r/betterweb/hugo)~~

- ~~[BeterCorp Github](https://github.com/BetterCorp/hugo)~~

- [Codeberg Repo](https://codeberg.org/mycosys/hugo-ci)

- [Codeberg Packages](https://codeberg.org/mycosys/-/packages/container/hugo-ci/versions)