Merge pull request #1813 from AkihiroSuda/docs-update-examples

docs: examples: update

Author: AkihiroSuda

website/content/en/docs/Examples/_index.md

@@ -2,40 +2,82 @@
 title: Examples
 weight: 3
 ---
-## uname
-```console
-$ uname -a
-Darwin macbook.local 20.4.0 Darwin Kernel Version 20.4.0: Thu Apr 22 21:46:47 PDT 2021; root:xnu-7195.101.2~1/RELEASE_X86_64 x86_64
 
-$ lima uname -a
-Linux lima-default 5.11.0-16-generic #17-Ubuntu SMP Wed Apr 14 20:12:43 UTC 2021 x86_64 x86_64 x86_64 GNU/Linux
+## Running Linux commands
+```bash
+lima sudo apt-get install -y neofetch
+lima neofetch
+```
+
+## Accessing host files
+
+By default, the VM has read-only accesses to `/Users/<USERNAME>` and read-write accesses to `/tmp/lima`.
 
-$ LIMA_INSTANCE=arm lima uname -a
-Linux lima-arm 5.11.0-16-generic #17-Ubuntu SMP Wed Apr 14 20:10:16 UTC 2021 aarch64 aarch64 aarch64 GNU/Linux
+To allow writing to `/Users/<USERNAME>`:
+```bash
+limactl edit --mount-writable --mount-type=virtiofs
 ```
-{{% fixlinks %}}
-See [`./docs/multi-arch.md`](./docs/multi-arch.md) for Intel-on-ARM and ARM-on-Intel .
-{{% /fixlinks %}}
-## Sharing files across macOS and Linux
-```console
-$ echo "files under /Users on macOS filesystem are readable from Linux" > some-file
 
-$ lima cat some-file
-files under /Users on macOS filesystem are readable from Linux
+Specifying `--mount-type=virtiofs` is not necessary here, but it is highly recommended
+for the best performance and stability.
 
-$ lima sh -c 'echo "/tmp/lima is writable from both macOS and Linux" > /tmp/lima/another-file'
+## Running containers
+{{< tabpane text=true >}}
+
+{{% tab header="containerd" %}}
+```bash
+nerdctl.lima run -d --name nginx -p 127.0.0.1:8080:80 nginx:alpine
+```
+{{% /tab %}}
 
-$ cat /tmp/lima/another-file
-/tmp/lima is writable from both macOS and Linux
+{{% tab header="Docker" %}}
+```bash
+limactl start template://docker
+export DOCKER_HOST=$(limactl list docker --format 'unix://{{.Dir}}/sock/docker.sock')
+docker run -d --name nginx -p 127.0.0.1:8080:80 nginx:alpine
 ```
+{{% /tab %}}
 
-## Running containerd containers (compatible with Docker containers)
-```console
-$ lima nerdctl run -d --name nginx -p 127.0.0.1:8080:80 nginx:alpine
+{{% tab header="Kubernetes" %}}
+```bash
+limactl start template://k8s
+export KUBECONFIG=$(limactl list k8s --format 'unix://{{.Dir}}/copied-from-guest/kubeconfig.yaml')
+kubectl apply -f ...
 ```
+{{% /tab %}}
 
-> You don't need to run "lima nerdctl" everytime, instead you can use special shortcut called "nerdctl.lima" to do the same thing. By default, it'll be installed along with the lima, so, you don't need to do anything extra. There will be a symlink called nerdctl pointing to nerdctl.lima. This is only created when there is no nerdctl entry in the directory already though. It worths to mention that this is created only via make install. Not included in Homebrew/MacPorts/nix packages.
+{{< /tabpane >}}
 
-<http://127.0.0.1:8080> is accessible from both macOS and Linux.
+- <http://127.0.0.1:8080> is accessible from the host, as well as from the VM.
+
+- For the usage of containerd and nerdctl (contaiNERD ctl), visit <https://github.com/containerd/containerd>
+and <https://github.com/containerd/nerdctl>.
+
+- If you have installed Lima by `make install`, the `nerdctl.lima` command is also available as `nerdctl`.
+  If you have installed Lima by `brew install lima`, you may make an alias (or a symlink) by yourself:
+  `alias nerdctl=nerdctl.lima`
+
+## Advanced configuration
+
+```bash
+limactl start \
+  --name=default \
+  --cpus=4 \
+  --memory=8 \
+  --vm-type=vz \
+  --rosetta \
+  --mount-type=virtiofs \
+  --mount-writable \
+  --network=vzNAT \
+  template://fedora
+```
 
-For the usage of containerd and nerdctl (contaiNERD ctl), visit <https://github.com/containerd/containerd> and <https://github.com/containerd/nerdctl>.
+- `--name=default`: Set the instance name to "default"
+- `--cpus=4`: Set the number of the CPUs to 4
+- `--memory=8`: Set the amount of the memory to 8 GiB
+- `--vm-type=vz`: Use Apple's Virtualization.framework (vz) to enable Rosetta, virtiofs, and vzNAT
+- `--rosetta`: Allow running Intel (AMD) binaries on ARM
+- `--mount-type=virtiofs`: Use virtiofs for better performance
+- `--mount-writable`: Make the home mount (`/Users/<USERNAME>`) writable
+- `--network=vzNAT`: Make the VM reachable from the host by its IP address
+- `template://fedora`: Use Fedora