Skip to content

Commit 9955129

Browse files
authored
Merge pull request #4536 from AkihiroSuda/docs-windows
docs/command-reference.md: remove outdated "Windows enabled" notes
2 parents 30ec0b9 + 9430f11 commit 9955129

File tree

1 file changed

+62
-62
lines changed

1 file changed

+62
-62
lines changed

docs/command-reference.md

Lines changed: 62 additions & 62 deletions
Original file line numberDiff line numberDiff line change
@@ -4,21 +4,21 @@
44

55
:nerd_face: = nerdctl specific
66

7-
:blue_square: = Windows enabled
8-
9-
Unlisted `docker` CLI flags are unimplemented yet in `nerdctl` CLI.
10-
It does not necessarily mean that the corresponding features are missing in containerd.
7+
> [!NOTE]
8+
- Unlisted `docker` CLI flags are unimplemented yet in `nerdctl` CLI.
9+
It does not necessarily mean that the corresponding features are missing in containerd.
10+
- Some commands and flags are only available on Linux.
1111

1212
<!-- START doctoc generated TOC please keep comment here to allow auto update -->
1313
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
1414

1515
- [Container management](#container-management)
16-
- [:whale: :blue_square: nerdctl run](#whale-blue_square-nerdctl-run)
17-
- [:whale: :blue_square: nerdctl exec](#whale-blue_square-nerdctl-exec)
18-
- [:whale: :blue_square: nerdctl create](#whale-blue_square-nerdctl-create)
16+
- [:whale: nerdctl run](#whale-blue_square-nerdctl-run)
17+
- [:whale: nerdctl exec](#whale-blue_square-nerdctl-exec)
18+
- [:whale: nerdctl create](#whale-blue_square-nerdctl-create)
1919
- [:whale: nerdctl cp](#whale-nerdctl-cp)
20-
- [:whale: :blue_square: nerdctl ps](#whale-blue_square-nerdctl-ps)
21-
- [:whale: :blue_square: nerdctl inspect](#whale-blue_square-nerdctl-inspect)
20+
- [:whale: nerdctl ps](#whale-blue_square-nerdctl-ps)
21+
- [:whale: nerdctl inspect](#whale-blue_square-nerdctl-inspect)
2222
- [:whale: nerdctl logs](#whale-nerdctl-logs)
2323
- [:whale: nerdctl port](#whale-nerdctl-port)
2424
- [:whale: nerdctl rm](#whale-nerdctl-rm)
@@ -39,8 +39,8 @@ It does not necessarily mean that the corresponding features are missing in cont
3939
- [:whale: nerdctl build](#whale-nerdctl-build)
4040
- [:whale: nerdctl commit](#whale-nerdctl-commit)
4141
- [Image management](#image-management)
42-
- [:whale: :blue_square: nerdctl images](#whale-blue_square-nerdctl-images)
43-
- [:whale: :blue_square: nerdctl pull](#whale-blue_square-nerdctl-pull)
42+
- [:whale: nerdctl images](#whale-blue_square-nerdctl-images)
43+
- [:whale: nerdctl pull](#whale-blue_square-nerdctl-pull)
4444
- [:whale: nerdctl push](#whale-nerdctl-push)
4545
- [:whale: nerdctl load](#whale-nerdctl-load)
4646
- [:whale: nerdctl save](#whale-nerdctl-save)
@@ -75,11 +75,11 @@ It does not necessarily mean that the corresponding features are missing in cont
7575
- [:whale: nerdctl volume rm](#whale-nerdctl-volume-rm)
7676
- [:whale: nerdctl volume prune](#whale-nerdctl-volume-prune)
7777
- [Namespace management](#namespace-management)
78-
- [:nerd_face: :blue_square: nerdctl namespace create](#nerd_face-blue_square-nerdctl-namespace-create)
79-
- [:nerd_face: :blue_square: nerdctl namespace inspect](#nerd_face-blue_square-nerdctl-namespace-inspect)
80-
- [:nerd_face: :blue_square: nerdctl namespace ls](#nerd_face-blue_square-nerdctl-namespace-ls)
81-
- [:nerd_face: :blue_square: nerdctl namespace remove](#nerd_face-blue_square-nerdctl-namespace-remove)
82-
- [:nerd_face: :blue_square: nerdctl namespace update](#nerd_face-blue_square-nerdctl-namespace-update)
78+
- [:nerd_face: nerdctl namespace create](#nerd_face-blue_square-nerdctl-namespace-create)
79+
- [:nerd_face: nerdctl namespace inspect](#nerd_face-blue_square-nerdctl-namespace-inspect)
80+
- [:nerd_face: nerdctl namespace ls](#nerd_face-blue_square-nerdctl-namespace-ls)
81+
- [:nerd_face: nerdctl namespace remove](#nerd_face-blue_square-nerdctl-namespace-remove)
82+
- [:nerd_face: nerdctl namespace update](#nerd_face-blue_square-nerdctl-namespace-update)
8383
- [AppArmor profile management](#apparmor-profile-management)
8484
- [:nerd_face: nerdctl apparmor inspect](#nerd_face-nerdctl-apparmor-inspect)
8585
- [:nerd_face: nerdctl apparmor load](#nerd_face-nerdctl-apparmor-load)
@@ -135,7 +135,7 @@ It does not necessarily mean that the corresponding features are missing in cont
135135

136136
## Container management
137137

138-
### :whale: :blue_square: nerdctl run
138+
### :whale: nerdctl run
139139

140140
Run a command in a new container.
141141

@@ -147,11 +147,11 @@ Usage: `nerdctl run [OPTIONS] IMAGE [COMMAND] [ARG...]`
147147
Basic flags:
148148

149149
- :whale: `-a, --attach`: Attach STDIN, STDOUT, or STDERR
150-
- :whale: :blue_square: `-i, --interactive`: Keep STDIN open even if not attached"
151-
- :whale: :blue_square: `-t, --tty`: Allocate a pseudo-TTY
150+
- :whale: `-i, --interactive`: Keep STDIN open even if not attached"
151+
- :whale: `-t, --tty`: Allocate a pseudo-TTY
152152
- :warning: WIP: currently `-t` conflicts with `-d`
153153
- :whale: `-sig-proxy`: Proxy received signals to the process (default true)
154-
- :whale: :blue_square: `-d, --detach`: Run container in background and print container ID
154+
- :whale: `-d, --detach`: Run container in background and print container ID
155155
- :whale: `--restart=(no|always|on-failure|unless-stopped)`: Restart policy to apply when a container exits
156156
- Default: "no"
157157
- always: Always restart the container if it stops.
@@ -180,7 +180,7 @@ Init process flags:
180180

181181
Isolation flags:
182182

183-
- :whale: :blue_square: :nerd_face: `--isolation=(default|process|host|hyperv)`: Used on Windows to change process isolation level. `default` will use the runtime options configured in `default_runtime` in the [containerd configuration](https://github.com/containerd/containerd/blob/master/docs/cri/config.md#cri-plugin-config-guide) which is `process` in containerd by default. `process` runs process isolated containers. `host` runs [Host Process containers](https://kubernetes.io/docs/tasks/configure-pod-container/create-hostprocess-pod/). Host process containers inherit permissions from containerd process unless `--user` is specified then will start with user specified and the user specified must be present on the host. `host` requires Containerd 1.7+. `hyperv` runs Hyper-V hypervisor partition-based isolated containers. Not implemented for Linux.
183+
- :whale: :nerd_face: `--isolation=(default|process|host|hyperv)`: Used on Windows to change process isolation level. `default` will use the runtime options configured in `default_runtime` in the [containerd configuration](https://github.com/containerd/containerd/blob/master/docs/cri/config.md#cri-plugin-config-guide) which is `process` in containerd by default. `process` runs process isolated containers. `host` runs [Host Process containers](https://kubernetes.io/docs/tasks/configure-pod-container/create-hostprocess-pod/). Host process containers inherit permissions from containerd process unless `--user` is specified then will start with user specified and the user specified must be present on the host. `host` requires Containerd 1.7+. `hyperv` runs Hyper-V hypervisor partition-based isolated containers. Not implemented for Linux.
184184

185185
Network flags:
186186

@@ -231,15 +231,15 @@ Resource flags:
231231
- :whale: `--cgroupns=(host|private)`: Cgroup namespace to use
232232
- Default: "private" on cgroup v2 hosts, "host" on cgroup v1 hosts
233233
- :whale: `--cgroup-parent`: Optional parent cgroup for the container
234-
- :whale: :blue_square: `--device`: Add a host device to the container
234+
- :whale: `--device`: Add a host device to the container
235235

236236
Intel RDT flags:
237237

238238
- :nerd_face: `--rdt-class=CLASS`: Name of the RDT class (or CLOS) to associate the container wit
239239

240240
User flags:
241241

242-
- :whale: :blue_square: `-u, --user`: Username or UID (format: <name|uid>[:<group|gid>])
242+
- :whale: `-u, --user`: Username or UID (format: <name|uid>[:<group|gid>])
243243
- :nerd_face: `--umask`: Set the umask inside the container. Defaults to 0022.
244244
Corresponds to Podman CLI.
245245
- :whale: `--group-add`: Add additional groups to join
@@ -274,7 +274,7 @@ Runtime flags:
274274

275275
Volume flags:
276276

277-
- :whale: :blue_square: `-v, --volume <SRC>:<DST>[:<OPT>]`: Bind mount a volume, e.g., `-v /mnt:/mnt:rro,rprivate`
277+
- :whale: `-v, --volume <SRC>:<DST>[:<OPT>]`: Bind mount a volume, e.g., `-v /mnt:/mnt:rro,rprivate`
278278
- :whale: option `rw` : Read/Write (when writable)
279279
- :whale: option `ro` : Non-recursive read-only
280280
- :nerd_face: option `rro`: Recursive read-only. Should be used in conjunction with `rprivate`. e.g., `-v /mnt:/mnt:rro,rprivate` makes children such as `/mnt/usb` to be read-only, too.
@@ -315,29 +315,29 @@ Rootfs flags:
315315

316316
Env flags:
317317

318-
- :whale: :blue_square: `--entrypoint`: Overwrite the default ENTRYPOINT of the image
319-
- :whale: :blue_square: `-w, --workdir`: Working directory inside the container
320-
- :whale: :blue_square: `-e, --env`: Set environment variables
321-
- :whale: :blue_square: `--env-file`: Set environment variables from file
318+
- :whale: `--entrypoint`: Overwrite the default ENTRYPOINT of the image
319+
- :whale: `-w, --workdir`: Working directory inside the container
320+
- :whale: `-e, --env`: Set environment variables
321+
- :whale: `--env-file`: Set environment variables from file
322322

323323
Metadata flags:
324324

325-
- :whale: :blue_square: `--name`: Assign a name to the container
326-
- :whale: :blue_square: `-l, --label`: Set meta data on a container (Not passed through the OCI runtime since nerdctl v2.0, with an exception for `nerdctl/bypass4netns`)
327-
- :whale: :blue_square: `--label-file`: Read in a line delimited file of labels
328-
- :whale: :blue_square: `--annotation`: Add an annotation to the container (passed through to the OCI runtime)
329-
- :whale: :blue_square: `--cidfile`: Write the container ID to the file
325+
- :whale: `--name`: Assign a name to the container
326+
- :whale: `-l, --label`: Set meta data on a container (Not passed through the OCI runtime since nerdctl v2.0, with an exception for `nerdctl/bypass4netns`)
327+
- :whale: `--label-file`: Read in a line delimited file of labels
328+
- :whale: `--annotation`: Add an annotation to the container (passed through to the OCI runtime)
329+
- :whale: `--cidfile`: Write the container ID to the file
330330
- :nerd_face: `--pidfile`: file path to write the task's pid. The CLI syntax conforms to Podman convention.
331331

332332
Health check flags:
333333

334-
- :whale: :blue_square: `--health-cmd`: Command to run to check container health
335-
- :whale: :blue_square: `--health-interval`: Time between running the check (e.g., 30s, 1m)
336-
- :whale: :blue_square: `--health-timeout`: Time to wait before considering the check failed (e.g., 5s)
337-
- :whale: :blue_square: `--health-retries`: Number of failures before container is considered unhealthy
338-
- :whale: :blue_square: `--health-start-period`: Start period for the container to initialize before starting health-retries countdown
339-
- :whale: :blue_square: `--health-start-interval`: Interval between checks during the start period
340-
- :whale: :blue_square: `--no-healthcheck`: Disable any health checks defined by image or CLI
334+
- :whale: `--health-cmd`: Command to run to check container health
335+
- :whale: `--health-interval`: Time between running the check (e.g., 30s, 1m)
336+
- :whale: `--health-timeout`: Time to wait before considering the check failed (e.g., 5s)
337+
- :whale: `--health-retries`: Number of failures before container is considered unhealthy
338+
- :whale: `--health-start-period`: Start period for the container to initialize before starting health-retries countdown
339+
- :whale: `--health-start-interval`: Interval between checks during the start period
340+
- :whale: `--no-healthcheck`: Disable any health checks defined by image or CLI
341341

342342
Logging flags:
343343

@@ -449,7 +449,7 @@ Unimplemented `docker run` flags:
449449
`--device-cgroup-rule`, `--disable-content-trust`, `--expose`, `--isolation`,
450450
`--link*`, `--publish-all`, `--storage-opt`, `--volume-driver`
451451

452-
### :whale: :blue_square: nerdctl exec
452+
### :whale: nerdctl exec
453453

454454
Run a command in a running container.
455455

@@ -469,7 +469,7 @@ Flags:
469469

470470
Unimplemented `docker exec` flags: `--detach-keys`
471471

472-
### :whale: :blue_square: nerdctl create
472+
### :whale: nerdctl create
473473

474474
Create a new container.
475475

@@ -498,7 +498,7 @@ Flags:
498498

499499
Unimplemented `docker cp` flags: `--archive`
500500

501-
### :whale: :blue_square: nerdctl ps
501+
### :whale: nerdctl ps
502502

503503
List containers.
504504

@@ -542,7 +542,7 @@ Following arguments for `--filter` are not supported yet:
542542
4. `--filter isolation=<value>`
543543
5. `--filter is-task=<value>`
544544

545-
### :whale: :blue_square: nerdctl inspect
545+
### :whale: nerdctl inspect
546546

547547
Display detailed information on one or more containers.
548548

@@ -801,7 +801,7 @@ support zstdchunked convert
801801

802802
## Image management
803803

804-
### :whale: :blue_square: nerdctl images
804+
### :whale: nerdctl images
805805

806806
List images
807807

@@ -828,7 +828,7 @@ Flags:
828828
- :nerd_face: `--filter=reference=<image:tag>`: Filter images by reference (Matches both docker compatible wildcard pattern and regexp match)
829829
- :nerd_face: `--names`: Show image names
830830

831-
### :whale: :blue_square: nerdctl pull
831+
### :whale: nerdctl pull
832832

833833
Pull an image from a registry.
834834

@@ -1189,7 +1189,7 @@ Flags:
11891189
- :whale: `--driver=bridge`: Default driver for unix
11901190
- :whale: `--driver=macvlan`: Macvlan network driver for unix
11911191
- :whale: `--driver=ipvlan`: IPvlan network driver for unix
1192-
- :whale: :blue_square: `--driver=nat`: Default driver for windows
1192+
- :whale: `--driver=nat`: Default driver for windows
11931193
- :whale: `-o, --opt`: Set driver specific options
11941194
- :whale: `--opt=com.docker.network.driver.mtu=<MTU>`: Set the containers network MTU
11951195
- :nerd_face: `--opt=mtu=<MTU>`: Alias of `--opt=com.docker.network.driver.mtu=<MTU>`
@@ -1200,7 +1200,7 @@ Flags:
12001200
- :nerd_face: `--opt=mode=(bridge|l2|l3)`: Alias of `--opt=macvlan_mode=(bridge)` and `--opt=ipvlan_mode=(l2|l3)`
12011201
- :whale: `--opt=parent=<INTERFACE>`: Set valid parent interface on host
12021202
- :whale: `--ipam-driver=(default|host-local|dhcp)`: IP Address Management Driver
1203-
- :whale: :blue_square: `--ipam-driver=default`: Default IPAM driver
1203+
- :whale: `--ipam-driver=default`: Default IPAM driver
12041204
- :nerd_face: `--ipam-driver=host-local`: Host-local IPAM driver for unix
12051205
- :nerd_face: `--ipam-driver=dhcp`: DHCP IPAM driver for unix, requires root
12061206
- :whale: `--ipam-opt`: Set IPAM driver specific options
@@ -1341,7 +1341,7 @@ Unimplemented `docker volume prune` flags: `--filter`
13411341

13421342
## Namespace management
13431343

1344-
### :nerd_face: :blue_square: nerdctl namespace create
1344+
### :nerd_face: nerdctl namespace create
13451345

13461346
Create a new namespace.
13471347

@@ -1350,13 +1350,13 @@ Flags:
13501350

13511351
- `--label`: Set labels for a namespace
13521352

1353-
### :nerd_face: :blue_square: nerdctl namespace inspect
1353+
### :nerd_face: nerdctl namespace inspect
13541354

13551355
Inspect a namespace.
13561356

13571357
Usage: `nerdctl namespace inspect NAMESPACE`
13581358

1359-
### :nerd_face: :blue_square: nerdctl namespace ls
1359+
### :nerd_face: nerdctl namespace ls
13601360

13611361
List containerd namespaces such as "default", "moby", or "k8s.io".
13621362

@@ -1367,7 +1367,7 @@ Flags:
13671367
- `-q, --quiet`: Only display namespace names
13681368
- `-f, --format`: Format the output using the given Go template, e.g, `{{json .}}`
13691369

1370-
### :nerd_face: :blue_square: nerdctl namespace remove
1370+
### :nerd_face: nerdctl namespace remove
13711371

13721372
Remove one or more namespaces.
13731373

@@ -1377,7 +1377,7 @@ Flags:
13771377

13781378
- `-c, --cgroup`: delete the namespace's cgroup
13791379

1380-
### :nerd_face: :blue_square: nerdctl namespace update
1380+
### :nerd_face: nerdctl namespace update
13811381

13821382
Update labels for a namespace.
13831383

@@ -1908,15 +1908,15 @@ Flags:
19081908

19091909
## Global flags
19101910

1911-
- :nerd_face: :blue_square: `--address`: containerd address, optionally with "unix://" prefix
1912-
- :nerd_face: :blue_square: `-a`, `--host`, `-H`: deprecated aliases of `--address`
1913-
- :nerd_face: :blue_square: `--namespace`: containerd namespace
1914-
- :nerd_face: :blue_square: `-n`: deprecated alias of `--namespace`
1915-
- :nerd_face: :blue_square: `--snapshotter`: containerd snapshotter
1916-
- :nerd_face: :blue_square: `--storage-driver`: deprecated alias of `--snapshotter`
1917-
- :nerd_face: :blue_square: `--cni-path`: CNI binary path (default: `/opt/cni/bin`) [`$CNI_PATH`]
1918-
- :nerd_face: :blue_square: `--cni-netconfpath`: CNI netconf path (default: `/etc/cni/net.d`) [`$NETCONFPATH`]
1919-
- :nerd_face: :blue_square: `--data-root`: nerdctl data root, e.g. "/var/lib/nerdctl"
1911+
- :nerd_face: `--address`: containerd address, optionally with "unix://" prefix
1912+
- :nerd_face: `-a`, `--host`, `-H`: deprecated aliases of `--address`
1913+
- :nerd_face: `--namespace`: containerd namespace
1914+
- :nerd_face: `-n`: deprecated alias of `--namespace`
1915+
- :nerd_face: `--snapshotter`: containerd snapshotter
1916+
- :nerd_face: `--storage-driver`: deprecated alias of `--snapshotter`
1917+
- :nerd_face: `--cni-path`: CNI binary path (default: `/opt/cni/bin`) [`$CNI_PATH`]
1918+
- :nerd_face: `--cni-netconfpath`: CNI netconf path (default: `/etc/cni/net.d`) [`$NETCONFPATH`]
1919+
- :nerd_face: `--data-root`: nerdctl data root, e.g. "/var/lib/nerdctl"
19201920
- :nerd_face: `--cgroup-manager=(cgroupfs|systemd|none)`: cgroup manager
19211921
- Default: "systemd" on cgroup v2 (rootful & rootless), "cgroupfs" on v1 rootful, "none" on v1 rootless
19221922
- :nerd_face: `--insecure-registry`: skips verifying HTTPS certs, and allows falling back to plain HTTP

0 commit comments

Comments
 (0)