Uploaded image for project: 'Data Management'
  1. Data Management
  2. DM-13584

evaluate PoC for stack pipelines.lsst.io build

    Details

      Attachments

        Issue Links

          Activity

          Hide
          jhoblitt Joshua Hoblitt added a comment -

          TL;DR - I was able to produce and publish sphinx based documentation from the work in DM-11216 after some leg work.

          Details - After banging my head on file encoding errors from sphinx that didn't identify the source file, I kludged astropy_helpers to force the encoding on all opened files to utf-8, which resolved the encoding error messages. I was gong to PR this upstream but discovered that an identify change had already been made and was including in recent 2.x and the 3.0 release as of about a week ago. Updating the version of astropy_helpers used by documenteer was [is hopefully] the permanent fix.

          A PoC jenkins job named sqre/infrastructure/documenteer, that builds the sphinx docs from a published stack release docker image and publishes them via ltd-mason, has been tested and deployed to production. Along with sqre/infrastructure/build-ltd-mason, which produces the image used to run ltd-mason.

          The weekly/nightly release pipelines have been updated to trigger s/i/documenteer. However, this is as-of-yet untested, so this ticket is being placed into self-review in order to follow up on the results of the nightly build tomorrow.

          Show
          jhoblitt Joshua Hoblitt added a comment - TL;DR - I was able to produce and publish sphinx based documentation from the work in DM-11216 after some leg work. Details - After banging my head on file encoding errors from sphinx that didn't identify the source file, I kludged astropy_helpers to force the encoding on all opened files to utf-8 , which resolved the encoding error messages. I was gong to PR this upstream but discovered that an identify change had already been made and was including in recent 2.x and the 3.0 release as of about a week ago. Updating the version of astropy_helpers used by documenteer was [is hopefully] the permanent fix. A PoC jenkins job named sqre/infrastructure/documenteer , that builds the sphinx docs from a published stack release docker image and publishes them via ltd-mason , has been tested and deployed to production. Along with sqre/infrastructure/build-ltd-mason , which produces the image used to run ltd-mason . The weekly/nightly release pipelines have been updated to trigger s/i/documenteer . However, this is as-of-yet untested, so this ticket is being placed into self-review in order to follow up on the results of the nightly build tomorrow.
          Hide
          jhoblitt Joshua Hoblitt added a comment -

          The prototype doc bulid has been working as part of the nightly/weekly release process without apparent issue.

          Show
          jhoblitt Joshua Hoblitt added a comment - The prototype doc bulid has been working as part of the nightly/weekly release process without apparent issue.

            People

            • Assignee:
              jhoblitt Joshua Hoblitt
              Reporter:
              jhoblitt Joshua Hoblitt
              Reviewers:
              Joshua Hoblitt
              Watchers:
              Jonathan Sick, Joshua Hoblitt
            • Votes:
              0 Vote for this issue
              Watchers:
              2 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: