Awesome
Docker-Image based on Ubuntu-Linux for creating LaTeX documents e.g. within a CI/CD pipeline
In General
LaTeX is a language to typeset documents. One of its main features is that the original document is just a plain text file which can be edited with any text editor. This enables us to have these text files under a version control system like Git. You can easily go back to a previous version with the help of the version control system. Additionally, build pipelines came up. There are some services available on the Internet which even give you free build minutes in their pipeline implementation. So, this LaTeX-Docker-images uses these pipelines to enable an auto-generation of the outcoming PDF file with every check-in to the repository.
This docker image enables you to use the CI-pipeline provided by GitLab or BitBucket to automatically create a PDF document out of your LaTeX files every time you push them to your Git-repository.
But you can also use this Docker-Image locally to process LaTeX-files on your local machine.
Additionally there is a German article about using this Docker image at http://www.tornau.name/2019/08/continuous-delivery-pipelines-fuer-latex-dokumente/
Image is available at Docker Hub
The Docker image is available at Docker Hub at https://hub.docker.com/r/ctornau/latex . Feel free to use it within your projects.
Build LaTeX-PDF with CI/CD-pipeline on Gitlab
You can use the image the following way on GitLab by using the file .gitlab-ci.yml:
image: ctornau/latex
build:
stage: build
artifacts:
paths:
- main.pdf
script:
- latexmk -pdf main.tex
Please follow the link https://gitlab.com/tornau/latex to a sample GitLab project.
Build LaTeX-PDF with CI/CD-pipeline on BitBucket
If you prefer BitBucket place the following in the file named bitbucket-pipelines.yml within your repository:
image: ctornau/latex
pipelines:
default:
- step:
name: Build and Upload PDF
script:
- latexmk -pdf main.tex
- curl -X POST "https://${BB_AUTH_STRING}@api.bitbucket.org/2.0/repositories/${BITBUCKET_REPO_OWNER}/${BITBUCKET_REPO_SLUG}/downloads" --form files=@"main.pdf"
artifacts:
- main.pdf
To have a working BitBucket-pipeline please make sure that the secret variable BB_AUTH_STRING contains the secret to access the download area of BitBucket. Instructions to do this are placed at https://confluence.atlassian.com/bitbucket/deploy-build-artifacts-to-bitbucket-downloads-872124574.html .
Please follow the link https://bitbucket.org/tornau/latex to an example BitBucket repository.
Build LaTeX-PDF with Azure DevOps
The build can also be run on Azure DevOps. Azure DevOps is available at https://dev.azure.com/ . Enjoy.
Run it locally
Have your LaTeX-files to compile in the following directory c:\your\location and run the following Docker-command
docker run -v c:\your\location\:/latex ctornau/latex /bin/sh -c "cd latex && latexmk -pdf main.tex"