Merge pull request #24126 from jrglinux/master

翻译完成 20211215 Deploy Mycroft AI voice assistant on Raspberry Pi using Ansible.md
This commit is contained in:
Xingyu.Wang 2021-12-17 11:19:14 +08:00 committed by GitHub
commit bd5c3dd750
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 243 additions and 249 deletions

View File

@ -1,249 +0,0 @@
[#]: subject: "Deploy Mycroft AI voice assistant on Raspberry Pi using Ansible"
[#]: via: "https://opensource.com/article/21/12/mycroft-raspberry-pi-ansible"
[#]: author: "Gaëtan Trellu https://opensource.com/users/goldyfruit"
[#]: collector: "lujun9972"
[#]: translator: "jrglinux"
[#]: reviewer: " "
[#]: publisher: " "
[#]: url: " "
Deploy Mycroft AI voice assistant on Raspberry Pi using Ansible
======
Use these Ansible playbooks for an optimized Mycroft AI experience.
![Looking at a map][1]
Mycroft AI is a virtual assistant application that can respond to verbal requests and complete tasks such as searching the Internet for some information you need, or downloading your favorite podcast, and so on. It's a fine piece of open source software that, unlike similar software from companies in the business of harvesting personal data, provides privacy and platform flexibility.
Mycroft AI, written in Python, can install on many different hardware platforms. The famous Raspberry Pi board is a popular choice _(but not the only one)_ to run the voice assistant. Conveniently, Mycroft provides an image for Raspberry Pi, which is called [Picroft][2]. Picroft is an excellent solution, but it does have some limitations, such as the lack of 64-bit support.
### Raspberry Pi 4, the platform of choice and my target
The Raspberry Pi board is popular within the Mycroft community because it's inexpensive, has a lot of educational potential, and provides the possibility of interesting expansions thanks to Mycroft's skills and the Pi's easy access to General-Purpose Input/Output (GPIO) pins (for example, the [wake word LED GPIO skill][3]).
The model 4B has enough CPU power and memory to run Mycroft smoothly. I use the model 4B with 8GB of RAM, running Raspberry Pi OS Bullseye 64-bit Lite, which you can download from [RaspberryPi.org][4].
### Another automation story
Building your own Mycroft AI system does mean that you must pay attention to some details. According to my initial experience (from a year ago), here is a list of important technical details you must keep in mind:
* Audio output _(speaker configuration)_
* Audio input _(microphone configuration)_
* Microphone quality (_the actual hardware you buy_)
* Wake word response _("Hey Mycroft!")_
* Latency of response _("What's the weather like?")_
These aren't issues of Mycroft AI, they're just the things you must keep in mind while choosing your hardware and configuring your operating system. The Pi itself is capable of running Mycroft AI, but there are adjustments that require special configuration. Specifically, these are:
* CPU scheduler
* SD card performances
* PulseAudio configuration
* Network latency
I had to do a lot of research and manual actions to solve the headaches from the list above, but I did achieve the "ultimate" goal—the smoothest experience!
### Ansible to the rescue!
So now that I've created _the smoothest experience_, how do I ensure that every action done to achieve this goal gets captured and gets re-applied only if required on any Raspberry Pi 4 board?
[Ansible][5] to the rescue! Ansible is idempotent by design, which means that it applies the requested changes only if required. If everything is configured correctly, Ansible does not change a thing. This is the beauty of idempotency!
To achieve this ultimate goal, I use two Ansible roles:
* One to configure and tweak the Raspberry Pi
* One to install and configure Mycroft AI
#### Ansible prepi role
The [Ansible prepi role][6] applies some configurations to obtain better performances from a Raspberry Pi 4B board and prepare the path to Mycroft.
* Update Raspberry Pi OS to the latest version
* Add Debian backports repository
* Update firmware using the next branch, which provides kernel 5.15 and edge firmware
* Update EEPROM using the beta version, which provides edge features
* Setup initial_turbo to speed up the boot process
* Overclock the Raspberry Pi to 2Ghz
* Mount /tmp on a RAMDisk
* Optimize / partition mount options to improve SDcard read/write
* Manage I2C, SPI & UART interfaces
* Set CPU governor to performance to avoid context switching between the idle* kernel functions
* Install and configure PulseAudio _(non-system wide)_
* Reboot the Raspberry Pi when new firmware or EEPROM gets installed
#### Ansible mycroft role
This [Ansible mycroft role][7] installs and configures Mycroft AI Core from the GitHub repository based on the `dev_setup.sh` Bash script provided by the Mycroft core team.
* Python 3 virtual environment
* Systemd integration
* Extra skills installation
* Boto3, py_mplayer, and pyopenssl libraries install
* RAMDisk support for IPC
* File configuration support
* PulseAudio optimizations
* Secure Mycroft message bus websocket
I'll need an [Ansible playbook][8] to orchestrate the two roles.
### Personal requirements
Here is a list of requirements for this project:
* Raspberry Pi 4B board (or later) connected to your network
* [Raspberry Pi OS 64-bit][9]
* Ansible 2.9 (or later)
* SSH, up and running
To burn the Raspberry Pi OS image to the SD card, you can use [Etcher][10] or the imaging tool of your choice.
I overclock my Pi to get a boost in performance, but this can be dangerous to your hardware. Before using my Ansible playbooks, read them carefully! _You are responsible for the choices made with this role._ You decide which firmware, which EEPROM you want to use. The same rule applies to the overclocking feature. **Remember that overclocking requires a proper cooling system.**
### Execute the Ansible playbook
The first step is to retrieve the Ansible playbooks from GitHub. Use the following `git` command:
```
`$ git clone https://github.com/smartgic/ansible-playbooks-mycroft.git`
```
This repository contains an Ansible `requirements.yml` file which provides a list of Ansible roles required by this playbook, the roles must be retrieved from Ansible Galaxy.
```
$ cd ansible-playbooks-mycroft
$ ansible-galaxy install -r requirements.yml
Starting galaxy role install process
\- downloading role 'mycroft', owned by smartgic
\- downloading role from <https://github.com/smartgic/ansible-role-mycroft/archive/main.tar.gz>
\- extracting smartgic.mycroft to /home/goldyfruit/.ansible/roles/smartgic.mycroft
\- smartgic.mycroft (main) was installed successfully
\- downloading role 'prepi', owned by smartgic
\- downloading role from <https://github.com/smartgic/ansible-role-prepi/archive/main.tar.gz>
\- extracting smartgic.prepi to /home/goldyfruit/.ansible/roles/smartgic.prepi
\- smartgic.prepi (main) was installed successfully
```
The second step is to edit the Ansible inventory provided in the repository to reference the hosts I need to be managed by Ansible.
```
[rpi]
rpi4b01 ansible_host=192.168.1.97 ansible_user=pi
```
`[rpi]` is the group and should not be changed. This group has one host named `rpi4b01`, which has IP `192.168.1.97` and provides `pi` as Linux (default on Raspberry Pi OS) user for Ansible to connect with.
Now the tricky part: what value do you want for each option? It's up to you, but here's my go-to configuration:
```
# file: install-custom.yml
\- hosts: rpi
  gather_facts: yes
  become: yes
  pre_tasks:
    - name: Install Python 3.x Ansible requirement
      raw: apt-get install -y python3
      changed_when: no
      tags:
        - always
  vars:
    # PREPI
    prepi_pi_user: pi
    prepi_hostname: mylovelypi
    prepi_firmware_update: yes
    prepi_overclock: yes
    prepi_force_turbo: yes
    prepi_cpu_freq: 2000
    prepi_pulseaudio_daemon: yes
    # MYCROFT
    mycroft_branch: dev
    mycroft_user: "{{ prepi_pi_user }}"
    mycroft_skills_update_interval: 2.0
    mycroft_recording_timeout_with_silence: 3.0
    mycroft_enclosure_name: picroft
    mycroft_extra_skills:
      - <https://github.com/smartgic/mycroft-finished-booting-skill.git>
  tasks:
    - import_role:
        name: smartgic.prepi
    - import_role:
        name: smartgic.mycroft
```
The content needs to be saved in a file (for example, `install-custom.yml`).
And now the moment of truth: run your freshly created playbook.
```
`$ ansible-playbook -i inventory install-custom.yml -k`
```
The `-k` option from `ansible-playbook` command is only required if not using the SSH key. During the playbook execution, the Raspberry Pi could reboot a couple of times. The playbook is smart enough to handle this.
Once Ansible is done, you see a congratulatory message, which prompts you for the next steps you need to take.
![Congratulations message][11]
(Gaëtan Trellu, [CC BY-SA 4.0][12])
### Ansible makes custom Mycroft easy
These playbooks are the lessons I learned since starting my journey with Mycroft AI. It allows me to build, re-build, customize, and replicate my install with the peace of mind of having consistency everywhere!
Do you have any comments, questions, or concerns? Leave a comment, visit me on Twitter [@goldyfruit][13], or stop by [Mycroft channels][14].
--------------------------------------------------------------------------------
via: https://opensource.com/article/21/12/mycroft-raspberry-pi-ansible
作者:[Gaëtan Trellu][a]
选题:[lujun9972][b]
译者:[jrglinux](https://github.com/jrglinux)
校对:[校对者ID](https://github.com/校对者ID)
本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译,[Linux中国](https://linux.cn/) 荣誉推出
[a]: https://opensource.com/users/goldyfruit
[b]: https://github.com/lujun9972
[1]: https://opensource.com/sites/default/files/styles/image-full-size/public/lead-images/tips_map_guide_ebook_help_troubleshooting_lightbulb_520.png?itok=L0BQHgjr (Looking at a map)
[2]: https://mycroft-ai.gitbook.io/docs/using-mycroft-ai/get-mycroft/picroft
[3]: https://github.com/smartgic/mycroft-wakeword-led-gpio-skill
[4]: https://downloads.raspberrypi.org/raspios_lite_arm64/images/raspios_lite_arm64-2021-11-08/2021-10-30-raspios-bullseye-arm64-lite.zip
[5]: https://github.com/ansible/ansible
[6]: https://github.com/smartgic/ansible-role-prepi
[7]: https://github.com/smartgic/ansible-role-mycroft
[8]: https://github.com/smartgic/ansible-playbooks-mycroft
[9]: https://downloads.raspberrypi.org/raspios_arm64/images
[10]: https://opensource.com/article/18/7/getting-started-etcherio
[11]: https://opensource.com/sites/default/files/uploads/congratulations-message.png (Congratulations message)
[12]: https://creativecommons.org/licenses/by-sa/4.0/
[13]: https://twitter.com/goldyfruit
[14]: https://chat.mycroft.ai/community/channels/general

View File

@ -0,0 +1,243 @@
[#]: subject: "Deploy Mycroft AI voice assistant on Raspberry Pi using Ansible"
[#]: via: "https://opensource.com/article/21/12/mycroft-raspberry-pi-ansible"
[#]: author: "Gaëtan Trellu https://opensource.com/users/goldyfruit"
[#]: collector: "lujun9972"
[#]: translator: "jrglinux"
[#]: reviewer: " "
[#]: publisher: " "
[#]: url: " "
# 使用 Ansible 在树莓派上部署 Mycroft AI 语音助手
使用本文中的这些 `Ansible playbooks` 可以帮你获得更优的 `Mycroft AI` 体验。
![Looking at a map][1]
`Mycroft AI` 是一款虚拟助手应用程序,可以响应语音请求并完成相应的任务,比如在互联网上搜索你需要的某些信息,或者下载你喜欢的博客等等。这是一款优秀的开源软件,不同于那些收集个人数据业务的公司的同款软件,`Mycroft AI` 注重于保护隐私以及提供平台灵活性。
`Mycroft AI` 使用 `python` 开发,可以安装于不同的硬件平台上。家喻户晓的树莓派便是一个非常热门的运行语音助手的硬件方案(不过不是唯一的方案)。方便的是,`Mycroft` 为树莓派提供了 [`Picroft`][2] 镜像,虽然目前 `Picrof` 还有一些限制,比如不支持 `64` 位系统,不过不能阻止它成为一种优秀的解决方案。
### 树莓派4我选择的目标平台
树莓派在 `Mycroft` 社区中非常受欢迎,因为其性价比高,在教育行业中有着巨大的优势,并且由于 `Mycroft` 提供的便捷功能以及 `Pi` 本身易于访问的输入/输出(`GPIO`)引脚等,为树莓派提供了有趣扩展的可能性(比如,项目 [the wake word LED GPIO skill][3])。
树莓派`4B`具有足够的 `CPU` 算力以及内存来平稳运行 `Mycroft`。我使用的是 `8G` 内存的树莓派`4B`,运行 `Raspberry Pi OS Bullseye 64-bit` 系统,你可以从 [`RaspberryPi.org`][4] 网站下载该系统镜像文件。
### 另一个自动化故事
构建你自己的 `Mycroft AI` 系统,必须要注意一些细节问题。根据我的初步经验(一年前开始),以下罗列了一些重要的技术细节点:
* 音频输出(扬声器配置)
* 音频输入(麦克风配置)
* 麦克风质量(以购买的实际硬件为准)
* 唤醒词响应(比如打招呼 "嘿,`Mycroft`")
* 响应延迟(比如提问 "天气怎么样")
这些并不是`Mycroft AI` 的问题(译注:难道软件平台就没有处理延时问题?),它们只能是您在选择硬件和配置操作时必须牢记关心的事情。`Pi` 本身能够运行 `Mycroft AI`,但有一些配置需要额外的注意下:
* `CPU` 调度器
* `SD` 卡性能
* `PulseAudio` 配置
* 网络延迟
我做了大量的研究和实践来解决上面列出这些令人头疼的注意点,最终我实现了我的"终极"目标--最流畅的体验!
### Ansible 雪中送炭
我已经摸索出了最流畅的体验配置,但是如何确保在任何 `Raspberry Pi 4` 板子上都能不遗漏每一个设置细节然后达到重新部署这种流畅性体验的目标呢?
[`Ansible`][5] 能帮助你实现。`Ansible` 在设计上是幂等设计,这意味着它仅在需要时响应更改的请求。如果一切配置正确,`Ansible` 不会改变任何事情。这边是幂等设计的优美指出。
为了达到这一目的,我使用了两种 `Ansible` 场景角色工具:
* 一个用于配置和调整树莓派
* 一个用于安装和配置 `Mycroft AI`
### Ansible prepi 角色
[`Ansible prepi role`][6] 应用了一些配置,以便让树莓派 `4B` 发挥更佳的性能以及为安装 `Mycroft` 做前提准备。
* 更新 `Raspberry Pi OS` 至最新版本
* 添加 `Debian backports` 仓库
* 使用 `next` 分支更新固件,该分支支持 `5.15` 版本内核以及边缘固件
* 使用测试版本更新 `EEPROM`,该版本支持边缘功能
* 设置 `initial_turbo` 用来加速启动过程
* 将树莓派超频至 `2GHz`
* 在 `RAMDisck` 上挂载 `/tmp`
* 优化 `/` 分区挂载选项,提升 `SD` 卡读/写性能
* 管理 `I2C、SPI、UART` 接口
* 设置 `CPU` 控制器至避免在空间内核函数之间发生上下文切换的模式,以便提升性能
* 安装和配置 `PulseAduio`(非系统范围)
* 新固件或者 `EEPROM` 安装后重启树莓派
### Ansible mycroft 角色
[`Ansible mycroft role`][7] 基于脚本 `dev_setup.sh``Github` 仓库获取并安装和配置 `Mycroft AI`,该脚本是 `Mycroft` 核心团队提供。
* 需要准备 `Python3` 环境
* 系统集成环境
* 额外的安装技能
* 安装 `Boto3``py_mplayer`, `pyopenssl`
* 支持 `IPC``RAMDisck`
* 支持文件配置
* `PulseAudio` 优化
* 安全的 `Mycroft` 消息总线 `websocket`
我利用 [`Ansible playbook`][8] 来协调上面两个角色的使用。
### 个人配置需求
下面列举了一些个人配置的需求:
* 能上网的树莓派 `4B` 板子(或者更新的板子)
* [`Raspberry Pi OS 64-bit`][9]
* `Ansible 2.9`(或者更新版本)
* 可正常工作的 `SSH`
推荐使用[`Etcher`][10] 来烧录 `Raspberry Pi OS` 镜像至 `SD` 卡,你也可以使用你选择的镜像烧录工具。
我将 `Pi` 超频来提升性能,不过这可能对你的硬件是一种潜在危险。在使用我的 `Ansible playbooks` 配置之前,请先仔细阅读。你需要为你的每个配置选择负责。你将决定使用哪个固件、哪个 `EEPROM`。超频的话需要记得提供相应的冷却系统。
### 执行 Ansible playbook
第一步,使用命令从 `Github` 获取 `Ansible playbook`:
```shell
$ git clone https://github.com/smartgic/ansible-playbooks-mycroft.git
```
源码中,`requirements.yml` 文件中提供了 `playbook` 的依赖角色列表,必须从 `Ansible Galaxy` 中检索这些依赖。
```shell
$ cd ansible-playbooks-mycroft
$ ansible-galaxy install -r requirements.yml
Starting galaxy role install process
\- downloading role 'mycroft', owned by smartgic
\- downloading role from <https://github.com/smartgic/ansible-role-mycroft/archive/main.tar.gz>
\- extracting smartgic.mycroft to /home/goldyfruit/.ansible/roles/smartgic.mycroft
\- smartgic.mycroft (main) was installed successfully
\- downloading role 'prepi', owned by smartgic
\- downloading role from <https://github.com/smartgic/ansible-role-prepi/archive/main.tar.gz>
\- extracting smartgic.prepi to /home/goldyfruit/.ansible/roles/smartgic.prepi
\- smartgic.prepi (main) was installed successfully
```
第二步,编辑仓库中的 `Ansible inventory` ,设置需要管理的主机。
```shell
[rpi]
rpi4b01 ansible_host=192.168.1.97 ansible_user=pi
```
[`rpi`] 代表组,无需更改。该组有一个主机 `rpi4b01`, 其 `IP` 地址为 `192.168.1.97` 并创建 `pi` 作为 `Linux``Raspberry Pi OS`)上的默认用户。
现在比较棘手的部分到了:你希望每个选项怎么配置?这取决于你自己,下面是我的首选配置,供你参考:
```shell
# file: install-custom.yml
\- hosts: rpi
gather_facts: yes
become: yes
pre_tasks:
- name: Install Python 3.x Ansible requirement
raw: apt-get install -y python3
changed_when: no
tags:
- always
vars:
# PREPI
prepi_pi_user: pi
prepi_hostname: mylovelypi
prepi_firmware_update: yes
prepi_overclock: yes
prepi_force_turbo: yes
prepi_cpu_freq: 2000
prepi_pulseaudio_daemon: yes
# MYCROFT
mycroft_branch: dev
mycroft_user: "{{ prepi_pi_user }}"
mycroft_skills_update_interval: 2.0
mycroft_recording_timeout_with_silence: 3.0
mycroft_enclosure_name: picroft
mycroft_extra_skills:
- <https://github.com/smartgic/mycroft-finished-booting-skill.git>
tasks:
- import_role:
name: smartgic.prepi
- import_role:
name: smartgic.mycroft
```
上面的配置内容需要保存在文件里(比如,`install-custom.ym`)。
现在关键步骤:运行你新创建的`playbook`:
```shell
`$ ansible-playbook -i inventory install-custom.yml -k`
```
`-k` 选项只有在不需要`SSH key` 的时候才使用。在命令执行期间,树莓派可能会重启若干次。`playbook` 会自动处理这个问题,不必担心。
`Ansible` 配置完成后,你可以看到一条祝贺消息,提示你下一步需要做什么。
![Congratulations message][11]
(Gaëtan Trellu, [CC BY-SA 4.0][12])
### Ansible 让自定义 Mycroft 变得更容易
这些 `playbooks` 是我开始使用 `Mycroft AI` 后学到的经验教训。它们帮助我在任何一个地方都能构建、重构、自定义、拷贝我的安装并保持一致,这让我很省心!
读完此文,你有何意见、问题或疑虑?欢迎在 `Twitter`上 [`@goldyfruit`][13]上和我交流,或者访问 [`Mycroft channels`][14] 搜寻答案。
--------------------------------------------------------------------------------
via: https://opensource.com/article/21/12/mycroft-raspberry-pi-ansible
作者:[Gaëtan Trellu][a]
选题:[lujun9972][b]
译者:[jrglinux](https://github.com/jrglinux)
校对:[校对者ID](https://github.com/校对者ID)
本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译,[Linux中国](https://linux.cn/) 荣誉推出
[a]: https://opensource.com/users/goldyfruit
[b]: https://github.com/lujun9972
[1]: https://opensource.com/sites/default/files/styles/image-full-size/public/lead-images/tips_map_guide_ebook_help_troubleshooting_lightbulb_520.png?itok=L0BQHgjr "Looking at a map"
[2]: https://mycroft-ai.gitbook.io/docs/using-mycroft-ai/get-mycroft/picroft
[3]: https://github.com/smartgic/mycroft-wakeword-led-gpio-skill
[4]: https://downloads.raspberrypi.org/raspios_lite_arm64/images/raspios_lite_arm64-2021-11-08/2021-10-30-raspios-bullseye-arm64-lite.zip
[5]: https://github.com/ansible/ansible
[6]: https://github.com/smartgic/ansible-role-prepi
[7]: https://github.com/smartgic/ansible-role-mycroft
[8]: https://github.com/smartgic/ansible-playbooks-mycroft
[9]: https://downloads.raspberrypi.org/raspios_arm64/images
[10]: https://opensource.com/article/18/7/getting-started-etcherio
[11]: https://opensource.com/sites/default/files/uploads/congratulations-message.png "Congratulations message"
[12]: https://creativecommons.org/licenses/by-sa/4.0/
[13]: https://twitter.com/goldyfruit
[14]: https://chat.mycroft.ai/community/channels/general