From 8bfbce7fb4f2489425f6b66412fa6f2edeef6f01 Mon Sep 17 00:00:00 2001
From: Markson Hon <50002150+MarksonHon@users.noreply.github.com>
Date: Mon, 9 Dec 2024 20:28:35 +0800
Subject: [PATCH] docs(run-on-alpine.md): update for Alpine's kernel changes
 (#712)

Co-authored-by: Markson Hon <markson@localhost.local>
---
 docs/en/tutorials/run-on-alpine.md | 59 ++++++++++-------------
 docs/zh/tutorials/run-on-alpine.md | 76 ++++++++++++++++++++++++++++++
 2 files changed, 101 insertions(+), 34 deletions(-)
 create mode 100644 docs/zh/tutorials/run-on-alpine.md

diff --git a/docs/en/tutorials/run-on-alpine.md b/docs/en/tutorials/run-on-alpine.md
index c8acbb7..39c43b4 100644
--- a/docs/en/tutorials/run-on-alpine.md
+++ b/docs/en/tutorials/run-on-alpine.md
@@ -1,37 +1,28 @@
 # Run on Alpine Linux
 
-**Note**: Alpine Linux 3.18 or newer verison has full eBPF support out-of-box, older version of Alpine Linux need to build kernel by yourself.
+**Note:** 
+1. Alpine Linux 3.18 or newer verison has full eBPF support out-of-box, older version of Alpine Linux need to build kernel by yourself.
+2. From version 3.20, Alpine Linux has officially disabled some features dae needed beacuse of Alpine Linux's cross CPU architectures compatibility, so only `linux-virt` can be used to run dae defaultly. For `linux-lts` or `linux-edge`, you should build the kernel by yourself.
+3. This tutorial is for Alpine Linux 3.20 and newer.
 
 ## Enable Community Repo
 
-Edit apk's repositories config:
+Run `setup-apkrepos` command, then you'll get a menu list like this:
 
-```sh
-vi /etc/apk/repositories 
+```
+ (f)    Find and use fastest mirror
+ (s)    Show mirrorlist
+ (r)    Use random mirror
+ (e)    Edit /etc/apk/repositories with text editor
+ (c)    Community repo enable
+ (skip) Skip setting up apk repositories
 ```
 
-Then enable community repo, for example:
+Then input `c` to enable community repo.
 
-```ini
-https://dl-cdn.alpinelinux.org/alpine/edge/main
-https://dl-cdn.alpinelinux.org/alpine/edge/community
-```
+## Enable CGroups
 
-## Enable CGroup2
-
-Edit OpenRC's config file:
-
-```sh
-vi /etc/rc.conf
-```
-
-Then edit `rc_cgroup_mode`, defaultly it would be `#rc_cgroup_mode="hybrid"`, we should switch to `unified` to make sure CGroup2 in default.
-
-```ini
-rc_cgroup_mode="unified"
-```
-
-Then enable `cgroups` service:
+Enable `cgroups` service:
 
 ```sh
 rc-update add cgroups boot
@@ -48,17 +39,17 @@ vi /etc/init.d/sysfs
 Add the following to the `mount_misc` section:
 
 ```sh
-    # Setup Kernel Support for bpf file system
-    if [ -d /sys/fs/bpf ] && ! mountinfo -q /sys/fs/bpf; then
-        if grep -qs bpf /proc/filesystems; then
-            ebegin "Mounting eBPF filesystem"
-            mount -n -t bpf -o ${sysfs_opts} bpffs /sys/fs/bpf
-            eend $?
+        # Setup Kernel Support for bpf file system
+        if [ -d /sys/fs/bpf ] && ! mountinfo -q /sys/fs/bpf; then
+                if grep -qs bpf /proc/filesystems; then
+                ebegin "Mounting eBPF filesystem"
+                mount -n -t bpf -o ${sysfs_opts} bpffs /sys/fs/bpf
+                eend $?
+                fi
         fi
-    fi
 ```
 
-Be careful that the format of the script `/etc/init.d/sysfs` must be fine, or `sysfs` service will be failed.
+Be careful that the format of the script `/etc/init.d/sysfs` must be correct, or `sysfs` service will be failed.
 
 ## Install dae
 
@@ -70,13 +61,13 @@ This installer offered an OpenRC service script of dae, after installation, you
 chmod 640 /usr/local/etc/dae/config.dae
 ```
 
-If your config file is OK, then you can start dae service:
+If your config file is ready to work, then you can start dae service:
 
 ```sh
 rc-service dae start
 ```
 
-## Start at boot
+## Start dae at boot
 
 Use `rc-update` to enable dae service:
 
diff --git a/docs/zh/tutorials/run-on-alpine.md b/docs/zh/tutorials/run-on-alpine.md
new file mode 100644
index 0000000..5eee089
--- /dev/null
+++ b/docs/zh/tutorials/run-on-alpine.md
@@ -0,0 +1,76 @@
+# 在 Alpine Linux 上运行
+
+**注意：** 
+1. Alpine Linux 3.18 或更新版本已完全支持开箱即用的 eBPF，旧版本的 Alpine Linux 需要自己构建内核。
+2. 从 3.20 版开始，由于 Alpine Linux 的跨 CPU 架构兼容性问题，官方禁用了 dae 所需的一些功能，因此默认情况下只能使用 `linux-virt` 运行 dae。对于 `linux-lts` 或 `linux-edge`，你应该自己构建内核。
+3. 本教程适用于 Alpine Linux 3.20 及更新版本。
+
+## 启用 Community Repo
+
+运行 `setup-apkrepos` 命令，然后你会看到这样的菜单列表：
+
+```
+ (f)    Find and use fastest mirror
+ (s)    Show mirrorlist
+ (r)    Use random mirror
+ (e)    Edit /etc/apk/repositories with text editor
+ (c)    Community repo enable
+ (skip) Skip setting up apk repositories
+```
+
+然后输入 ``c` 启用社区仓库。
+
+## 启用 CGgroups
+
+启用 `cgroups` 服务：
+
+```sh
+rc-update add cgroups boot
+```
+
+## 挂载 bpf
+
+编辑 `/etc/init.d/sysfs`：
+
+```sh
+vi /etc/init.d/sysfs
+```
+
+在 `mount_misc` 部分添加以下内容：
+
+```sh
+        # Setup Kernel Support for bpf file system
+        if [ -d /sys/fs/bpf ] && ! mountinfo -q /sys/fs/bpf; then
+                if grep -qs bpf /proc/filesystems; then
+                ebegin "Mounting eBPF filesystem"
+                mount -n -t bpf -o ${sysfs_opts} bpffs /sys/fs/bpf
+                eend $?
+                fi
+        fi
+```
+
+请注意，脚本 `/etc/init.d/sysfs` 的格式必须正确，否则 `/etc/init.d/sysfs` 将被删除。
+
+## 安装 dae
+
+安装程序： <https://github.com/daeuniverse/dae-installer/>
+
+此安装程序提供了一个 dae 的 OpenRC 服务脚本，安装后，您需要在 `/usr/local/etc/dae/config.dae` 中添加一个配置文件，然后将其权限设置为 600 或 640：
+
+```sh
+chmod 640 /usr/local/etc/dae/config.dae
+```
+
+如果配置文件已准备就绪，那就可以启动 dae 服务了：
+
+```sh
+rc-service dae start
+```
+
+## 随系统启动
+
+使用 `rc-update` 启用 dae 服务：
+
+```sh
+rc-update add dae
+```
\ No newline at end of file