Skip to content

Commit

Permalink
Update Windows documentation (#5789)
Browse files Browse the repository at this point in the history
The user-facing Windows document is updated as follows:
* containerd will be the only supported container runtime on Windows
  Nodes, Docker support (that includes cri-dockerd, Docker Desktop) is
  officially deprecated.
* we split the "Installation as Pod" section into 2 new sections (one
  for containerd, one for Docker).
* installation methods are re-ordered, starting with the recommended /
  most common one: Installation as a Pod for containerd, Installation as
  Windows services, Installation as a Pod for Docker (deprecated).

The main idea is to make the installation instructions clearer and
easier to follow for a "normal" user, deploying the latest Antrea
version on a recent K8s cluster. In this situation, the recommended
installation method is to use antrea-windows-containerd.yml or
antrea-windows-containerd-with-ovs.yml, which leverage HostProcess
Windows Pods.

There is still a lot of room for future improvements. I suggest that for
Antrea v2.0 we drop all references to Docker and kube-proxy from this
document.

The "Antrea Management on Windows" section is also dropped from the
Windows design document, as it was stale information.

For #5624 #5630

Signed-off-by: Antonin Bas <[email protected]>
  • Loading branch information
antoninbas authored Jan 17, 2024
1 parent 36edc37 commit 913884b
Show file tree
Hide file tree
Showing 2 changed files with 310 additions and 280 deletions.
19 changes: 8 additions & 11 deletions docs/design/windows-design.md
Original file line number Diff line number Diff line change
Expand Up @@ -188,17 +188,14 @@ these scenarios:
* OpenFlow connection
* The connection between CNI plugin and CNI server

## Antrea Management on Windows

### Antrea Agent Management

The Antrea Agent is running as a process on the Windows Node, but it is managed using a DaemonSet. The utility
[Rancher Wins](https://github.com/rancher/wins) is used to manage the host process from inside the DaemonSet Pod.
The Antrea Agent is configured using a ConfigMap, and the environment variables are set by kubelet on Windows.

### OVS Management

OVS is running as 2 Windows Services: one for ovsdb-server and one for ovs-vswitchd.
## Antrea and OVS Management on Windows

While we provide different installation methods for Windows, the recommended one starting with
Antrea v1.13 is to use the `antrea-windows-containerd-with-ovs.yml` manifest. With this method, the
antrea-agent process and the OVS daemons (ovsdb-server and ovs-vswitchd) run as a Pod on Windows
worker Nodes, and are managed by a DaemonSet. This installation method relies on
[Windows HostProcess Pod](https://kubernetes.io/docs/tasks/configure-pod-container/create-hostprocess-pod/)
support.

## Traffic walkthrough

Expand Down
Loading

0 comments on commit 913884b

Please sign in to comment.