Gotenberg api de conversion htlm to pdf : Installation et utilisation pour convertir du HTML en PDF : Un guide pratique pour généer des pdf.

Introduction

Gotenberg est une solution open source permettant de convertir des documents (HTML, URL, etc.) en PDF via une API REST. Github repo est ici.

• Il s'agit d'une image docker qui intègre toutes les dépendances nécessaires, éliminant ainsi le besoin d'installations d'environnement individuelles.
• Il s'adapte et fonctionne de manière transparente dans un cadre distribué.
• Il comprend des  endpoints multipart/form-data pour convertir de nombreux formats de documents en fichiers PDF.
• Il prend en charge HTTP/2 (classique ou H2C).
• Il expose plusiers endpoints pour les differentes donctionnalités

D'un point de vue technique, Gotenberg repose sur une structure modulaire qui permet de proposer diverses fonctionnalités. Par exemple, le module Chromium est spécialement conçu pour convertir des documents HTML en fichiers PDF.

 

---

⚠️ Attention : Ne pas exposer votre instance Gotenberg à Internet. Considérez-la comme une base de données en termes de sécurité.

---

 

Déploiement avec docker

• Démarrage rapide avec Docker :

docker run --rm -p 3000:3000 gotenberg/gotenberg:8

 

API disponible sur : http://localhost:3000

• Exemple de conversion pour  tester

curl --request POST http://localhost:3000/forms/chromium/convert/url \
--form url=https://sparksuite.github.io/simple-html-invoice-template/ \
-o my.pdf

 

Déploiement avec docker compose

• Ajoutez ce service à votre fichier docker-compose.yml :

services:
  gotenberg:
    image: gotenberg/gotenberg:8
    ports:
      - "8080:3000"

 

docker compose up -d

 

API accessible localement sur http://localhost:8080.

 

Déploiement avec kubernetes

Le helm chart pour le déplpoiement sur kubernetes

 

• Ajouter le repo helm

helm repo add maikumori https://maikumori.github.io/helm-charts
helm repo update

 

• Personalisation des values helm

securityContext:
  readOnlyRootFilesystem: false
  allowPrivilegeEscalation: false
  privileged: false
  runAsUser: 1001

 

• Installation du chart

helm install my-gotenberg maikumori/gotenberg --version 1.9.1

 

Quelques commandes d'utilisation

Documentation sur les routes et commandes