Skip to content

Conversation

@jonathangreen
Copy link
Member

Description

Added TOX_DOCKER_GATEWAY environment variable to the test workflow to work around a KeyError: 'Gateway' failure in tox-docker when running on Docker 29+.

Docker 29 removed the deprecated top-level NetworkSettings.Gateway key from the container inspect API. tox-docker 5.0.0 relies on this key and crashes with a KeyError. Setting TOX_DOCKER_GATEWAY=0.0.0.0 bypasses the broken lookup entirely.

This became flaky starting Feb 12 as the Docker 29 rollout to GitHub Actions runners progresses. Once complete, tests will fail 100% of the time without this fix.

This workaround can be removed once tox-docker merges the fix.

Mirrors the fix applied in library-registry#862.

Motivation and Context

CI test runs are failing intermittently with:

tox_docker/plugin.py, line 53, in get_gateway_ip
    ip = container.attrs["NetworkSettings"]["Gateway"] or "0.0.0.0"
KeyError: 'Gateway'

How Has This Been Tested?

  • CI will validate that tests pass with the workaround on Docker 29+ runners

Checklist

  • I have updated the documentation accordingly.
  • All new and existing tests passed.

@codecov
Copy link

codecov bot commented Feb 12, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 93.04%. Comparing base (0862033) to head (368654c).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files
@@           Coverage Diff           @@
##             main    #3045   +/-   ##
=======================================
  Coverage   93.04%   93.04%           
=======================================
  Files         480      480           
  Lines       43712    43712           
  Branches     6028     6028           
=======================================
  Hits        40670    40670           
  Misses       1972     1972           
  Partials     1070     1070           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

jonathangreen added a commit to ThePalaceProject/virtual-library-card that referenced this pull request Feb 12, 2026
## Description

Added `TOX_DOCKER_GATEWAY` environment variable to the test workflow to
work around a `KeyError: 'Gateway'` failure in tox-docker when running
on Docker 29+.

Docker 29 [removed the deprecated top-level `NetworkSettings.Gateway`
key](https://docs.docker.com/engine/release-notes/29/) from the
container inspect API. tox-docker 5.0.0 relies on this key and crashes
with a `KeyError`. Setting `TOX_DOCKER_GATEWAY=0.0.0.0` bypasses the
broken lookup entirely.

This became flaky starting Feb 12 as the [Docker 29
rollout](actions/runner-images#13474) to
GitHub Actions runners progresses. Once complete, tests will fail 100%
of the time without this fix.

This workaround can be removed once [tox-docker merges the
fix](tox-dev/tox-docker#196).

Mirrors the fix applied in
[circulation#3045](ThePalaceProject/circulation#3045)
and
[library-registry#862](ThePalaceProject/library-registry#862).

## Motivation and Context

CI test runs are failing intermittently with:
```
tox_docker/plugin.py, line 53, in get_gateway_ip
    ip = container.attrs["NetworkSettings"]["Gateway"] or "0.0.0.0"
KeyError: 'Gateway'
```

## How Has This Been Tested?

- CI will validate that tests pass with the workaround on Docker 29+
runners

## Checklist

- [x] I have updated the documentation accordingly.
- [x] All new and existing tests passed.
@jonathangreen jonathangreen merged commit d7f977d into main Feb 12, 2026
19 checks passed
@jonathangreen jonathangreen deleted the chore/fix-tox-docker-docker29 branch February 12, 2026 19:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants