On Fri, Apr 9, 2021 at 1:36 AM Anil Belur <[email protected]> wrote:
> Hello Thanh, :-) Thanks for the suggestion. > > I have already activated 'stable/silicon' branch for ODL. > To be clear this has to be activated for every project, not just the top level OpenDaylight docs project. Every project that has "WARNING: unknown document:" in the verify job is due to them missing their silicon branches activated in RTD. > However, for controller (SM project), I'm unable to find the v3.0.6 branch > in the filters. > Is this because the branch has not been cut yet? > The branch is cut and you can confirm in Git / GitHub by checking what branches or tags are available. RTD doesn't update it's list until a job has run to query the repo. The list may be out of date if the project hasn't had any recently run RTD builds. You can force a build of the project by logging into RTD and clicking build for any of the available branches. Then the v3.0.6 should appear shortly after the build starts. Regards, Thanh Cheers, > Anil > > On Fri, Apr 9, 2021 at 12:55 PM Thanh Ha <[email protected]> wrote: > >> When branching a new release someone has to login to ReadTheDocs and >> activate the new version or branch of the docs for every single project in >> that list. ReadTheDocs does not automatically generate docs for branches >> until they are "Activated" in the RTD WebUI. >> >> So for MRI projects like controller the 3.0.6 version must be activated. >> For autorelease projects like BGPCEP the stable-silicon branch has to be >> activated. Only then will RTD generate docs pages for those versions. >> >> I believe only the LF has an account with access to every project in ODL >> via the odl-rtd account so the fastest way to get this done is for LF >> releng to handle it. >> >> Regards, >> Thanh >> >> On Thu, Apr 8, 2021 at 9:31 PM Anil Belur <[email protected]> >> wrote: >> >>> For CR: https://git.opendaylight.org/gerrit/c/docs/+/95685 >>> >>> RTD verify fails because of the following errors: Likely because an >>> object has moved or no longer exists. >>> >>> *11:15:31* failed to reach any of the inventories with the following >>> issues:*11:15:31* intersphinx inventory >>> 'https://docs.opendaylight.org/projects/controller/en/v3.0.6/objects.inv' >>> not fetchable due to <class 'requests.exceptions.HTTPError'>: 404 Client >>> Error: Not Found for url: >>> https://docs.opendaylight.org/projects/controller/en/v3.0.6/objects.inv >>> >>> *11:15:32* ERROR: InvocationError for command >>> /w/workspace/docs-rtd-verify-silicon/.tox/docs/bin/sphinx-build -j auto -W >>> -b html -n -d /w/workspace/docs-rtd-verify-silicon/.tox/docs/tmp/doctrees >>> ./docs/ /w/workspace/docs-rtd-verify-silicon/docs/_build/html (exited with >>> code 2) >>> >>> Has anything changed with controller $project docs since this error >>> looks valid? >>> >>> As for the docs-verify job goes, its failing because of the following >>> errors: >>> >>> *11:23:28* >>> /w/workspace/docs-tox-verify-silicon/docs/developer-guides/index.rst:34: >>> WARNING: unknown document: infrautils:index*11:23:28* >>> /w/workspace/docs-tox-verify-silicon/docs/developer-guides/index.rst:35: >>> WARNING: unknown document: jsonrpc:index*11:23:28* >>> /w/workspace/docs-tox-verify-silicon/docs/developer-guides/index.rst:36: >>> WARNING: unknown document: netvirt:index*11:23:28* >>> /w/workspace/docs-tox-verify-silicon/docs/developer-guides/index.rst:37: >>> WARNING: unknown document: ovsdb:index*11:23:28* >>> /w/workspace/docs-tox-verify-silicon/docs/developer-guides/index.rst:38: >>> WARNING: unknown document: transportpce:index*11:23:28* >>> /w/workspace/docs-tox-verify-silicon/docs/index.rst:30: WARNING: unknown >>> document: integration-distribution:index*11:23:28* >>> /w/workspace/docs-tox-verify-silicon/docs/index.rst:43: WARNING: unknown >>> document: bgpcep:index*11:23:28* >>> /w/workspace/docs-tox-verify-silicon/docs/index.rst:44: WARNING: unknown >>> document: controller:index*11:23:28* >>> /w/workspace/docs-tox-verify-silicon/docs/index.rst:45: WARNING: unknown >>> document: daexim:index*11:23:28* >>> /w/workspace/docs-tox-verify-silicon/docs/index.rst:46: WARNING: unknown >>> document: infrautils:index*11:23:28* >>> /w/workspace/docs-tox-verify-silicon/docs/index.rst:47: WARNING: unknown >>> document: jsonrpc:index*11:23:28* >>> /w/workspace/docs-tox-verify-silicon/docs/index.rst:48: WARNING: unknown >>> document: lispflowmapping:index*11:23:28* >>> /w/workspace/docs-tox-verify-silicon/docs/index.rst:51: WARNING: unknown >>> document: openflowplugin:index*11:23:28* >>> /w/workspace/docs-tox-verify-silicon/docs/index.rst:52: WARNING: unknown >>> document: ovsdb:index*11:23:28* >>> /w/workspace/docs-tox-verify-silicon/docs/index.rst:60: WARNING: unknown >>> document: genius:index*11:23:28* >>> /w/workspace/docs-tox-verify-silicon/docs/index.rst:61: WARNING: unknown >>> document: netvirt:index*11:23:28* >>> /w/workspace/docs-tox-verify-silicon/docs/index.rst:62: WARNING: unknown >>> document: transportpce:index*11:23:28* >>> /w/workspace/docs-tox-verify-silicon/docs/release-process/managed-release.rst:594: >>> WARNING: undefined label: add-proj-dist (if the link has no caption the >>> label must precede a section header)*11:23:28* >>> /w/workspace/docs-tox-verify-silicon/docs/user-guide/index.rst:20: WARNING: >>> unknown document: jsonrpc:index*11:23:28* >>> /w/workspace/docs-tox-verify-silicon/docs/user-guide/index.rst:21: WARNING: >>> unknown document: netvirt:index*11:23:28* >>> /w/workspace/docs-tox-verify-silicon/docs/user-guide/index.rst:22: WARNING: >>> unknown document: ovsdb:index*11:23:28* build finished with problems, 33 >>> warnings. >>> >>> >>> >>> On Fri, Apr 9, 2021 at 11:06 AM Anil Belur <[email protected]> >>> wrote: >>> >>>> Noticed intermittent DNS issues on the RTD, which are resolved on a >>>> recheck on master (phosphorous). CR #95686 is ready for review. >>>> >>>> https://git.opendaylight.org/gerrit/c/docs/+/95686 >>>> >>>> On Fri, Apr 9, 2021 at 10:16 AM Anil Belur via lists.opendaylight.org >>>> <[email protected]> wrote: >>>> >>>>> Luis: I've created new stable/silicon branches on RTD and now ran >>>>> a "recheck" the CR's. The branching issue is resolved now, while the >>>>> verify >>>>> job are still failing on linkcheck failures: >>>>> >>>>> *09:59:13* (line 7) broken https://www.sphinx-doc.org/en/master/ - >>>>> HTTPSConnectionPool(host='www.sphinx-doc.org', port=443): Max retries >>>>> exceeded with url: /en/master/ (Caused by >>>>> NewConnectionError('<urllib3.connection.HTTPSConnection object at >>>>> 0x7f7387762978>: Failed to establish a new connection: [Errno -2] Name or >>>>> service not known',))*09:59:13* (line 123) broken >>>>> https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html - >>>>> HTTPSConnectionPool(host='www.sphinx-doc.org', port=443): Max retries >>>>> exceeded with url: /en/master/usage/restructuredtext/basics.html (Caused >>>>> by NewConnectionError('<urllib3.connection.HTTPSConnection object at >>>>> 0x7f73879ada20>: Failed to establish a new connection: [Errno -2] Name or >>>>> service not known',))*09:59:13* (line 355) broken >>>>> https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html - >>>>> HTTPSConnectionPool(host='www.sphinx-doc.org', port=443): Max retries >>>>> exceeded with url: /en/master/usage/restructuredtext/basics.html (Caused >>>>> by NewConnectionError('<urllib3.connection.HTTPSConnection object at >>>>> 0x7f73879ada20>: Failed to establish a new connection: [Errno -2] Name or >>>>> service not known',))*09:59:13* (line 7) broken >>>>> https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html - >>>>> HTTPSConnectionPool(host='www.sphinx-doc.org', port=443): Max retries >>>>> exceeded with url: /en/master/usage/restructuredtext/basics.html (Caused >>>>> by NewConnectionError('<urllib3.connection.HTTPSConnection object at >>>>> 0x7f7387762128>: Failed to establish a new connection: [Errno -2] Name or >>>>> service not known',))*09:59:13* (line 304) broken >>>>> https://www.sphinx-doc.org/en/master/usage/restructuredtext/roles.html - >>>>> HTTPSConnectionPool(host='www.sphinx-doc.org', port=443): Max retries >>>>> exceeded with url: /en/master/usage/restructuredtext/roles.html (Caused >>>>> by NewConnectionError('<urllib3.connection.HTTPSConnection object at >>>>> 0x7f7387762780>: Failed to establish a new connection: [Errno -2] Name or >>>>> service not known',))*09:59:13* (line 416) broken >>>>> https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html - >>>>> HTTPSConnectionPool(host='www.sphinx-doc.org', port=443): Max retries >>>>> exceeded with url: /en/master/usage/restructuredtext/basics.html (Caused >>>>> by NewConnectionError('<urllib3.connection.HTTPSConnection object at >>>>> 0x7f7387762128>: Failed to establish a new connection: [Errno -2] Name or >>>>> service not known',))*09:59:13* (line 416) broken >>>>> https://www.sphinx-doc.org/en/master/ - >>>>> HTTPSConnectionPool(host='www.sphinx-doc.org', port=443): Max retries >>>>> exceeded with url: /en/master/ (Caused by >>>>> NewConnectionError('<urllib3.connection.HTTPSConnection object at >>>>> 0x7f7387762978>: Failed to establish a new connection: [Errno -2] Name or >>>>> service not known',)) >>>>> >>>>> >>>>> I'll continue to look into this an update here. >>>>> >>>>> On Thu, Apr 8, 2021 at 10:34 AM Luis Gomez <[email protected]> wrote: >>>>> >>>>>> I followed this: >>>>>> https://git.opendaylight.org/gerrit/gitweb?p=docs.git;a=blob;f=branch-cutting-checklist.txt;h=a1bb775d0b90c9c95a472715b01c6f49d7030eb6;hb=refs/heads/master >>>>>> >>>>>> I also looked at the RTD script and it seems like some projects are >>>>>> missing there including the docs project itself, so better do the change >>>>>> in >>>>>> RTD directly. >>>>>> >>>>>> BR/Luis >>>>>> >>>>>> >>>>>> On Apr 7, 2021, at 3:40 PM, Anil Belur <[email protected]> >>>>>> wrote: >>>>>> >>>>>> Luis, I'll look into this and get back to you. Did we follow any docs >>>>>> for branching/tagging the docs project? >>>>>> >>>>>> On Wed, Apr 7, 2021 at 1:23 PM Luis Gomez <[email protected]> wrote: >>>>>> >>>>>>> FYI, docs project has branched for silicon release however the >>>>>>> "after branching" patches fail: >>>>>>> >>>>>>> https://git.opendaylight.org/gerrit/c/docs/+/95685 >>>>>>> https://git.opendaylight.org/gerrit/c/docs/+/95686 >>>>>>> >>>>>>> The reason is we have to activate the new branch (stable-silicon) in >>>>>>> RTD but I do not have permission for doing that. Can anyone in LF take >>>>>>> care >>>>>>> of this? should I open an IT ticket? >>>>>>> >>>>>>> BR/Luis >>>>>>> >>>>>>> >>>>>>> >>>>>>> >>>>>> >>>>> >>>>> >>>>> >>> >>> >>>
-=-=-=-=-=-=-=-=-=-=-=- Links: You receive all messages sent to this group. View/Reply Online (#1211): https://lists.opendaylight.org/g/infrastructure/message/1211 Mute This Topic: https://lists.opendaylight.org/mt/81961710/21656 Group Owner: [email protected] Unsubscribe: https://lists.opendaylight.org/g/infrastructure/unsub [[email protected]] -=-=-=-=-=-=-=-=-=-=-=-
