Retropex/raspiblitz
1
0
Fork 0
mirror of https://github.com/Retropex/raspiblitz.git synced 2025-05-12 19:20:48 +02:00
Code Issues Actions Packages Projects Releases Wiki Activity

ci docs update (#3578)

Browse Source
This commit is contained in:
openoms 2023-01-18 12:26:38 +00:00 committed by GitHub
parent 55bdc7a512
commit 744dd45758
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 22 additions and 21 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

43
ci/README.md
View File

@ -17,8 +17,8 @@
- [fatpack image](#fatpack-image) - [fatpack image](#fatpack-image)
- [lean image](#lean-image) - [lean image](#lean-image)
- [Add Gnome desktop (optional)](#add-gnome-desktop-optional) - [Add Gnome desktop (optional)](#add-gnome-desktop-optional)
- [Add wifi](#add-wifi) - [Add wifi (optional)](#add-wifi-optional)
- [Add wifi driver (optional)](#add-wifi-driver-optional) - [Add wifi driver (optional)](#add-wifi-driver-optional)
- [Workflow notes](#workflow-notes) - [Workflow notes](#workflow-notes)
- [Packer .json settings:](#packer-json-settings) - [Packer .json settings:](#packer-json-settings)
- [VNC](#vnc) - [VNC](#vnc)
@ -56,32 +56,33 @@ with the [Makefile](https://github.com/rootzoll/raspiblitz/blob/dev/Makefile)
### Generate an amd64 image ### Generate an amd64 image
The workflow locally and in github actions generates a .qcow2 format amd64 image. The workflow locally and in github actions generates a .qcow2 format amd64 image.
* Tested with * Tested with
* libvirt / virsh / virt-manager (https://virt-manager.org/) * libvirt / virsh / virt-manager (https://virt-manager.org/)
* written to disk and booted with legacy boot (non-UEFI) * written to disk and booted with legacy boot (non-UEFI)
``` ```
make amd64-lean-image make amd64-lean-image
``` ```
* find the compressed .qcow2 image and sh256 hashes in the `ci/amd64/builds` directory * find the compressed .qcow2 image and sh256 hashes in the `ci/amd64/builds` directory
## Images generated in github actions ## Images generated in github actions
* Find the images in the green runs in github actions at: * To see the downloadable artifacts will need to log in to GitHub
https://github.com/rootzoll/raspiblitz/actions * Find the latest successful builds for amd64 using the dev branch at:
https://github.com/rootzoll/raspiblitz/actions/workflows/amd64-lean-image.yml?query=workflow%3Aamd64-lean-image-build+branch%3Adev+is%3Asuccess++
``` ```
# unzip to the same directory # unzip to the same directory
unzip raspiblitz-amd64-image-YEAR-MM-DD-COMMITHASH.zip unzip raspiblitz-amd64-image-YEAR-MM-DD-COMMITHASH.zip
``` ```
## Write the image to a disk connected with USB ## Write the image to a disk connected with USB
identify the connected disk with `lsblk` eg `/dev/sdd` * identify the connected disk with `lsblk` eg `/dev/sdd`
### Convert the qcow2 volume to a raw disk image ### Convert the qcow2 volume to a raw disk image
* the raw image is 33.5 GB * the raw image is 33.5 GB
``` ```
# unzip # unzip
gzip -dkv raspiblitz-amd64-debian-11.5-lean.qcow2.gz gzip -dkv raspiblitz-amd64-debian-11.5-lean.qcow2.gz
# convert # convert
qemu-img convert raspiblitz-amd64-debian-11.5-lean.qcow2 raspiblitz-amd64-debian-11.5-lean.img qemu-img convert raspiblitz-amd64-debian-11.5-lean.qcow2 raspiblitz-amd64-debian-11.5-lean.img
``` ```
### Write to a disk connected with USB with Balena Etcher or `dd` ### Write to a disk connected with USB with Balena Etcher or `dd`
* [Balena Etcher](https://www.balena.io/etcher/) to write the .img to disk * [Balena Etcher](https://www.balena.io/etcher/) to write the .img to disk
* dd to write the .img to disk * dd to write the .img to disk
@ -134,18 +135,18 @@ identify the connected disk with `lsblk` eg `/dev/sdd`
#### Add Gnome desktop (optional) #### Add Gnome desktop (optional)
* Connect to the internet (easiest to plug in a LAN cable - use a USB - LAN adapter if have no port) * Connect to the internet (easiest to plug in a LAN cable - use a USB - LAN adapter if have no port)
``` ```
apt install gnome apt install gnome
systemctl start gdm systemctl start gdm
``` ```
## Add wifi ### Add wifi (optional)
* if the wifi driver is included in the FOSS Debian distro * if the wifi driver is included in the FOSS Debian distro
* in the command line run the network manager interface to connect: * in the command line run the network manager interface to connect:
``` ```
sudo nmtui sudo nmtui
``` ```
## Add wifi driver (optional) ### Add wifi driver (optional)
* as in https://wiki.debian.org/iwlwifi * as in https://wiki.debian.org/iwlwifi
* add the component `non-free` after `deb http://deb.debian.org/debian bullseye main` in `/etc/apt/sources.list` * add the component `non-free` after `deb http://deb.debian.org/debian bullseye main` in `/etc/apt/sources.list`
* install the wifi driver for the mentioned cards: * install the wifi driver for the mentioned cards: