add pandoc version info (#8)

add pandoc version info

emit pandoc version
stick to particular pandoc version (through ensure-pandoc role)

Reviewed-by: OpenTelekomCloud Bot <None>

bindep.txt

@@ -1 +0,0 @@
-pandoc

playbooks/pre.yaml

@@ -2,7 +2,9 @@
 - hosts: all
   roles:
     - ensure-python
+    - ensure-pip
     - ensure-virtualenv
+    - ensure-pandoc
     - ensure-gh
   tasks:
     - name: Install convertor

playbooks/run.yaml

@@ -28,7 +28,7 @@
       loop_control:
         loop_var: "doc"
         label: "{{ doc.label }}"
-      when: "git_log.stdout is search(doc.html_location) or git_log.stdout is search('otc_doc_convertor')"
+      when: "git_log.stdout is search(doc.html_location) or git_log.stdout is search('otc_doc_convertor') or git_log.stdout is search('playbooks')"
 
     - name: Restore to the previous git state
       command: "git checkout HEAD^1"

roles/convert_doc/tasks/main.yaml

@@ -1,3 +1,6 @@
+- name: Emit pandoc version
+  command: "pandoc --version"
+
 - name: Convert {{ doc_label | default('') }} HTML to RST
   args:
     executable: "/bin/bash"

zuul.yaml

@@ -28,7 +28,7 @@
     name: otc-doc-exports-convert-base
     parent: unittests
     abstract: true
-    nodeset: ubuntu-jammy
+    nodeset: vm
     description: |
       Convert doc exports from html to rst and generate corresponding rst diff
       files.
@@ -45,6 +45,7 @@
     files:
       - otc_doc_convertor
       - docs/ecs
+      - roles
     vars:
       docs_update_data_file: "docs_compute.yaml"
 
@@ -57,6 +58,7 @@
     files:
       - otc_doc_convertor
       - docs/modelarts
+      - roles
     vars:
       docs_update_data_file: "docs_big-data.yaml"
 
@@ -97,6 +99,7 @@
       docs_rst_location: "docs"
       docs_base_location: "base"
       docs_new_location: "new"
+      ensure_pandoc_version: "2.18"
     check:
       jobs:
         - otc-tox-pep8: