Date   

Re: [documentation] [OpenDaylight TSC] Docs branching

Anil Belur
 

I can add the active ODL doc projects committers to RTD to manage the builds. 
Please create an account and share your ID directly to me on through a ticket.


On Fri, Apr 9, 2021 at 11:57 PM Anil Belur <abelur@...> wrote:
I've triggered the builds for all the projects in the console log and activated branch stable/silicon. However, for a genius and netvirt the issue persists.

13:46:05 /w/workspace/docs-tox-verify-silicon/docs/developer-guides/index.rst:36: WARNING: unknown document: netvirt:index
13:46:05 /w/workspace/docs-tox-verify-silicon/docs/index.rst:60: WARNING: unknown document: genius:index
13:46:05 /w/workspace/docs-tox-verify-silicon/docs/index.rst:61: WARNING: unknown document: netvirt:index
13:46:05 /w/workspace/docs-tox-verify-silicon/docs/user-guide/index.rst:21: WARNING: unknown document: netvirt:index
13:46:05 build succeeded, 6 warnings. 

Netvirt does not seem to have the branch for stable/silicon.


On Fri, Apr 9, 2021 at 9:36 PM Thanh Ha <zxiiro@...> wrote:


On Fri, Apr 9, 2021 at 1:36 AM Anil Belur <abelur@...> 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 <zxiiro@...> 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 <abelur@...> 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 <abelur@...> wrote:
Noticed intermittent DNS issues on the RTD, which are resolved on a recheck on master (phosphorous). CR #95686 is ready for review.


On Fri, Apr 9, 2021 at 10:16 AM Anil Belur via lists.opendaylight.org <abelur=linuxfoundation.org@...> 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 <ecelgp@...> 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 <abelur@...> 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 <ecelgp@...> 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











Re: [documentation] [OpenDaylight TSC] Docs branching

Anil Belur
 

I've triggered the builds for all the projects in the console log and activated branch stable/silicon. However, for a genius and netvirt the issue persists.

13:46:05 /w/workspace/docs-tox-verify-silicon/docs/developer-guides/index.rst:36: WARNING: unknown document: netvirt:index
13:46:05 /w/workspace/docs-tox-verify-silicon/docs/index.rst:60: WARNING: unknown document: genius:index
13:46:05 /w/workspace/docs-tox-verify-silicon/docs/index.rst:61: WARNING: unknown document: netvirt:index
13:46:05 /w/workspace/docs-tox-verify-silicon/docs/user-guide/index.rst:21: WARNING: unknown document: netvirt:index
13:46:05 build succeeded, 6 warnings. 

Netvirt does not seem to have the branch for stable/silicon.


On Fri, Apr 9, 2021 at 9:36 PM Thanh Ha <zxiiro@...> wrote:


On Fri, Apr 9, 2021 at 1:36 AM Anil Belur <abelur@...> 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 <zxiiro@...> 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 <abelur@...> 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 <abelur@...> wrote:
Noticed intermittent DNS issues on the RTD, which are resolved on a recheck on master (phosphorous). CR #95686 is ready for review.


On Fri, Apr 9, 2021 at 10:16 AM Anil Belur via lists.opendaylight.org <abelur=linuxfoundation.org@...> 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 <ecelgp@...> 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 <abelur@...> 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 <ecelgp@...> 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











Re: [documentation] [OpenDaylight TSC] Docs branching

Thanh ha <zxiiro@...>
 



On Fri, Apr 9, 2021 at 1:36 AM Anil Belur <abelur@...> 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 <zxiiro@...> 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 <abelur@...> 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 <abelur@...> wrote:
Noticed intermittent DNS issues on the RTD, which are resolved on a recheck on master (phosphorous). CR #95686 is ready for review.


On Fri, Apr 9, 2021 at 10:16 AM Anil Belur via lists.opendaylight.org <abelur=linuxfoundation.org@...> 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 <ecelgp@...> 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 <abelur@...> 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 <ecelgp@...> 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











Re: [documentation] [OpenDaylight TSC] Docs branching

Thanh ha <zxiiro@...>
 

If the project has not triggered a RTD build in a while then RTD won't have an updated list. You'll need to login to RTD and trigger it to build any branch and that will force the list to get updated.

Regards,
Thanh


On Fri, Apr 9, 2021 at 1:36 AM Anil Belur <abelur@...> wrote:
Hello Thanh, :-)  Thanks for the suggestion. 

