From ed0637187d6cac7986688e171e9f379ed298b14a Mon Sep 17 00:00:00 2001 From: Bjorn Neergaard Date: Mon, 6 Feb 2023 09:12:22 -0700 Subject: [PATCH] engine: amend 23.0 release notes with ipvlan issue Signed-off-by: Bjorn Neergaard --- engine/release-notes/23.0.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/engine/release-notes/23.0.md b/engine/release-notes/23.0.md index 05da4c9ad5..a0441f0fa3 100644 --- a/engine/release-notes/23.0.md +++ b/engine/release-notes/23.0.md @@ -236,6 +236,31 @@ The workaround to this issue is to install the `apparmor` package manually: apt-get install apparmor ``` +#### ipvlan networks ([tracking issue](https://github.com/moby/moby/issues/44925)) + +When upgrading to the 23.0 branch, some previously created [ipvlan](/network/ipvlan/) networks cause a panic during start: + +``` +panic: interface conversion: interface {} is nil, not string + +goroutine 1 [running]: +github.com/docker/docker/libnetwork/drivers/ipvlan.(*configuration).UnmarshalJSON(0x40011533b0, {0x400069c2d0, 0xef, 0xef}) + /go/src/github.com/docker/docker/libnetwork/drivers/ipvlan/ipvlan_store.go:196 +0x414 +encoding/json.(*decodeState).object(0x4001153440, {0x5597157640?, 0x40011533b0?, 0x559524115c?}) + /usr/local/go/src/encoding/json/decode.go:613 +0x650 +encoding/json.(*decodeState).value(0x4001153440, {0x5597157640?, 0x40011533b0?, 0x559524005c?}) + /usr/local/go/src/encoding/json/decode.go:374 +0x40 +encoding/json.(*decodeState).unmarshal(0x4001153440, {0x5597157640?, 0x40011533b0?}) + /usr/local/go/src/encoding/json/decode.go:181 +0x204 +encoding/json.Unmarshal({0x400069c2d0, 0xef, 0xef}, {0x5597157640, 0x40011533b0}) + /usr/local/go/src/encoding/json/decode.go:108 +0xf4 +github.com/docker/docker/libnetwork/drivers/ipvlan.(*configuration).SetValue(0x4000d18050?, {0x400069c2d0?, 0x23?, 0x23?}) + /go/src/github.com/docker/docker/libnetwork/drivers/ipvlan/ipvlan_store.go:230 +0x38 +``` + +To mitigate this, affected users can downgrade and remove the network, then upgrade again. +Alternatively, the entire network store can be removed, and networks can be recreated after the upgrade. The network store is located at `/var/lib/docker/network/files/local-kv.db`. If the daemon is using an alternate `--data-root`, substitute `/var/lib/docker` for the alternate path. + #### Kata Containers ([tracking issue](https://github.com/kata-containers/kata-containers/issues/6154)) The 23.0 branch brings support for alternate containerd shims, such as `io.containerd.runsc.v1` (gVisor) and `io.containerd.kata.v2` (Kata Containers).