Fossil SCM
Documented another cause to modify the "m" variable in the runc examples in the container docs.
Commit
bf5030883ae32fd8e12415b53198515d14055f4a94e0b8e288aa575891038899
Parent
4e8c74797fa7ac7…
1 file changed
+7
-4
+7
-4
| --- www/containers.md | ||
| +++ www/containers.md | ||
| @@ -491,12 +491,16 @@ | ||
| 491 | 491 | |
| 492 | 492 | * **`b`**: the path of the exported container, called the “bundle” in OCI |
| 493 | 493 | jargon |
| 494 | 494 | * **`c`**: the name of the Docker container you’re bundling up for use |
| 495 | 495 | with `runc` |
| 496 | -* **`m`**: the [moby] directory, both because it’s long and because it’s | |
| 497 | - been known to change from one version of Docker to the next | |
| 496 | +* **`m`**: the directory holding the running machines, configurable | |
| 497 | + because: | |
| 498 | + * it’s long | |
| 499 | + * it’s been known to change from one version of Docker to the next | |
| 500 | + * you might be using [Podman](#podman)/[`crun`](#crun), so it has | |
| 501 | + to be “`/run/user/$UID/crun`” instead | |
| 498 | 502 | * **`r`**: the path of the directory containing the bundle’s root file |
| 499 | 503 | system. |
| 500 | 504 | |
| 501 | 505 | That last doesn’t have to be called `rootfs/`, and it doesn’t have to |
| 502 | 506 | live in the same directory as `config.json`, but it is conventional. |
| @@ -636,19 +640,18 @@ | ||
| 636 | 640 | |
| 637 | 641 | I point that out because it might ask for your password twice: once for |
| 638 | 642 | the local sudo command, and once for the remote. |
| 639 | 643 | |
| 640 | 644 | The default for the **`b`** variable is the convention for systemd based |
| 641 | -machines, which will play into the [`nspawn`][sdnsp] alternative below. | |
| 645 | +machines, which will play into the [`nspawn` alternative below][sdnsp]. | |
| 642 | 646 | Even if you aren’t using `nspawn`, it’s a reasonable place to put |
| 643 | 647 | containers under the [Linux FHS rules][LFHS]. |
| 644 | 648 | |
| 645 | 649 | [ctrd]: https://containerd.io/ |
| 646 | 650 | [ecg]: https://github.com/opencontainers/runc/pull/3131 |
| 647 | 651 | [LFHS]: https://en.wikipedia.org/wiki/Filesystem_Hierarchy_Standard |
| 648 | 652 | [jq]: https://stedolan.github.io/jq/ |
| 649 | -[moby]: https://github.com/moby/moby | |
| 650 | 653 | [sdnsp]: #nspawn |
| 651 | 654 | [runc]: https://github.com/opencontainers/runc |
| 652 | 655 | |
| 653 | 656 | |
| 654 | 657 | ### <a id="podman"></a>Podman |
| 655 | 658 |
| --- www/containers.md | |
| +++ www/containers.md | |
| @@ -491,12 +491,16 @@ | |
| 491 | |
| 492 | * **`b`**: the path of the exported container, called the “bundle” in OCI |
| 493 | jargon |
| 494 | * **`c`**: the name of the Docker container you’re bundling up for use |
| 495 | with `runc` |
| 496 | * **`m`**: the [moby] directory, both because it’s long and because it’s |
| 497 | been known to change from one version of Docker to the next |
| 498 | * **`r`**: the path of the directory containing the bundle’s root file |
| 499 | system. |
| 500 | |
| 501 | That last doesn’t have to be called `rootfs/`, and it doesn’t have to |
| 502 | live in the same directory as `config.json`, but it is conventional. |
| @@ -636,19 +640,18 @@ | |
| 636 | |
| 637 | I point that out because it might ask for your password twice: once for |
| 638 | the local sudo command, and once for the remote. |
| 639 | |
| 640 | The default for the **`b`** variable is the convention for systemd based |
| 641 | machines, which will play into the [`nspawn`][sdnsp] alternative below. |
| 642 | Even if you aren’t using `nspawn`, it’s a reasonable place to put |
| 643 | containers under the [Linux FHS rules][LFHS]. |
| 644 | |
| 645 | [ctrd]: https://containerd.io/ |
| 646 | [ecg]: https://github.com/opencontainers/runc/pull/3131 |
| 647 | [LFHS]: https://en.wikipedia.org/wiki/Filesystem_Hierarchy_Standard |
| 648 | [jq]: https://stedolan.github.io/jq/ |
| 649 | [moby]: https://github.com/moby/moby |
| 650 | [sdnsp]: #nspawn |
| 651 | [runc]: https://github.com/opencontainers/runc |
| 652 | |
| 653 | |
| 654 | ### <a id="podman"></a>Podman |
| 655 |
| --- www/containers.md | |
| +++ www/containers.md | |
| @@ -491,12 +491,16 @@ | |
| 491 | |
| 492 | * **`b`**: the path of the exported container, called the “bundle” in OCI |
| 493 | jargon |
| 494 | * **`c`**: the name of the Docker container you’re bundling up for use |
| 495 | with `runc` |
| 496 | * **`m`**: the directory holding the running machines, configurable |
| 497 | because: |
| 498 | * it’s long |
| 499 | * it’s been known to change from one version of Docker to the next |
| 500 | * you might be using [Podman](#podman)/[`crun`](#crun), so it has |
| 501 | to be “`/run/user/$UID/crun`” instead |
| 502 | * **`r`**: the path of the directory containing the bundle’s root file |
| 503 | system. |
| 504 | |
| 505 | That last doesn’t have to be called `rootfs/`, and it doesn’t have to |
| 506 | live in the same directory as `config.json`, but it is conventional. |
| @@ -636,19 +640,18 @@ | |
| 640 | |
| 641 | I point that out because it might ask for your password twice: once for |
| 642 | the local sudo command, and once for the remote. |
| 643 | |
| 644 | The default for the **`b`** variable is the convention for systemd based |
| 645 | machines, which will play into the [`nspawn` alternative below][sdnsp]. |
| 646 | Even if you aren’t using `nspawn`, it’s a reasonable place to put |
| 647 | containers under the [Linux FHS rules][LFHS]. |
| 648 | |
| 649 | [ctrd]: https://containerd.io/ |
| 650 | [ecg]: https://github.com/opencontainers/runc/pull/3131 |
| 651 | [LFHS]: https://en.wikipedia.org/wiki/Filesystem_Hierarchy_Standard |
| 652 | [jq]: https://stedolan.github.io/jq/ |
| 653 | [sdnsp]: #nspawn |
| 654 | [runc]: https://github.com/opencontainers/runc |
| 655 | |
| 656 | |
| 657 | ### <a id="podman"></a>Podman |
| 658 |