I have already activated 'stable/silicon' branch for ODL. 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?

Cheers,
Anil

On Fri, Apr 9, 2021 at 12:55 PM Thanh Ha <zxiiro@...> 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 <abelur@...> 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 <abelur@...> wrote:
Noticed intermittent DNS issues on the RTD, which are resolved on a recheck on master (phosphorous). CR #95686 is ready for review.


On Fri, Apr 9, 2021 at 10:16 AM Anil Belur via lists.opendaylight.org <abelur=linuxfoundation.org@...> 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 <ecelgp@...> 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 <abelur@...> 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 <ecelgp@...> 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











Re: [documentation] [OpenDaylight TSC] Docs branching

Anil Belur
 

Hello Thanh, :-)  Thanks for the suggestion. 

I have already activated 'stable/silicon' branch for ODL. 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?

Cheers,
Anil

On Fri, Apr 9, 2021 at 12:55 PM Thanh Ha <zxiiro@...> 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 <abelur@...> 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 <abelur@...> wrote:
Noticed intermittent DNS issues on the RTD, which are resolved on a recheck on master (phosphorous). CR #95686 is ready for review.


On Fri, Apr 9, 2021 at 10:16 AM Anil Belur via lists.opendaylight.org <abelur=linuxfoundation.org@...> 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 <ecelgp@...> 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 <abelur@...> 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 <ecelgp@...> 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











Re: [documentation] [OpenDaylight TSC] Docs branching

Thanh ha <zxiiro@...>
 

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 <abelur@...> 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 <abelur@...> wrote:
Noticed intermittent DNS issues on the RTD, which are resolved on a recheck on master (phosphorous). CR #95686 is ready for review.


On Fri, Apr 9, 2021 at 10:16 AM Anil Belur via lists.opendaylight.org <abelur=linuxfoundation.org@...> 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 <ecelgp@...> 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 <abelur@...> 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 <ecelgp@...> 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











Re: Docs branching

Anil Belur
 

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 <abelur@...> wrote:
Noticed intermittent DNS issues on the RTD, which are resolved on a recheck on master (phosphorous). CR #95686 is ready for review.


On Fri, Apr 9, 2021 at 10:16 AM Anil Belur via lists.opendaylight.org <abelur=linuxfoundation.org@...> 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 <ecelgp@...> 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 <abelur@...> 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 <ecelgp@...> 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








Re: Docs branching

Anil Belur
 

Noticed intermittent DNS issues on the RTD, which are resolved on a recheck on master (phosphorous). CR #95686 is ready for review.


On Fri, Apr 9, 2021 at 10:16 AM Anil Belur via lists.opendaylight.org <abelur=linuxfoundation.org@...> 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 <ecelgp@...> 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 <abelur@...> 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 <ecelgp@...> 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








Re: Docs branching

Anil Belur
 

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 <ecelgp@...> 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 <abelur@...> 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 <ecelgp@...> 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





Re: Phosphorus release schedule update

Anil Belur
 

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 Fri, Apr 9, 2021 at 5:23 AM Luis Gomez <ecelgp@...> wrote:
Anything we want to show for Silicon could be added to the docs stable/silicon branch, however nothing will show in the portal until Anil or LF IT adds the new branch in RTD.

BR/Luis 

On Apr 8, 2021, at 10:58 AM, Daniel de la Rosa <ddelarosa0707@...> wrote:

Thanks Guillaume, Could you or the documentation team also update the downloads page for Silicon?


also update the documentation page to include stable/silicon on the side menu and here


Thanh used to do this so not sure who can take over that now

thanks


On Wed, Mar 31, 2021 at 2:52 AM <guillaume.lambert@...> wrote:

Hi Daniel

 

Sure, I will prepare a change for that.

Note that the docs master branch still points to Silicon for the moment.

We have to wait for the stable/silicon branch creation to make the master branch point to phosphorus and merge this change.

 

Best Regards

Guillaume

 

De : Daniel de la Rosa [mailto:ddelarosa0707@...]
Envoyé : mercredi 31 mars 2021 06:44
À : ODL Docs
Cc : LAMBERT Guillaume TGI/OLN; TSC
Objet : Phosphorus release schedule update

 

Hello Documentation team

 

Could you please help me update ODL Phosphorus release schedule. Basically replace Aluminium with Phosphorus 

 

_________________________________________________________________________________________________________________________

