{"record":{"id":"ca241bd8a47c27a1","repo":"GoogleContainerTools/skaffold","slug":"creating-skaffold-network-s-w","errorCode":null,"errorMessage":"creating skaffold network %s: %w","messagePattern":"creating skaffold network (.+?): %w","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"pkg/skaffold/actions/docker/exec_env.go","lineNumber":112,"sourceCode":"\t}\n\n\treturn &ExecEnv{\n\t\tlogger:              l,\n\t\tclient:              client,\n\t\ttracker:             tracker,\n\t\tportManager:         dockerport.NewPortManager(),\n\t\tpResources:          resources,\n\t\tnetwork:             network,\n\t\tshouldCreateNetwork: shouldCreateNetwork,\n\t\tacsCfgByName:        acsCfgByName,\n\t\tenvVars:             envVars,\n\t}, nil\n}\n\nfunc (e ExecEnv) PrepareActions(ctx context.Context, out io.Writer, allbuilds, _ []graph.Artifact, acsNames []string) ([]actions.Action, error) {\n\tif e.shouldCreateNetwork {\n\t\tif err := e.client.NetworkCreate(ctx, e.network, nil); err != nil {\n\t\t\treturn nil, fmt.Errorf(\"creating skaffold network %s: %w\", e.network, err)\n\t\t}\n\t}\n\n\te.logger.Start(ctx, out)\n\n\treturn e.createActions(ctx, out, allbuilds, acsNames)\n}\n\nfunc (e ExecEnv) Cleanup(ctx context.Context, out io.Writer) error {\n\tif !e.shouldCreateNetwork {\n\t\treturn nil\n\t}\n\n\tif err := e.client.NetworkRemove(ctx, e.network); err != nil {\n\t\treturn errors.Wrap(err, \"cleaning up skaffold created network\")\n\t}\n\n\treturn nil","sourceCodeStart":94,"sourceCodeEnd":130,"githubUrl":"https://github.com/GoogleContainerTools/skaffold/blob/a1189de023efc32d4b8e11f395acc678aa555011/pkg/skaffold/actions/docker/exec_env.go#L94-L130","documentation":"The local docker action exec environment (pkg/skaffold/actions/docker) creates a dedicated Docker network named after the skaffold run before executing custom actions. If docker NetworkCreate fails, PrepareActions aborts with this wrapped error. It surfaces underlying Docker daemon/network-driver failures.","triggerScenarios":"Running skaffold actions locally (verify/run with local execution mode) where e.client.NetworkCreate fails — Docker daemon unreachable, network name already exists with conflicting config, or no bridge driver available.","commonSituations":"Docker Desktop not running; docker context pointing at a remote daemon that rejects network creation; leftover network from a previous crashed run with the same name; rootless-docker limitations.","solutions":["Verify Docker is running: docker info; start Docker Desktop or the dockerd service if not.","Check for a conflicting existing network (docker network ls | grep <network>) and remove stale ones with docker network rm.","Confirm your docker context/DOCKER_HOST points at the intended daemon and that the bridge network driver is available."],"exampleFix":"// before\ndocker network rm skaffold-network  # stale network from previous failed run\nskaffold verify ...\n// after\ndocker network ls  # confirm clean state, then rerun\nskaffold verify ...","handlingStrategy":"try-catch","validationCode":"// Verify daemon reachable and no conflicting network before running actions\ndocker info > /dev/null && ! docker network inspect skaffold-network > /dev/null 2>&1","typeGuard":null,"tryCatchPattern":"try {\n  await skaffold.verify(...);\n} catch (e) {\n  if (/creating skaffold network/.test(String(e))) {\n    execSync('docker network prune -f'); // clear stale networks then retry once\n    await skaffold.verify(...);\n    return;\n  }\n  throw e;\n}","preventionTips":["Ensure Docker Desktop/dockerd is running before invoking skaffold actions","Prune stale skaffold networks after crashed runs (docker network rm)","Keep DOCKER_HOST/docker context consistent across build and verify steps"],"tags":["docker","networking","skaffold","custom-actions"],"backgroundTag":"docker-network-create-failed","analyzedSha":"a1189de023efc32d4b8e11f395acc678aa555011","analyzedAt":"2026-09-05T12:09:27.064Z","contentChangedAt":"2026-09-05T12:09:27.064Z","schemaVersion":2},"datasetVersion":"2026-09-12T17:17:11.597Z"}