The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.
 / 
continuous-delivery-template-0.02
River stage zero No dependents
/ continuous::delivery::template

NAME

continuous-delivery-template - continuous delivery workflow dockerhub, gitlab, and cpan

DESCRIPTION

Perl template application configured to use Gitlab CI/CD service as continuous delivery workflow.

On the Perl side, this application template uses Dist::Zilla as building, testing and releasing framework.

   hack on application code
   git commit ...
   git push

This will trigger building, testing and publishing the docker image with :ci tag to dockerhub.

If all tests pass and you are going to release a new version should use Dist::Zila as follows:

   dzil release

Dist::Zilla will create a new git tag based on version number on lib/continuous/delivery/template.pm file and push the tag to github.

Dist::Zilla will publish the release on CPAN, the CPAN will run tests under a variety of platforns and environments throught CPANTESTERS.

When a new git tag is created on gitlab repository, the pipeline will build the stages: build -> test -> deploy. The deploy stage is executed only when a new tag is pushed to repository.

The deploy job will upload a stable image to dockerhub Container Registry.

Before you can upload Perl modules to CPAN you need to create an account on The [Perl programming] Authors Upload Server:

You need create an account on Docker Hub Container Regitry and configure the following secret variables on Gitlab CI / CD settings:

$DOCKER_USER

Your username on hub.docker.com.

$DOCKER_PASSWORD

Your password on hub.docker.com.

Gitlab Repository:

https://gitlab.com/joenio/continuous-delivery-template

Docker Hub Container Registry:

https://hub.docker.com/r/joenio/continuous-delivery-template

CPAN:

https://metacpan.org/release/continuous::delivery::template

CPANTESTERS:

http://matrix.cpantesters.org/?dist=continuous-delivery-template

PROJECT LAYOUT

.gitlab-ci.yml

https://gitlab.com/joenio/continuous-delivery-template/blob/master/.gitlab-ci.yml.

This file configures Gitlab CI/CD pipeline for build, test and deploy.

Gitlab CI/CD stages: build -> test -> deploy

Dockerfile

https://gitlab.com/joenio/continuous-delivery-template/blob/master/Dockerfile.

Docker container file, use debian:stretch as base image.

dist.ini

https://gitlab.com/joenio/continuous-delivery-template/blob/master/dist.ini.

Dist::Zilla settings for build, test and release this project.

USEFULL DOCUMENTS