Ce message et ses pieces jointes peuvent contenir des informations confidentielles ou privilegiees et ne doivent donc
pas etre diffuses, exploites ou copies sans autorisation. Si vous avez recu ce message par erreur, veuillez le signaler
a l'expediteur et le detruire ainsi que les pieces jointes. Les messages electroniques etant susceptibles d'alteration,
Orange decline toute responsabilite si ce message a ete altere, deforme ou falsifie. Merci.

This message and its attachments may contain confidential or privileged information that may be protected by law;
they should not be distributed, used or copied without authorisation.
If you have received this email in error, please notify the sender and delete this message and its attachments.
As emails may be altered, Orange is not liable for messages that have been modified, changed or falsified.
Thank you.








Re: ODL Helm chart group

Anil Belur
 

Luis, I would be happy to help. Let me check on what is required for setting up the Docker/heml repos on Nexus2/3 repositories.


On Fri, Apr 9, 2021 at 2:38 AM Luis Gomez <ecelgp@...> wrote:
Hi everyone,

We are trying to organize some work for creating docker images and helm charts for ODL. In order to kick-off this work, schedule a call, etc, I would like to know who would be interested in contributing. Please reply to this mail or unicast to me if you prefer.

Thanks/Luis



Re: Phosphorus release schedule update

Luis Gomez
 

Anything we want to show for Silicon could be added to the docs stable/silicon branch, however nothing will show in the portal until Anil or LF IT adds the new branch in RTD.

BR/Luis 

On Apr 8, 2021, at 10:58 AM, Daniel de la Rosa <ddelarosa0707@...> wrote:

Thanks Guillaume, Could you or the documentation team also update the downloads page for Silicon?


also update the documentation page to include stable/silicon on the side menu and here


Thanh used to do this so not sure who can take over that now

thanks


On Wed, Mar 31, 2021 at 2:52 AM <guillaume.lambert@...> wrote:

Hi Daniel

 

Sure, I will prepare a change for that.

Note that the docs master branch still points to Silicon for the moment.

We have to wait for the stable/silicon branch creation to make the master branch point to phosphorus and merge this change.

 

Best Regards

Guillaume

 

De : Daniel de la Rosa [mailto:ddelarosa0707@...]
Envoyé : mercredi 31 mars 2021 06:44
À : ODL Docs
Cc : LAMBERT Guillaume TGI/OLN; TSC
Objet : Phosphorus release schedule update

 

Hello Documentation team

 

Could you please help me update ODL Phosphorus release schedule. Basically replace Aluminium with Phosphorus 

 

_________________________________________________________________________________________________________________________

Ce message et ses pieces jointes peuvent contenir des informations confidentielles ou privilegiees et ne doivent donc
pas etre diffuses, exploites ou copies sans autorisation. Si vous avez recu ce message par erreur, veuillez le signaler
a l'expediteur et le detruire ainsi que les pieces jointes. Les messages electroniques etant susceptibles d'alteration,
Orange decline toute responsabilite si ce message a ete altere, deforme ou falsifie. Merci.

This message and its attachments may contain confidential or privileged information that may be protected by law;
they should not be distributed, used or copied without authorisation.
If you have received this email in error, please notify the sender and delete this message and its attachments.
As emails may be altered, Orange is not liable for messages that have been modified, changed or falsified.
Thank you.





Re: Phosphorus release schedule update

Daniel de la Rosa
 

Thanks Guillaume, Could you or the documentation team also update the downloads page for Silicon?


also update the documentation page to include stable/silicon on the side menu and here


Thanh used to do this so not sure who can take over that now

thanks


On Wed, Mar 31, 2021 at 2:52 AM <guillaume.lambert@...> wrote:

Hi Daniel

 

Sure, I will prepare a change for that.

Note that the docs master branch still points to Silicon for the moment.

We have to wait for the stable/silicon branch creation to make the master branch point to phosphorus and merge this change.

 

Best Regards

Guillaume

 

De : Daniel de la Rosa [mailto:ddelarosa0707@...]
Envoyé : mercredi 31 mars 2021 06:44
À : ODL Docs
Cc : LAMBERT Guillaume TGI/OLN; TSC
Objet : Phosphorus release schedule update

 

Hello Documentation team

 

Could you please help me update ODL Phosphorus release schedule. Basically replace Aluminium with Phosphorus 

 

_________________________________________________________________________________________________________________________

