PI-CI 项目使用教程

PI-CI 项目使用教程

pi-ci Prepare Raspberry Pi 3, 4 & 5 configurations using a virtual machine. 项目地址: https://gitcode.com/gh_mirrors/pi/pi-ci

1. 项目介绍

PI-CI 项目是一个开源项目，旨在帮助开发者轻松准备和烧录 Raspberry Pi（树莓派）配置。该项目通过 Docker 镜像的方式提供了一个 Raspberry Pi 模拟器，使得开发者可以在虚拟机中运行、配置和导出树莓派镜像。

2. 项目快速启动

首先，确保你的系统已经安装了 Docker。以下是将 PI-CI 项目运行起来的基本步骤：

# 拉取 PI-CI 镜像
docker pull ptrsr/pi-ci

# 运行 PI-CI 容器
docker run --rm -it ptrsr/pi-ci

运行容器后，你将进入到一个模拟的 Raspberry Pi 环境。

启动虚拟机

docker run --rm -it ptrsr/pi-ci start

持久化存储

为了保存更改后的镜像，可以使用卷挂载：

docker run --rm -it -v $PWD/dist:/dist ptrsr/pi-ci start

SSH 访问

要启用 SSH 访问，需要在运行容器时暴露端口 2222：

docker run --rm -p 2222:2222 ptrsr/pi-ci start

然后使用 SSH 连接到虚拟的 Pi：

ssh root@localhost -p 2222

调整镜像大小

默认镜像大小为 2GB，可以通过以下命令调整大小：

docker run --rm -it -v $PWD/dist:/dist --device=/dev/mmcblk0 ptrsr/pi-ci resize /dev/mmcblk0

烧录镜像到存储设备

docker run --rm -it -v $PWD/dist:/dist --device=/dev/mmcblk0 ptrsr/pi-ci flash /dev/mmcblk0

导出镜像

docker run --rm -it -v $PWD/dist:/dist ptrsr/pi-ci export --input /dist/image.qcow2 --output /dist/image.img

3. 应用案例和最佳实践

• 预配置树莓派服务器：通过 PI-CI，开发者可以创建从首次启动即工作的树莓派服务器配置。
• 使用 Ansible 创建可重现的服务器配置：自动化配置流程，确保每次部署的一致性。
• 通过 CI 管道自动分发配置：自动化持续集成和持续部署流程。
• 在虚拟环境中测试 ARM 应用：在不具备物理树莓派的情况下进行应用测试。

4. 典型生态项目

PI-CI 项目的生态中包括但不限于以下项目：

• Ansible：自动化配置管理工具。
• Docker：容器化平台，用于创建和运行 PI-CI 容器。
• Balena Etcher：用于烧录镜像到 SD 卡的工具。

请确保在操作过程中定期备份镜像，并在安全和配置方面遵循最佳实践。

pi-ci Prepare Raspberry Pi 3, 4 & 5 configurations using a virtual machine. 项目地址: https://gitcode.com/gh_mirrors/pi/pi-ci