[perl PATCH v4 2/3] gitlab: add a simple job that publishes the API docs as HTML

[Daniel P. Berrangé]

The Perl modules have inline POD docs. This can be converted to HTML and
published as a GitLab artifact. The rendered HTML is kind of ugly but
improving this is left as an exercise for the future.

Signed-off-by: Daniel P. Berrangé <berrange at redhat.com>
---
 .gitlab-ci.yml | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml
index 586434e..1099e2b 100644
--- a/.gitlab-ci.yml
+++ b/.gitlab-ci.yml
@@ -3,6 +3,7 @@ stages:
   - prebuild
   - containers
   - builds
+  - docs
 
 .container_job_template: &container_job_definition
   image: docker:stable
@@ -169,3 +170,17 @@ ubuntu-2004-git-build:
   <<: *git_build_job_definition
   variables:
     NAME: ubuntu-2004
+
+apiref:
+  stage: docs
+  image: perl
+  script:
+    - mkdir apiref
+    - perl -MPod::Simple::HTMLBatch -e Pod::Simple::HTMLBatch::go  lib apiref
+  artifacts:
+    expose_as: 'API Reference'
+    name: 'apiref'
+    when: on_success
+    expire_in: 30 days
+    paths:
+      - apiref
-- 
2.26.2