Ce message et ses pieces jointes peuvent contenir des informations confidentielles ou privilegiees et ne doivent donc
pas etre diffuses, exploites ou copies sans autorisation. Si vous avez recu ce message par erreur, veuillez le signaler
a l'expediteur et le detruire ainsi que les pieces jointes. Les messages electroniques etant susceptibles d'alteration,
Orange decline toute responsabilite si ce message a ete altere, deforme ou falsifie. Merci.

This message and its attachments may contain confidential or privileged information that may be protected by law;
they should not be distributed, used or copied without authorisation.
If you have received this email in error, please notify the sender and delete this message and its attachments.
As emails may be altered, Orange is not liable for messages that have been modified, changed or falsified.
Thank you.


Re: ODL Helm chart group

Venkatrangan Govindarajan
 

Hi Luis,

 I am willing to contribute

வியா., 8 ஏப்., 2021, பிற்பகல் 10:08 அன்று, Luis Gomez <ecelgp@...> எழுதியது:

Hi everyone,

We are trying to organize some work for creating docker images and helm charts for ODL. In order to kick-off this work, schedule a call, etc, I would like to know who would be interested in contributing. Please reply to this mail or unicast to me if you prefer.

Thanks/Luis




--
Venkatrangan Govindarajan
( When there is no wind...Row )


Re: ODL Helm chart

Luis Gomez
 

Hi Dan, thanks for the pointer :)


On Apr 8, 2021, at 9:51 AM, TIMONEY, DAN <dt5972@...> wrote:

Luis, Anil:
 
ONAP also creates a base OpenDaylight docker container, based on the ONAP-specific ODL tarball.  Here’s a link to the code that creates the Aluminum version of that docker:
 
 
Dan
 
-- 
Dan Timoney
Lead Member of Tech Staff
ONAP Project Technical Lead : CCSDK and SDNC projects
 
 
From: <TSC@...> on behalf of Luis Gomez <ecelgp@...>
Date: Sunday, April 4, 2021 at 7:02 PM
To: Anil Belur <abelur@...>
Cc: discuss <Discuss@...>, TSC <TSC@...>
Subject: Re: [OpenDaylight TSC] ODL Helm chart
 
OK, thanks for the ONAP pointers, I have explored them and I figured the following:
 
Docker:
 
1) ONAP projects use maven to build docker:
 
2) LFN global-jjb has templates for docker build and publish:
 
3) ONAP publishes docker images in Nexus:
 
Helm:
 
1) ONAP projects define their charts in a common repo called OOM:
 
2) Helm job are in ONAP ci-management repo whilst build Makefiles are in OOM:
 
3) ONAP publishes helm packages in Nexus:
 
So in general I think we can leverage a lot of work from above but before doing that I have a couple of question:
 
1) Does current Centos builder image support docker?
2) Does ODL have a docker repo like https://nexus3.onap.org/#browse/search/docker?
 
Thanks/Luis
 
 


On Mar 25, 2021, at 10:06 PM, Anil Belur <abelur@...> wrote:
 
Hello Luis: 
 
ONAP has a few jobs that publish helm charts onto Nexus, and we have some scripts in place that can be reused. 
 
PS let me know if these bits can be reused. I can setup time to discuss the details of usecase for ODL
and get an understanding of which of the ODL $projects would require helm charts.
 
Regards,
Anil
 
 
On Fri, Mar 26, 2021 at 4:51 AM Luis Gomez <ecelgp@...> wrote:
As I brought in today's TSC meeting, any decent IT app nowadays has a helm chart to quickly install in K8s.

Looking at some open source example:

https://github.com/prometheus-community/helm-charts/tree/main/charts/prometheus

It seems like we need to hold some helm definitions in our code repo for folks to perform:

helm repo add odl https://opendaylight.github.io/helm-charts

Also we need to publish docker containers somewhere so they can be used in a K8s Deployment file like this:

    spec:
      containers:
      - name: odl
        image: quay.io/opendaylight/netconf:v0.13.0
...

I am not an expert in K8s so let me know if I miss anything.

Anil, do you see any problem in existing ODL infra to achieve the above?

BR/Luis


Re: ODL Helm chart

TIMONEY, DAN
 

Luis, Anil:

 

ONAP also creates a base OpenDaylight docker container, based on the ONAP-specific ODL tarball.  Here’s a link to the code that creates the Aluminum version of that docker:

 

