Errors when building multiple collections at once #193
Comments
|
What happens if you run |
|
@felixfontein Thanks for your feedback! It was a good idea to execute the last command (
Most probably the issue isn't related to antsibull-docs but maybe someone has an idea for what reason the command could be killed. It couldn't find any google result at all where the |
|
@wlitke my guess is that it got killed because it ran out of memory. You have a large amount of collections installed (all of the ones included in the ansible package), which results in the JSON output that ansible-doc tries to create to be very large. You could set |
|
@felixfontein Thank you very much for your time and for the hint! I've checked the system logs via command When I increase the VM memory to |
|
@felixfontein Unfortunatelly setting the environment variable I've set the variable with command If I re-execute the origin command |
|
I believe collections that are part of the ansible package and installed in site-packages/ansible_collections are discovered by ansible regardless of ANSIBLE_COLLECTIONS_PATH. |
|
@gotmax23 I have the same assumption but maybe there's a kind of hack which enables to ignore the collections in folder path Just to try it out I moved all collection folders from mentioned path into a temporary directory somewhere else (directory may not be part of any path visible in output of command Maybe this is the kind of hack which must be performed but it really doesn't feel right to move folders temporary, just in order to generate a documentation. I hope strongly there's a better solution than moving folders around :) Addition: Temporary rename of folder |
|
Thanks for following up. You can try creating a separate venv without the ansible package installed. There's not much the antsibull project can do about this issue, unfortunately. |
|
@gotmax23 Yes, you are right. This issue is related to ansible and not to antsibull-docs project. Summarized you need an environment where the folder Let's hope that this part can be configured in the future for ansible. @gotmax23 @felixfontein Thank you very much guys for your great support! |
|
I started an initiative (ansible/ansible#81450) to make it possible to build docs for just a few collections more efficiently, even if many more collections are installed. If we can get this (or something similar) merged, such problems should go away... |
Can't you just install ansible-core without ansible? I don't see the point in installing ansible just to manually |
|
@felixfontein Awesome! Thank you very much for your proactive support. @gotmax23 Yes, you could be right. I haven't tried the approach yet since I wanted to avoid the maintenance of multiple ansible installations (meaning an installation for the regular ansible usage and an installation for the creation of documentations). The temporary folder rename (better than folder removal) is a feasible approach to avoid multiple installations. Please correct me if I miss something or if I missunderstood your suggestion. |
If I try to build a documentation site for multiple (small) collections it takes long time and fails afterwards with the below error messages. Any idea about a possible root cause?
Versions in use
Commands
Output
The text was updated successfully, but these errors were encountered: