Uploaded image for project: 'Spark'
  1. Spark
  2. SPARK-21773

Should Install mkdocs if missing in the path in SQL documentation build

    XMLWordPrintableJSON

Details

    • Improvement
    • Status: Resolved
    • Minor
    • Resolution: Fixed
    • 2.3.0
    • 2.3.0
    • Build, Documentation
    • None

    Description

      Currently, SQL documentation build with Jekins looks being failed due to missing mkdocs.

      For example, see https://amplab.cs.berkeley.edu/jenkins/job/spark-master-docs/3580/console

      ...
      Moving back into docs dir.
      Moving to SQL directory and building docs.
      Missing mkdocs in your path, skipping SQL documentation generation.
      Moving back into docs dir.
      Making directory api/sql
      cp -r ../sql/site/. api/sql
      jekyll 2.5.3 | Error:  unknown file type: ../sql/site/.
      Deleting credential directory /home/jenkins/workspace/spark-master-docs/spark-utils/new-release-scripts/jenkins/jenkins-credentials-scUXuITy
      Build step 'Execute shell' marked build as failure
      [WS-CLEANUP] Deleting project workspace...[WS-CLEANUP] done
      Finished: FAILURE
      

      It looks we better install it if missing rather than fail it.

      Attachments

        Activity

          People

            gurwls223 Hyukjin Kwon
            gurwls223 Hyukjin Kwon
            Votes:
            0 Vote for this issue
            Watchers:
            1 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved: