search

canonical / rockcraft

Tool to create OCI Images using the language from Snapcraft and Charmcraft.
GNU General Public License v3.0
25 stars 33 forks source link

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

Open cjdcordeiro opened 1 week ago

cjdcordeiro commented 1 week ago

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

Any

Relevant log output

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.