From f252552cf222439d5c004a7e1e36a4cf24263f2c Mon Sep 17 00:00:00 2001 From: "Xingyu.Wang" Date: Mon, 24 Dec 2018 23:49:40 +0800 Subject: [PATCH 1/4] PRF:20181123 How to Build a Netboot Server, Part 1.md @qhwdw --- ...3 How to Build a Netboot Server, Part 1.md | 169 +++++++++--------- 1 file changed, 84 insertions(+), 85 deletions(-) diff --git a/translated/tech/20181123 How to Build a Netboot Server, Part 1.md b/translated/tech/20181123 How to Build a Netboot Server, Part 1.md index f2711ac3d1..1888f4ab2b 100644 --- a/translated/tech/20181123 How to Build a Netboot Server, Part 1.md +++ b/translated/tech/20181123 How to Build a Netboot Server, Part 1.md @@ -1,47 +1,51 @@ [#]: collector: (lujun9972) [#]: translator: (qhwdw) -[#]: reviewer: -[#]: publisher: +[#]: reviewer: (wxy) +[#]: publisher: ( ) [#]: subject: (How to Build a Netboot Server, Part 1) - [#]: via: (https://fedoramagazine.org/how-to-build-a-netboot-server-part-1/) [#]: author: (Gregory Bartholomew https://fedoramagazine.org/author/glb/) +[#]: url: ( ) -[#]: url: - -如何构建一台网络引导服务器（第一部分） -====== +如何构建一台网络引导服务器（一） +====== ![](https://fedoramagazine.org/wp-content/uploads/2018/11/build-netboot-816x345.jpg) -有些计算机网络需要在各个物理机器上维护相同的软件和配置。学校的计算机实验室就是这样的一个环境。一台 [网络引导][1] 服务器能够被配置为基于网络去提供一个完整的操作系统，以便于客户端计算机从一个中央位置获取配置。本教程将向你展示构建一台网络引导服务器的一种方法。 +有些计算机网络需要在各个物理机器上维护相同的软件和配置。学校的计算机实验室就是这样的一个环境。 [网络引导][1] 服务器能够被配置为基于网络去提供一个完整的操作系统，以便于客户端计算机从一个中央位置获取配置。本教程将向你展示构建一台网络引导服务器的一种方法。 -本教程的第一部分将包括创建一台网络引导服务器和镜像。第二部分将展示如何去添加 Kerberos 验证的 home 目录到网络引导配置中。 +本教程的第一部分将包括创建一台网络引导服务器和镜像。第二部分将展示如何去添加 Kerberos 验证的家目录到网络引导配置中。 ### 初始化配置 -首先去下载 Fedora 服务器的 [netinst][2] 镜像，将它刻录到一张光盘上，然后它将引导服务器去重新格式化。我们只需要一个典型的 Fedora Server 的“最小化安装”来作为我们的开端，安装完成后，我们可以使用命令行去添加我们需要的任何额外的包。 +首先去下载 Fedora 服务器的 [netinst][2] 镜像，将它刻录到一张光盘上，然后用它引导服务器来重新格式化。我们只需要一个典型的 Fedora Server 的“最小化安装”来作为我们的开端，安装完成后，我们可以使用命令行去添加我们需要的任何额外的包。 ![][3] > 注意：本教程中我们将使用 Fedora 28。其它版本在“最小化安装”中包含的包可能略有不同。如果你使用的是不同的 Fedora 版本，如果一个预期的文件或命令不可用，你可能需要做一些调试。 -最小化安装的 Fedora Server 运行起来之后，以 root 用户登入并设置主机名字： +最小化安装的 Fedora Server 运行起来之后，以 root 用户登入： -```javascript +``` +$ sudo -i +``` + +并设置主机名字： + +``` $ MY_HOSTNAME=server-01.example.edu $ hostnamectl set-hostname $MY_HOSTNAME ``` > 注意：Red Hat 建议静态和临时名字应都要与这个机器在 DNS 中的完全合格域名相匹配，比如 host.example.com（[了解主机名字][4]）。 > -> 注意：本指南为了你“复制粘贴”友好。需要自定义的任何值都声明为一个 MY_* 变量，在你运行剩余命令之前，你可能需要调整它。如果你注销之后，变量的赋值将被清除。 +> 注意：本指南为了方便“复制粘贴”。需要自定义的任何值都声明为一个 `MY_*` 变量，在你运行剩余命令之前，你可能需要调整它。如果你注销之后，变量的赋值将被清除。 > -> 注意：Fedora 28 Server 在默认情况下往往会转储大量的日志到控制台上。你可以通过运行命令：sysctl -w kernel.printk=0 去禁用控制台日志输出。 +> 注意：Fedora 28 Server 在默认情况下往往会转储大量的日志到控制台上。你可以通过运行命令：`sysctl -w kernel.printk=0` 去禁用控制台日志输出。 接下来，我们需要在我们的服务器上配置一个静态网络地址。运行下面的一系列命令将找到并重新配置你的默认网络连接： -```javascript +``` $ MY_DNS1=192.0.2.91 $ MY_DNS2=192.0.2.92 $ MY_IP=192.0.2.158 @@ -66,7 +70,7 @@ nmcli con up br0-slave0 END ``` -> 注意：上面最后的一组命令被封装到一个 “nohup” 脚本中，因为它将临时禁用网络。这个 nohup 命令将允许 nmcli 命令去完成运行，直到你的 SSH 连接断开。注意，连接恢复可能需要 10 秒左右的时间，如果你改变了服务器 IP 地址，你将需要重新启动一个新的 SSH 连接。 +> 注意：上面最后的一组命令被封装到一个 `nohup` 脚本中，因为它将临时禁用网络。这个 `nohup` 命令可以让 `nmcli` 命令运行完成，即使你的 SSH 连接断开。注意，连接恢复可能需要 10 秒左右的时间，如果你改变了服务器 IP 地址，你将需要重新启动一个新的 SSH 连接。 > > 注意：上面的网络配置在默认的连接之上创建了一个 [网桥][5]，这样我们在后面的测试中就可以直接运行一个虚拟机实例。如果你不想在这台服务器上去直接测试网络引导镜像，你可以跳过创建网桥的命令，并直接在你的默认网络连接上配置静态 IP 地址。 @@ -80,26 +84,26 @@ $ dnf install -y nfs-utils 为发布 NFS 去创建一个顶级的 [伪文件系统][6]，然后在你的网络上共享它： -```javascript +``` $ MY_SUBNET=192.0.2.0 $ mkdir /export $ echo "/export -fsid=0,ro,sec=sys,root_squash $MY_SUBNET/$MY_PREFIX" > /etc/exports ``` -SELinux 将干扰网络引导服务器的运行。在本教程中我们将不涉及为它配置例外的部分，因此我们直接禁用它： +SELinux 会干扰网络引导服务器的运行。为它配置例外规则超出了本教程中，因此我们这里直接禁用它： -```javascript +``` $ sed -i '/GRUB_CMDLINE_LINUX/s/"$/ audit=0 selinux=0"/' /etc/default/grub $ grub2-mkconfig -o /boot/grub2/grub.cfg $ sed -i 's/SELINUX=enforcing/SELINUX=disabled/' /etc/sysconfig/selinux $ setenforce 0 ``` -> 注意：编辑 grub 命令行应该是不需要的，但在测试过程中发现，简单地编辑 /etc/sysconfig/selinux 被证明重启后是无效的，因此再次确保设置了 “selinux=0” 标志。 +> 注意：应该不需要编辑 grub 命令行，但我们在测试过程中发现，直接编辑 `/etc/sysconfig/selinux` 被证明重启后是无效的，因此这样做再次确保设置了 `selinux=0` 标志。 -现在，在本地防火墙中为 NFS 服务添加一个例外，然后启动 NFS 服务： +现在，在本地防火墙中为 NFS 服务添加一个例外规则，然后启动 NFS 服务： -```javascript +``` $ firewall-cmd --add-service nfs $ firewall-cmd --runtime-to-permanent $ systemctl enable nfs-server.service @@ -116,76 +120,70 @@ $ systemctl start nfs-server.service $ mkdir /fc28 ``` -使用 “dnf” 命令在新目录下用几个基础包去构建镜像： +使用 `dnf` 命令在新目录下用几个基础包去构建镜像： -```javascript +``` $ dnf -y --releasever=28 --installroot=/fc28 install fedora-release systemd passwd rootfiles sudo dracut dracut-network nfs-utils vim-minimal dnf ``` -在上面的命令中省略了很重要的 “kernel” 包。在它们被安装完成之前，我们需要去调整一下 “initramfs” 镜像中包含的驱动程序集，“kernel” 首次安装时将自动构建这个镜像。尤其是，我们需要禁用 “hostonly” 模式，以便于 initramfs 镜像能够在各种硬件平台上正常工作，并且我们还需要添加对网络和 NFS 的支持： +在上面的命令中省略了很重要的 `kernel` 包。在它们被安装完成之前，我们需要去调整一下 `initramfs` 镜像中包含的驱动程序集，`kernel` 首次安装时将自动构建这个镜像。尤其是，我们需要禁用 `hostonly` 模式，以便于 `initramfs` 镜像能够在各种硬件平台上正常工作，并且我们还需要添加对网络和 NFS 的支持： -```javascript +``` $ echo 'hostonly=no' > /fc28/etc/dracut.conf.d/hostonly.conf $ echo 'add_dracutmodules+=" network nfs "' > /fc28/etc/dracut.conf.d/netboot.conf ``` -现在，安装 kernel： +现在，安装 `kernel` 包： -```javascript +``` $ dnf -y --installroot=/fc28 install kernel ``` -设置一个阻止 kernel 被更新的规则： +设置一个阻止 `kernel` 包被更新的规则： -```javascript +``` $ echo 'exclude=kernel-*' >> /fc28/etc/dnf/dnf.conf ``` 设置 locale： -```javascript +``` $ echo 'LANG="en_US.UTF-8"' > /fc28/etc/locale.conf ``` > 注意：如果 locale 没有正确配置，一些程序（如 GNOME Terminal）将无法正常工作。 -root 用户密码留空： - -```javascript -$ sed -i 's/^root:\*/root:/' /fc28/etc/shadow -``` - 设置客户端的主机名字： -```javascript +``` $ MY_CLIENT_HOSTNAME=client-01.example.edu $ echo $MY_CLIENT_HOSTNAME > /fc28/etc/hostname ``` 禁用控制台日志输出： -```javascript +``` $ echo 'kernel.printk = 0 4 1 7' > /fc28/etc/sysctl.d/00-printk.conf ``` -定义网络引导镜像中的本地 “liveuser” 用户： +定义网络引导镜像中的本地 `liveuser` 用户： -```javascript +``` $ echo 'liveuser:x:1000:1000::/home/liveuser:/bin/bash' >> /fc28/etc/passwd $ echo 'liveuser::::::::' >> /fc28/etc/shadow $ echo 'liveuser:x:1000:' >> /fc28/etc/group $ echo 'liveuser:!::' >> /fc28/etc/gshadow ``` -在 sudo 中启用 “liveuser”： +允许 `liveuser` 使用 `sudo`： -```javascript +``` $ echo 'liveuser ALL=(ALL) NOPASSWD: ALL' > /fc28/etc/sudoers.d/liveuser ``` -启用自动 home 目录创建： +启用自动创建家目录： -```livescript +``` $ dnf install -y --installroot=/fc28 authselect oddjob-mkhomedir $ echo 'dirs /home' > /fc28/etc/rwtab.d/home $ chroot /fc28 authselect select sssd with-mkhomedir --force @@ -194,19 +192,19 @@ $ chroot /fc28 systemctl enable oddjobd.service 由于多个客户端将会同时挂载我们的镜像，我们需要去配置镜像工作在只读模式中： -```livescript +``` $ sed -i 's/^READONLY=no$/READONLY=yes/' /fc28/etc/sysconfig/readonly-root ``` 配置日志输出到内存而不是持久存储中： -```livescript +``` $ sed -i 's/^#Storage=auto$/Storage=volatile/' /fc28/etc/systemd/journald.conf ``` 配置 DNS： -```livescript +``` $ MY_DNS1=192.0.2.91 $ MY_DNS2=192.0.2.92 $ cat << END > /fc28/etc/resolv.conf @@ -215,9 +213,9 @@ nameserver $MY_DNS2 END ``` -解决编写本教程时存在的只读 root 挂载 bug（[BZ1542567][7]）： +绕开编写本教程时存在的根目录只读挂载的 bug（[BZ1542567][7]）： -```livescript +``` $ echo 'dirs /var/lib/gssproxy' > /fc28/etc/rwtab.d/gssproxy $ cat << END > /fc28/etc/rwtab.d/systemd dirs /var/lib/systemd/catalog @@ -227,7 +225,7 @@ END 最后，为我们镜像创建 NFS 文件系统，并将它共享到我们的子网中： -```livescript +``` $ mkdir /export/fc28 $ echo '/fc28 /export/fc28 none bind 0 0' >> /etc/fstab $ mount /export/fc28 @@ -237,20 +235,20 @@ $ exportfs -vr ### 创建引导加载器 -现在，我们已经有了可以进行网络引导的操作系统，我们需要一个引导加载器去从客户端系统上启动它。在本教程中我们使用的是 [iPXE][8]. +现在，我们已经有了可以进行网络引导的操作系统，我们需要一个引导加载器去从客户端系统上启动它。在本教程中我们使用的是 [iPXE][8]。 -> 注意：本节和接下来的节 — 使用 QEMU 测试 — 能在另外一台单独的计算机上来完成；它们不需要在网络引导服务器上来运行。 +> 注意：本节和接下来的节使用 QEMU 测试，也能在另外一台单独的计算机上来完成；它们并不需要在网络引导服务器上来运行。 -安装 git 并使用它去下载 iPXE： +安装 `git` 并使用它去下载 iPXE： -```livescript +``` $ dnf install -y git $ git clone http://git.ipxe.org/ipxe.git $HOME/ipxe ``` 现在我们需要去为我们的引导加载器创建一个指定的启动脚本： -```livescript +``` $ cat << 'END' > $HOME/ipxe/init.ipxe #!ipxe @@ -264,19 +262,19 @@ END 启动 “file” 下载协议： -```livescript +``` $ echo '#define DOWNLOAD_PROTO_FILE' > $HOME/ipxe/src/config/local/general.h ``` 安装 C 编译器以及相关的工具和库： -```livescript +``` $ dnf groupinstall -y "C Development Tools and Libraries" ``` 构建引导加载器： -```livescript +``` $ cd $HOME/ipxe/src $ make clean $ make bin-x86_64-efi/ipxe.efi EMBED=../init.ipxe @@ -284,7 +282,7 @@ $ make bin-x86_64-efi/ipxe.efi EMBED=../init.ipxe 记下新编译的引导加载器的存储位置。我们将在接下来的节中用到它： -```livescript +``` $ IPXE_FILE="$HOME/ipxe/src/bin-x86_64-efi/ipxe.efi" ``` @@ -292,13 +290,13 @@ $ IPXE_FILE="$HOME/ipxe/src/bin-x86_64-efi/ipxe.efi" 这一节是可选的，但是你需要去复制下面显示在物理机器上的 [EFI 系统分区][9] 的布局，在网络引导时需要去配置它们。 -> 注意：如果你想实现一个完全的无盘系统，你也可以复制那个文件到一个 TFTP 服务器，然后从 DHCP 上引用那台服务器。 +> 注意：如果你想实现一个完全的无盘系统，你也可以复制那个文件到一个 TFTP 服务器，然后从 DHCP 上指向那台服务器。 为了使用 QEMU 去测试我们的引导加载器，我们继续去创建一个仅包含一个 EFI 系统分区和我们的启动文件的、很小的磁盘镜像。 从创建 EFI 系统分区所需要的目录布局开始，然后把我们在前面节中创建的引导加载器复制进去： -```livescript +``` $ mkdir -p $HOME/esp/efi/boot $ mkdir $HOME/esp/linux $ cp $IPXE_FILE $HOME/esp/efi/boot/bootx64.efi @@ -306,13 +304,13 @@ $ cp $IPXE_FILE $HOME/esp/efi/boot/bootx64.efi 下面的命令将识别我们的引导加载器镜像正在使用的内核版本，并将它保存到一个变量中，以备后续的配置命令去使用它： -```livescript +``` $ DEFAULT_VER=$(ls -c /fc28/lib/modules | head -n 1) ``` 定义我们的客户端计算机将使用的引导配置： -```livescript +``` $ MY_DNS1=192.0.2.91 $ MY_DNS2=192.0.2.92 $ MY_NFS4=server-01.example.edu @@ -329,14 +327,14 @@ END 复制 Linux 内核并分配 initramfs 给 EFI 系统分区： -```livescript +``` $ cp $(find /fc28/lib/modules -maxdepth 2 -name 'vmlinuz' | grep -m 1 $DEFAULT_VER) $HOME/esp/linux/vmlinuz-$DEFAULT_VER $ cp $(find /fc28/boot -name 'init*' | grep -m 1 $DEFAULT_VER) $HOME/esp/linux/initramfs-$DEFAULT_VER.img ``` 我们最终的目录布局应该看起来像下面的样子： -```livescript +``` esp ├── efi │   └── boot @@ -347,17 +345,17 @@ esp └── vmlinuz-4.18.18-200.fc28.x86_64 ``` -使用 QEMU 去使用我们的 EFI 系统分区，我们需要去创建一个小的 “uefi.img” 磁盘镜像来包含它，然后将它连接到 QEMU 作为主引导驱动器。 +要让 QEMU 去使用我们的 EFI 系统分区，我们需要去创建一个小的 `uefi.img` 磁盘镜像来包含它，然后将它连接到 QEMU 作为主引导驱动器。 开始安装必需的工具： -```livescript +``` $ dnf install -y parted dosfstools ``` -现在创建 “uefi.img” 文件，并将 “esp” 目录中文件复制进去： +现在创建 `uefi.img` 文件，并将 `esp` 目录中的文件复制进去： -```livescript +``` $ ESP_SIZE=$(du -ks $HOME/esp | cut -f 1) $ dd if=/dev/zero of=$HOME/uefi.img count=$((${ESP_SIZE}+5000)) bs=1KiB $ UEFI_DEV=$(losetup --show -f $HOME/uefi.img) @@ -370,54 +368,55 @@ $ umount $HOME/mnt $ losetup -d ${UEFI_DEV} ``` -> 注意：在物理计算机上，你只需要从 “esp” 目录中复制文件到计算机上已存在的 EFI 系统分区中。你不需要使用 “uefi.img” 文件去引导物理计算机。 +> 注意：在物理计算机上，你只需要从 `esp` 目录中复制文件到计算机上已存在的 EFI 系统分区中。你不需要使用 `uefi.img` 文件去引导物理计算机。 > -> 注意：在一个物理计算机上，如果文件名已存在，你可以重命名 “bootx64.efi” 文件，如果你重命名了它，就需要去编辑计算机的 BIOS 设置，并添加重命令后的 efi 文件到引导列表中。 +> 注意：在一个物理计算机上，如果文件名已存在，你可以重命名 `bootx64.efi` 文件，如果你重命名了它，就需要去编辑计算机的 BIOS 设置，并添加重命令后的 efi 文件到引导列表中。 接下来我们需要去安装 qemu 包： -```livescript +``` $ dnf install -y qemu-system-x86 ``` 允许 QEMU 访问我们在本教程“初始化配置”一节中创建的网桥： -```livescript +``` $ echo 'allow br0' > /etc/qemu/bridge.conf ``` -创建一个 “OVMF_VARS.fd” 镜像的副本去保存我们虚拟机的持久 BIOS 配置： +创建一个 `OVMF_VARS.fd` 镜像的副本去保存我们虚拟机的持久 BIOS 配置： -```livescript +``` $ cp /usr/share/edk2/ovmf/OVMF_VARS.fd $HOME ``` 现在，启动虚拟机： -```livescript +``` $ qemu-system-x86_64 -machine accel=kvm -nographic -m 1024 -drive if=pflash,format=raw,unit=0,file=/usr/share/edk2/ovmf/OVMF_CODE.fd,readonly=on -drive if=pflash,format=raw,unit=1,file=$HOME/OVMF_VARS.fd -drive if=ide,format=raw,file=$HOME/uefi.img -net bridge,br=br0 -net nic,model=virtio ``` 如果一切顺利，你将看到类似下图所示的结果： ![][10] -你可以使用 “shutdown” 命令关闭虚拟机回到我们的服务器上： -```livescript +你可以使用 `shutdown` 命令关闭虚拟机回到我们的服务器上： + +``` $ sudo shutdown -h now ``` -> 注意：如果出现了错误或虚拟机挂住了，你可能需要启动一个新的 SSH 会话去连接服务器，使用 “kill” 命令去终止 “qemu-system-x86_64” 进程。 +> 注意：如果出现了错误或虚拟机挂住了，你可能需要启动一个新的 SSH 会话去连接服务器，使用 `kill` 命令去终止 `qemu-system-x86_64` 进程。 ### 镜像中添加包 -镜像中添加包应该是一个很简单的问题，在服务器上 chroot 进镜像，然后运行 “dnf install ”。 +镜像中添加包应该是一个很简单的问题，在服务器上 `chroot` 进镜像，然后运行 `dnf install `。 在网络引导镜像中并不限制你能安装什么包。一个完整的图形化安装应该能够完美地工作。 下面是一个如何将最小化安装的网络引导镜像变成完整的图形化安装的示例： -```livescript +``` $ for i in dev dev/pts dev/shm proc sys run; do mount -o bind /$i /fc28/$i; done $ chroot /fc28 /usr/bin/bash --login $ dnf -y groupinstall "Fedora Workstation" @@ -430,9 +429,9 @@ $ logout $ for i in run sys proc dev/shm dev/pts dev; do umount /fc28/$i; done ``` -可选，你可能希望去启用 “liveuser” 用户的自动登陆： +可选地，你可能希望去启用 `liveuser` 用户的自动登录： -```livescript +``` $ sed -i '/daemon/a AutomaticLoginEnable=true' /fc28/etc/gdm/custom.conf $ sed -i '/daemon/a AutomaticLogin=liveuser' /fc28/etc/gdm/custom.conf ``` @@ -444,7 +443,7 @@ via: https://fedoramagazine.org/how-to-build-a-netboot-server-part-1/ 作者：[Gregory Bartholomew][a] 选题：[lujun9972][b] 译者：[qhwdw](https://github.com/qhwdw) -校对：[校对者ID](https://github.com/校对者ID) +校对：[wxy](https://github.com/wxy) 本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出 From 7af8488185a01b1db58102d771e956ea6111ee55 Mon Sep 17 00:00:00 2001 From: "Xingyu.Wang" Date: Mon, 24 Dec 2018 23:50:47 +0800 Subject: [PATCH 2/4] PUB:20181123 How to Build a Netboot Server, Part 1.md @qhwdw https://linux.cn/article-10379-1.html --- .../20181123 How to Build a Netboot Server, Part 1.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) rename {translated/tech => published}/20181123 How to Build a Netboot Server, Part 1.md (99%) diff --git a/translated/tech/20181123 How to Build a Netboot Server, Part 1.md b/published/20181123 How to Build a Netboot Server, Part 1.md similarity index 99% rename from translated/tech/20181123 How to Build a Netboot Server, Part 1.md rename to published/20181123 How to Build a Netboot Server, Part 1.md index 1888f4ab2b..ac64617de8 100644 --- a/translated/tech/20181123 How to Build a Netboot Server, Part 1.md +++ b/published/20181123 How to Build a Netboot Server, Part 1.md @@ -1,11 +1,11 @@ [#]: collector: (lujun9972) [#]: translator: (qhwdw) [#]: reviewer: (wxy) -[#]: publisher: ( ) +[#]: publisher: (wxy) [#]: subject: (How to Build a Netboot Server, Part 1) [#]: via: (https://fedoramagazine.org/how-to-build-a-netboot-server-part-1/) [#]: author: (Gregory Bartholomew https://fedoramagazine.org/author/glb/) -[#]: url: ( ) +[#]: url: (https://linux.cn/article-10379-1.html) 如何构建一台网络引导服务器（一） ====== From 0a6c32e789f12bfc6c40d519657a2d228eee6f02 Mon Sep 17 00:00:00 2001 From: "Xingyu.Wang" Date: Tue, 25 Dec 2018 00:28:46 +0800 Subject: [PATCH 3/4] PRF:20180912 How to turn on an LED with Fedora IoT.md @ScarboroughCoral --- ...2 How to turn on an LED with Fedora IoT.md | 87 ++++++++----------- 1 file changed, 36 insertions(+), 51 deletions(-) diff --git a/translated/tech/20180912 How to turn on an LED with Fedora IoT.md b/translated/tech/20180912 How to turn on an LED with Fedora IoT.md index 59bbc1280b..f72d8cb0bc 100644 --- a/translated/tech/20180912 How to turn on an LED with Fedora IoT.md +++ b/translated/tech/20180912 How to turn on an LED with Fedora IoT.md @@ -1,116 +1,105 @@ -# 如何使用 Fedora IoT 开启 LED 灯 +如何使用 Fedora IoT 点亮 LED 灯 +====== ![](https://fedoramagazine.org/wp-content/uploads/2018/08/LED-IoT-816x345.jpg) -你喜欢 Fedora、容器和树莓派吗？这三者结合操控 LED 会怎么样？本文介绍的是 Fedora IoT，将展示如何在树莓派上安装预览镜像。还将学习如何与 GPIO 交互以开启 LED。 +如果你喜欢 Fedora、容器，而且有一块树莓派，那么这三者结合操控 LED 会怎么样？本文介绍的是 Fedora IoT，将展示如何在树莓派上安装预览镜像。还将学习如何与 GPIO 交互以点亮 LED。 ### 什么是 Fedora IoT? -Fedora IoT 是当前 Fedora 项目的目标之一，计划成为一个完整的 Fedora 版本。Fedora IoT 将是一个在ARM（目前仅限 aarch64）例如树莓派，以及 x86_64 架构设备上运行的系统。 +Fedora IoT 是当前 Fedora 项目的目标之一，计划成为一个完整的 Fedora 版本。Fedora IoT 将是一个在 ARM（目前仅限 aarch64）设备上（例如树莓派），以及 x86_64 架构上运行的系统。 ![][1] -Fedora IoT 基于 OSTree 开发, 就像[Fedora Silverblue][2] 和以往的 [Atomic Host][3]. +Fedora IoT 基于 OSTree 开发，就像 [Fedora Silverblue][2] 和以往的 [Atomic Host][3]。 ### 下载和安装 Fedora IoT -官方 Fedora IoT 镜像将和 Fedora 29 一起发布。但是在此期间你可以下载 [Fedora 28-based 镜像][4] 来进行这个实验。 +官方 Fedora IoT 镜像将和 Fedora 29 一起发布。但是在此期间你可以下载 [基于 Fedora 28 的镜像][4] 来进行这个实验。（LCTT 译注：截止至本译文发布，[Fedora 29 已经发布了][11]，但是 IoT 版本并未随同发布，或许会在 Fedora 30 一同发布？） -你有两种方法来安装这个系统：使用 dd 命令闪存SD卡，或者使用 fedora-arm-installer 工具。Fedora 的 Wiki 里面提供了更多关于[设置物理设备][5] 的信息来开发 IoT。另外，你可能需要调整第三个分区的大小。 +你有两种方法来安装这个系统：要么使用 `dd` 命令烧录 SD 卡，或者使用 `fedora-arm-installer` 工具。Fedora 的 Wiki 里面提供了为 IoT [设置物理设备][5] 的更多信息。另外，你可能需要调整第三个分区的大小。 -把 SD 卡插入到设备并运行，需要创建一个用户来完成安装。这个步骤需要串行连接或带键盘的 HDMI 显示器来与设备进行交互。 +把 SD 卡插入到设备后，你需要创建一个用户来完成安装。这个步骤需要串行连接或一个 HDMI 显示器和键盘来与设备进行交互。 当系统安装完成后，下一步就是要设置网络连接。使用你刚才创建的用户登录系统，可以使用下列方式之一完成网络连接设置： -- 如果你需要手动配置你的网络，可能需要执行类似如下命令，需要保证设置正确的网络地址： +* 如果你需要手动配置你的网络，可能需要执行类似如下命令，需要保证设置正确的网络地址： -``` + ``` $ nmcli connection add con-name cable ipv4.addresses \ 192.168.0.10/24 ipv4.gateway 192.168.0.1 \ connection.autoconnect true ipv4.dns "8.8.8.8,1.1.1.1" \ type ethernet ifname eth0 ipv4.method manual - ``` -- 如果你网络上运行着 DHCP 服务，可能需要类似如下命令： +* 如果你网络上运行着 DHCP 服务，可能需要类似如下命令： -``` + ``` $ nmcli con add type ethernet con-name cable ifname eth0 ``` - - -### **Fedora 中的 GPIO 接口** +### Fedora 中的 GPIO 接口 许多关于 Linux 上 GPIO 的教程都关注传统的 GPIO sysfis 接口。这个接口已经不推荐使用了，并且上游 Linux 内核社区由于安全和其他问题的缘故打算完全删除它。 -Fedora 已经不将这个传统的接口编译到内核了，因此在系统上没有 /sys/class/gpio 这个文件。此教程使用一个上游内核提供的一个新的字符设备 /dev/gpiochipN 。这是目前和 GPIO 交互的方式。 +Fedora 已经不将这个传统的接口编译到内核了，因此在系统上没有 `/sys/class/gpio` 这个文件。此教程使用一个上游内核提供的一个新的字符设备 `/dev/gpiochipN` 。这是目前和 GPIO 交互的方式。 -为了和这个新设备进行交互，你需要使用一个库和一系列命令行界面工具。公共命令行工具比如说 echo 和 cat 在此设备上无法正常工作。 +为了和这个新设备进行交互，你需要使用一个库和一系列命令行界面的工具。常用的命令行工具比如说 `echo` 和 `cat` 在此设备上无法正常工作。 你可以通过安装 libgpiod-utils 包来安装命令行界面工具。python3-libgpiod 包提供了相应的 Python 库。 -### **使用 Podman 来创建一个容器** +### 使用 Podman 来创建一个容器 -[Podman][6] 是一个容器运行环境，其命令行界面类似于Docker。Podman的一大优势是它不会在后台运行任何守护进程。这对于资源有限的设备尤其有用。Podman 还允许您使用 systemd 单元文件启动容器化服务。此外，它还有许多其他功能。 +[Podman][6] 是一个容器运行环境，其命令行界面类似于 Docker。Podman 的一大优势是它不会在后台运行任何守护进程。这对于资源有限的设备尤其有用。Podman 还允许您使用 systemd 单元文件启动容器化服务。此外，它还有许多其他功能。 我们使用如下两步来创建一个容器： -``` 1. 创建包含所需包的分层镜像。 2. 使用分层镜像创建一个新容器。 -``` - - -首先创建一个 Dockerfile 文件，内容如下。这些内容告诉 podman 基于可使用的最新 Fedora 镜像来构建我们的分层镜像。然后就是更新系统和安装一些软件包： +首先创建一个 Dockerfile 文件，内容如下。这些内容告诉 Podman 基于可使用的最新 Fedora 镜像来构建我们的分层镜像。然后就是更新系统和安装一些软件包： ``` FROM fedora:latest RUN dnf -y update RUN dnf -y install libgpiod-utils python3-libgpiod - ``` 这样你就完成了镜像的生成前的配置工作，这个镜像基于最新的 Fedora，而且包含了和 GPIO 交互的软件包。 -现在你就可以运行下方命令来构建你的基本镜像了： +现在你就可以运行如下命令来构建你的基本镜像了： ``` $ sudo podman build --tag fedora:gpiobase -f ./Dockerfile - ``` 你已经成功创建了你的自定义镜像。这样以后你就可以不用每次都重新搭建环境了，而是基于你创建的镜像来完成工作。 ### 使用 Podman 完成工作 -为了确认当前的镜像，可以运行下方命令： +为了确认当前的镜像是否就绪，可以运行如下命令： ``` $ sudo podman images REPOSITORY TAG IMAGE ID CREATED SIZE localhost/fedora gpiobase 67a2b2b93b4b 10 minutes ago 488MB docker.io/library/fedora latest c18042d7fac6 2 days ago 300MB - ``` -现在，启动容器并进行一些实际的实验。 容器通常是隔离的，无法访问主机系统，包括GPIO接口。 因此需要在启动容器时将其挂载在容器内。 可以使用以下命令中的 -device 选项来解决： +现在，启动容器并进行一些实际的实验。容器通常是隔离的，无法访问主机系统，包括 GPIO 接口。因此需要在启动容器时将其挂载在容器内。可以使用以下命令中的 `-device` 选项来解决： ``` $ sudo podman run -it --name gpioexperiment --device=/dev/gpiochip0 localhost/fedora:gpiobase /bin/bash - ``` -运行之后就进入了正在运行的容器中。 在继续之前，这里有一些容器命令。 输入 exit 或者按下 **Ctrl+D** 来退出容器。 +运行之后就进入了正在运行的容器中。在继续之前，这里有一些容器命令。输入 `exit` 或者按下 `Ctrl+D` 来退出容器。 -显示所有存在的容器可以运行如下命令： +显示所有存在的容器可以运行如下命令，这包括当前没有运行的，比如你刚刚创建的那个： ``` $ sudo podman container ls -a CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 64e661d5d4e8 localhost/fedora:gpiobase /bin/bash 37 seconds ago Exited (0) Less than a second ago gpioexperiment - ``` 使用如下命令创建一个新的容器： @@ -127,55 +116,50 @@ $ sudo podman rm newexperiment ``` -### **开启 LED 灯** +### 点亮 LED 灯 -现在可以使用已创建的容器。 如果容器已经退出，请使用以下命令再次启动它： +现在可以使用已创建的容器。如果已经从容器退出，请使用以下命令再次启动它： ``` $ sudo podman start -ia gpioexperiment - ``` -如前所述，可以使用 Fedora 中 libgpiod-utils 包提供的 CLI 工具。 要列出可用的 GPIO 芯片可以使用如下命令： +如前所述，可以使用 Fedora 中 libgpiod-utils 包提供的命令行工具。要列出可用的 GPIO 芯片可以使用如下命令： ``` $ gpiodetect gpiochip0 [pinctrl-bcm2835] (54 lines) - ``` -要获取特定芯片的公开列表，请运行： +要获取特定芯片的连线列表，请运行： ``` $ gpioinfo gpiochip0 - ``` -请注意，物理引脚数与前一个命令打印的行数之间没有相关性。 重要的是 BCM 编号，如 [pinout.xyz][7] 所示。 建议不要使用没有相应 BCM 编号的线路。 +请注意，物理引脚数与前一个命令所打印的连线数之间没有相关性。重要的是 BCM 编号，如 [pinout.xyz][7] 所示。建议不要使用没有相应 BCM 编号的连线。 -现在，将 LED 连接到物理引脚40，也就是 BCM 21。请记住：LED的短腿（负极，称为阴极）必须连接到带有330欧姆电阻的树莓派的 GND 引脚， 并且长腿（阳极）到物理引脚40。 +现在，将 LED 连接到物理引脚 40，也就是 BCM 21。请记住：LED 的短腿（负极，称为阴极）必须连接到带有 330 欧姆电阻的树莓派的 GND 引脚， 并且长腿（阳极）到物理引脚 40。 -运行以下命令打开LED。，按下 **Ctrl + C ** 关闭： +运行以下命令点亮 LED，按下 `Ctrl + C` 关闭： ``` $ gpioset --mode=wait gpiochip0 21=1 - ``` -要点亮一段时间，请添加 -b（在后台运行）和 -s NUM（多少秒）参数，如下所示。 例如，要点亮 LED 5秒钟，运行如下命令： +要点亮一段时间，请添加 `-b`（在后台运行）和 `-s NUM`（多少秒）参数，如下所示。 例如，要点亮 LED 5 秒钟，运行如下命令： ``` $ gpioset -b -s 5 --mode=time gpiochip0 21=1 - ``` -另一个有用的命令是 gpioget。 它可以获得引脚的状态（高或低），可用于检测按钮和开关。 +另一个有用的命令是 `gpioget`。 它可以获得引脚的状态（高或低），可用于检测按钮和开关。 ![Closeup of LED connection with GPIO][8] -### **总结** +### 总结 -你也可以使用 Python 操控 LED - [这里有一些例子][9]。 也可以在容器内使用 i2c 设备。 此外，Podman 与此 Fedora 版本并不严格相关。 你可以在任何现有的 Fedora Edition 上安装它，或者在 Fedora 中使用两个基于 OSTree 的新系统进行尝试：[Fedora Silverblue][2] 和 [Fedora CoreOS][10]。 +你也可以使用 Python 操控 LED —— [这里有一些例子][9]。 也可以在容器内使用 i2c 设备。 此外，Podman 与此 Fedora 版本并不严格相关。你可以在任何现有的 Fedora 版本上安装它，或者在 Fedora 中使用两个基于 OSTree 的新系统进行尝试：[Fedora Silverblue][2] 和 [Fedora CoreOS][10]。 ------ @@ -184,7 +168,7 @@ via: https://fedoramagazine.org/turnon-led-fedora-iot/ 作者：[Alessio Ciregia][a] 选题：[lujun9972](https://github.com/lujun9972) 译者：[ScarboroughCoral](https://github.com/ScarboroughCoral) -校对：[校对者ID](https://github.com/校对者ID) +校对：[wxy](https://github.com/wxy) 本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出 @@ -199,3 +183,4 @@ via: https://fedoramagazine.org/turnon-led-fedora-iot/ [8]: https://fedoramagazine.org/wp-content/uploads/2018/08/breadboard-1024x768.png [9]: https://github.com/brgl/libgpiod/tree/master/bindings/python/examples [10]: https://coreos.fedoraproject.org/ +[11]: https://fedoramagazine.org/announcing-fedora-29/ From 0b47390027f6c47b7aaeb9eda119c43a61515d79 Mon Sep 17 00:00:00 2001 From: "Xingyu.Wang" Date: Tue, 25 Dec 2018 00:29:13 +0800 Subject: [PATCH 4/4] PUB:20180912 How to turn on an LED with Fedora IoT.md @ScarboroughCoral https://linux.cn/article-10380-1.html --- .../20180912 How to turn on an LED with Fedora IoT.md | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename {translated/tech => published}/20180912 How to turn on an LED with Fedora IoT.md (100%) diff --git a/translated/tech/20180912 How to turn on an LED with Fedora IoT.md b/published/20180912 How to turn on an LED with Fedora IoT.md similarity index 100% rename from translated/tech/20180912 How to turn on an LED with Fedora IoT.md rename to published/20180912 How to turn on an LED with Fedora IoT.md