Fossil SCM
A few more small tweaks to the containers doc
Commit
117cf4ffe8ec6bf43853d2416df5052d8b365f82ca594f4561d6f903e71b601d
Parent
bb189d17f248aa3…
1 file changed
+10
-10
+10
-10
| --- www/containers.md | ||
| +++ www/containers.md | ||
| @@ -399,11 +399,11 @@ | ||
| 399 | 399 | |
| 400 | 400 | ### 5.3 <a id="cengine"></a>Container Engine |
| 401 | 401 | |
| 402 | 402 | Although the Fossil container build system defaults to Docker, we allow |
| 403 | 403 | for use of any OCI container system that implements the same interfaces. |
| 404 | -We go into more details about this in [the next section](#light), but | |
| 404 | +We go into more details about this [below](#light), but | |
| 405 | 405 | for now, it suffices to point out that you can switch to Podman while |
| 406 | 406 | using our `Makefile` convenience targets unchanged by saying: |
| 407 | 407 | |
| 408 | 408 | ``` |
| 409 | 409 | $ make CENGINE=podman container-run |
| @@ -420,11 +420,11 @@ | ||
| 420 | 420 | $ make container-image \ |
| 421 | 421 | DBFLAGS='--build-arg FSLCFG="--json --with-th1-docs"' |
| 422 | 422 | ``` |
| 423 | 423 | |
| 424 | 424 | If you also wanted [the Tcl evaluation extension](./th1.md#tclEval), |
| 425 | -that brings us to [the next section](#run). | |
| 425 | +that brings us to [the next point](#run). | |
| 426 | 426 | |
| 427 | 427 | |
| 428 | 428 | ### 5.5 <a id="run"></a>Elaborating the Run Layer |
| 429 | 429 | |
| 430 | 430 | If you want a basic shell environment for temporary debugging of the |
| @@ -435,11 +435,11 @@ | ||
| 435 | 435 | |
| 436 | 436 | …to this: |
| 437 | 437 | |
| 438 | 438 | FROM busybox AS run |
| 439 | 439 | |
| 440 | -Rebuild, redeploy, and your Fossil container will have a [BusyBox]-based | |
| 440 | +Rebuild and redeploy to give your Fossil container a [BusyBox]-based | |
| 441 | 441 | shell environment that you can get into via: |
| 442 | 442 | |
| 443 | 443 | $ docker exec -it -u fossil $(make container-version) sh |
| 444 | 444 | |
| 445 | 445 | (That command assumes you built it via “`make container`” and are |
| @@ -628,12 +628,12 @@ | ||
| 628 | 628 | [runc]: https://github.com/opencontainers/runc |
| 629 | 629 | |
| 630 | 630 | |
| 631 | 631 | ### 6.2 <a id="podman"></a>Podman |
| 632 | 632 | |
| 633 | -A lighter-weight [rootless] [drop-in replacement][whatis] that doesn’t | |
| 634 | -give up the image builder is [Podman]. Initially created by | |
| 633 | +A lighter-weight [rootless][rl] [drop-in replacement][whatis] that | |
| 634 | +doesn’t give up the image builder is [Podman]. Initially created by | |
| 635 | 635 | Red Hat and thus popular on that family of OSes, it will run on |
| 636 | 636 | any flavor of Linux. It can even be made to run [on macOS via Homebrew][pmmac] |
| 637 | 637 | or [on Windows via WSL2][pmwin]. |
| 638 | 638 | |
| 639 | 639 | On Ubuntu 22.04, the installation size is about 38 MiB, roughly a |
| @@ -668,15 +668,15 @@ | ||
| 668 | 668 | --publish 127.0.0.1:9999:8080 \ |
| 669 | 669 | localhost/fossil |
| 670 | 670 | $ podman start fossil |
| 671 | 671 | ``` |
| 672 | 672 | |
| 673 | -[pmmac]: https://podman.io/getting-started/installation.html#macos | |
| 674 | -[pmwin]: https://github.com/containers/podman/blob/main/docs/tutorials/podman-for-windows.md | |
| 675 | -[Podman]: https://podman.io/ | |
| 676 | -[rootless]: https://github.com/containers/podman/blob/main/docs/tutorials/rootless_tutorial.md | |
| 677 | -[whatis]: https://podman.io/whatis.html | |
| 673 | +[pmmac]: https://podman.io/getting-started/installation.html#macos | |
| 674 | +[pmwin]: https://github.com/containers/podman/blob/main/docs/tutorials/podman-for-windows.md | |
| 675 | +[Podman]: https://podman.io/ | |
| 676 | +[rl]: https://github.com/containers/podman/blob/main/docs/tutorials/rootless_tutorial.md | |
| 677 | +[whatis]: https://podman.io/whatis.html | |
| 678 | 678 | |
| 679 | 679 | |
| 680 | 680 | ### 6.3 <a id="nspawn"></a>`systemd-container` |
| 681 | 681 | |
| 682 | 682 | If even the Podman stack is too big for you, the next-best option I’m |
| 683 | 683 |
| --- www/containers.md | |
| +++ www/containers.md | |
| @@ -399,11 +399,11 @@ | |
| 399 | |
| 400 | ### 5.3 <a id="cengine"></a>Container Engine |
| 401 | |
| 402 | Although the Fossil container build system defaults to Docker, we allow |
| 403 | for use of any OCI container system that implements the same interfaces. |
| 404 | We go into more details about this in [the next section](#light), but |
| 405 | for now, it suffices to point out that you can switch to Podman while |
| 406 | using our `Makefile` convenience targets unchanged by saying: |
| 407 | |
| 408 | ``` |
| 409 | $ make CENGINE=podman container-run |
| @@ -420,11 +420,11 @@ | |
| 420 | $ make container-image \ |
| 421 | DBFLAGS='--build-arg FSLCFG="--json --with-th1-docs"' |
| 422 | ``` |
| 423 | |
| 424 | If you also wanted [the Tcl evaluation extension](./th1.md#tclEval), |
| 425 | that brings us to [the next section](#run). |
| 426 | |
| 427 | |
| 428 | ### 5.5 <a id="run"></a>Elaborating the Run Layer |
| 429 | |
| 430 | If you want a basic shell environment for temporary debugging of the |
| @@ -435,11 +435,11 @@ | |
| 435 | |
| 436 | …to this: |
| 437 | |
| 438 | FROM busybox AS run |
| 439 | |
| 440 | Rebuild, redeploy, and your Fossil container will have a [BusyBox]-based |
| 441 | shell environment that you can get into via: |
| 442 | |
| 443 | $ docker exec -it -u fossil $(make container-version) sh |
| 444 | |
| 445 | (That command assumes you built it via “`make container`” and are |
| @@ -628,12 +628,12 @@ | |
| 628 | [runc]: https://github.com/opencontainers/runc |
| 629 | |
| 630 | |
| 631 | ### 6.2 <a id="podman"></a>Podman |
| 632 | |
| 633 | A lighter-weight [rootless] [drop-in replacement][whatis] that doesn’t |
| 634 | give up the image builder is [Podman]. Initially created by |
| 635 | Red Hat and thus popular on that family of OSes, it will run on |
| 636 | any flavor of Linux. It can even be made to run [on macOS via Homebrew][pmmac] |
| 637 | or [on Windows via WSL2][pmwin]. |
| 638 | |
| 639 | On Ubuntu 22.04, the installation size is about 38 MiB, roughly a |
| @@ -668,15 +668,15 @@ | |
| 668 | --publish 127.0.0.1:9999:8080 \ |
| 669 | localhost/fossil |
| 670 | $ podman start fossil |
| 671 | ``` |
| 672 | |
| 673 | [pmmac]: https://podman.io/getting-started/installation.html#macos |
| 674 | [pmwin]: https://github.com/containers/podman/blob/main/docs/tutorials/podman-for-windows.md |
| 675 | [Podman]: https://podman.io/ |
| 676 | [rootless]: https://github.com/containers/podman/blob/main/docs/tutorials/rootless_tutorial.md |
| 677 | [whatis]: https://podman.io/whatis.html |
| 678 | |
| 679 | |
| 680 | ### 6.3 <a id="nspawn"></a>`systemd-container` |
| 681 | |
| 682 | If even the Podman stack is too big for you, the next-best option I’m |
| 683 |
| --- www/containers.md | |
| +++ www/containers.md | |
| @@ -399,11 +399,11 @@ | |
| 399 | |
| 400 | ### 5.3 <a id="cengine"></a>Container Engine |
| 401 | |
| 402 | Although the Fossil container build system defaults to Docker, we allow |
| 403 | for use of any OCI container system that implements the same interfaces. |
| 404 | We go into more details about this [below](#light), but |
| 405 | for now, it suffices to point out that you can switch to Podman while |
| 406 | using our `Makefile` convenience targets unchanged by saying: |
| 407 | |
| 408 | ``` |
| 409 | $ make CENGINE=podman container-run |
| @@ -420,11 +420,11 @@ | |
| 420 | $ make container-image \ |
| 421 | DBFLAGS='--build-arg FSLCFG="--json --with-th1-docs"' |
| 422 | ``` |
| 423 | |
| 424 | If you also wanted [the Tcl evaluation extension](./th1.md#tclEval), |
| 425 | that brings us to [the next point](#run). |
| 426 | |
| 427 | |
| 428 | ### 5.5 <a id="run"></a>Elaborating the Run Layer |
| 429 | |
| 430 | If you want a basic shell environment for temporary debugging of the |
| @@ -435,11 +435,11 @@ | |
| 435 | |
| 436 | …to this: |
| 437 | |
| 438 | FROM busybox AS run |
| 439 | |
| 440 | Rebuild and redeploy to give your Fossil container a [BusyBox]-based |
| 441 | shell environment that you can get into via: |
| 442 | |
| 443 | $ docker exec -it -u fossil $(make container-version) sh |
| 444 | |
| 445 | (That command assumes you built it via “`make container`” and are |
| @@ -628,12 +628,12 @@ | |
| 628 | [runc]: https://github.com/opencontainers/runc |
| 629 | |
| 630 | |
| 631 | ### 6.2 <a id="podman"></a>Podman |
| 632 | |
| 633 | A lighter-weight [rootless][rl] [drop-in replacement][whatis] that |
| 634 | doesn’t give up the image builder is [Podman]. Initially created by |
| 635 | Red Hat and thus popular on that family of OSes, it will run on |
| 636 | any flavor of Linux. It can even be made to run [on macOS via Homebrew][pmmac] |
| 637 | or [on Windows via WSL2][pmwin]. |
| 638 | |
| 639 | On Ubuntu 22.04, the installation size is about 38 MiB, roughly a |
| @@ -668,15 +668,15 @@ | |
| 668 | --publish 127.0.0.1:9999:8080 \ |
| 669 | localhost/fossil |
| 670 | $ podman start fossil |
| 671 | ``` |
| 672 | |
| 673 | [pmmac]: https://podman.io/getting-started/installation.html#macos |
| 674 | [pmwin]: https://github.com/containers/podman/blob/main/docs/tutorials/podman-for-windows.md |
| 675 | [Podman]: https://podman.io/ |
| 676 | [rl]: https://github.com/containers/podman/blob/main/docs/tutorials/rootless_tutorial.md |
| 677 | [whatis]: https://podman.io/whatis.html |
| 678 | |
| 679 | |
| 680 | ### 6.3 <a id="nspawn"></a>`systemd-container` |
| 681 | |
| 682 | If even the Podman stack is too big for you, the next-best option I’m |
| 683 |