https://github.com/onap/ccsdk-distribution/tree/master/opendaylight/aluminum/aluminum-alpine

 

Dan

 

-- 

Dan Timoney

dtimoney@...

Lead Member of Tech Staff

ONAP Project Technical Lead : CCSDK and SDNC projects

 

 

From: <TSC@...> on behalf of Luis Gomez <ecelgp@...>
Date: Sunday, April 4, 2021 at 7:02 PM
To: Anil Belur <abelur@...>
Cc: discuss <Discuss@...>, TSC <TSC@...>
Subject: Re: [OpenDaylight TSC] ODL Helm chart

 

OK, thanks for the ONAP pointers, I have explored them and I figured the following:

 

Docker:

 

1) ONAP projects use maven to build docker:

 

2) LFN global-jjb has templates for docker build and publish:

 

3) ONAP publishes docker images in Nexus:

 

Helm:

 

1) ONAP projects define their charts in a common repo called OOM:

 

2) Helm job are in ONAP ci-management repo whilst build Makefiles are in OOM:

 

3) ONAP publishes helm packages in Nexus:

 

So in general I think we can leverage a lot of work from above but before doing that I have a couple of question:

 

1) Does current Centos builder image support docker?

2) Does ODL have a docker repo like https://nexus3.onap.org/#browse/search/docker?

 

Thanks/Luis

 

 



On Mar 25, 2021, at 10:06 PM, Anil Belur <abelur@...> wrote:

 

Hello Luis: 

 

ONAP has a few jobs that publish helm charts onto Nexus, and we have some scripts in place that can be reused. 

 

PS let me know if these bits can be reused. I can setup time to discuss the details of usecase for ODL

and get an understanding of which of the ODL $projects would require helm charts.

 

Regards,

Anil

 

 

On Fri, Mar 26, 2021 at 4:51 AM Luis Gomez <ecelgp@...> wrote:

As I brought in today's TSC meeting, any decent IT app nowadays has a helm chart to quickly install in K8s.

Looking at some open source example:

https://github.com/prometheus-community/helm-charts/tree/main/charts/prometheus

It seems like we need to hold some helm definitions in our code repo for folks to perform:

helm repo add odl https://opendaylight.github.io/helm-charts

Also we need to publish docker containers somewhere so they can be used in a K8s Deployment file like this:

    spec:
      containers:
      - name: odl
        image: quay.io/opendaylight/netconf:v0.13.0
...

I am not an expert in K8s so let me know if I miss anything.

Anil, do you see any problem in existing ODL infra to achieve the above?

BR/Luis

 


ODL Helm chart group

Luis Gomez
 

Hi everyone,

We are trying to organize some work for creating docker images and helm charts for ODL. In order to kick-off this work, schedule a call, etc, I would like to know who would be interested in contributing. Please reply to this mail or unicast to me if you prefer.

Thanks/Luis


Re: ODL Helm chart

Luis Gomez
 

I would think the netconf project, being the most popular out-of-the-box application, would be the perfect candidate to create a helm chart. Still we have to figure the best place for docker and helm code (centralized vs distributed).

BR/Luis

On Apr 5, 2021, at 5:38 PM, Anil Belur <abelur@...> wrote:


On Mon, Apr 5, 2021 at 9:02 AM Luis Gomez <ecelgp@...> wrote:
OK, thanks for the ONAP pointers, I have explored them and I figured the following:

Docker:

1) ONAP projects use maven to build docker:

2) LFN global-jjb has templates for docker build and publish:

3) ONAP publishes docker images in Nexus:

Helm:

1) ONAP projects define their charts in a common repo called OOM:

2) Helm job are in ONAP ci-management repo whilst build Makefiles are in OOM:

3) ONAP publishes helm packages in Nexus:

So in general I think we can leverage a lot of work from above but before doing that I have a couple of question:

1) Does current Centos builder image support docker?
2) Does ODL have a docker repo like https://nexus3.onap.org/#browse/search/docker?


 
1. We already have a CentOS docker image, which can be used.
2. The docker image requires to be pushed to Nexus3, which is already available for ODL, while the Helm charts are pushed onto Nexus2. We'll only need to roll out the repo config for the required projects.

Do we have a use-case as to what $projects would be using these jobs & if these are existing/newer projects? 



Re: Docs branching

Luis Gomez
 

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 <abelur@...> 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 <ecelgp@...> 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





Re: Docs branching

Anil Belur
 

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 <ecelgp@...> 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