/gotenberg-plus

gotenberg with extras

Primary LanguageGoMIT LicenseMIT

Use this GitHub template repository for your custom modules and Gotenberg's Docker image variants.

Want to share your work? Open a PR to the awesome list! 🚀

Quick Start

Update the following variables in the Makefile:

  • APP_NAME - the name of your Gotenberg's Docker image variant.
  • APP_VERSION
  • APP_AUTHOR
  • APP_REPOSITORY
  • DOCKER_REPOSITORY

Good 🤓? Now run:

make it

This command builds both your Gotenberg's Docker image variant ($(DOCKER_REPOSITORY)/gotenberg:7-$(APP_NAME)-$(APP_VERSION)) and a tests' Docker image.

Next steps

  1. Update the go.mod file with your Go module's name.
  2. Update the build/Dockerfile with your instructions.
  3. Create your module(s) in pkg/modules.
  4. Import your module(s) in cmd/app/main.go.

FAQ

How can I run my tests?

make tests

Once the testing container is ready, you have access to the following commands:

golint   Run the linter
gotest   Run the tests
gotodos  Display TODOs in your Go source

How can I check the underlying Gotenberg's version?

The Gotenberg's image has a version label which contains the underlying Gotenberg's version:

docker inspect $(DOCKER_REPOSITORY)/gotenberg:7-$(APP_NAME)-$(APP_VERSION)

Where can I see the list of Makefile commands?

Run make help to display the available commands 💡