← Back to issue list

in the common case of networking issues between LXD and Docker, the error's doc_url isn't useful

View original Github issue

Metadata

Project
rockcraft
Number
#598
Type
issue
State
closed
Author
cjdcordeiro
Labels
Type: Documentation
Created
Updated
Closed

Current evaluation

Resolved by updating documentation to include troubleshooting guidance for LXD and Docker networking conflicts. The issue was closed after the generic error message was supplemented with specific resolution steps.

Suggested action:

No scores available.

Issue body

### Bug Description When hitting the issue described here: https://documentation.ubuntu.com/lxd/en/latest/howto/network_bridge_firewalld/#prevent-connectivity-issues-with-lxd-and-docker, Rockcraft will raise an error similar to the following: ``` A network related operation failed in a context of no network access. Recommended resolution: Verify that the environment has internet connectivity; see https://craft-providers.readthedocs.io/ for further reference. ``` But the given `doc_url` doesn't really have any useful information about how to fix this issue. It is too generic. I understand networking issues can vary, but we should at least have a troubleshooting section as a "catch all", where this specific LXD vs Docker conflict is described as a potential solution to the error. ### To Reproduce Start from a fresh installation, install Docker, setup LXD and then `rockcraft pack`. ### Environment Any ### rockcraft.yaml ```shell Any ``` ### Relevant log output ```shell A network related operation failed in a context of no network access. Recommended resolution: Verify that the environment has internet connectivity; see https://craft-providers.readthedocs.io/ for further reference. ```

Evaluation history

Date Model Scores Action Summary
qwen/qwen3.6-35b-a3b Resolved by updating documentation to include troubleshooting guidance for LXD and Docker networking conflicts. The issue was closed after the generic error message was supplemented with specific resolution steps.
qwen/qwen3.6-35b-a3b Documentation was updated to include troubleshooting steps for LXD and Docker networking conflicts, resolving the generic error message. The issue was closed after the fix was implemented.
qwen/qwen3.6-35b-a3b Resolved by updating documentation to include troubleshooting steps for LXD and Docker networking conflicts. The generic error guidance was replaced with specific connectivity instructions, closing the issue.
qwen3.6-35b-a3b-mtp-q6 Documentation updated to include a troubleshooting section for LXD and Docker networking conflicts. The generic error URL now directs users to specific resolution steps, addressing the reported lack of useful guidance.
qwen3.6-35b-a3b-mtp-q6 Resolved by updating documentation to include specific troubleshooting steps for LXD and Docker networking conflicts, replacing the generic error guidance. Issue closed.

Update history

No update history recorded yet.

Related issues

Issue Project State Summary Similarity
#1144 docs: Update handling of LXD/Docker incompatibility rockcraft closed Documentation updates for LXD/Docker incompatibility were implemented in PR #1148. The issue was closed as superseded by the merged pull request, which added sysctl configuration steps, linked official LXD docs, and updated warning admonitions.
72%