highperfocused/raspiblitz
1
0
Fork 0
mirror of https://github.com/raspiblitz/raspiblitz.git synced 2025-03-17 21:31:45 +01:00
Code Issues Packages Projects Releases Wiki Activity

update build manual

Browse Source
This commit is contained in:
rootzoll 2023-05-04 15:58:42 +02:00
parent 34f91f1730
commit b3b9ba4722
1 changed files with 42 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

50
FAQ.dev.md
View File

@ -2,9 +2,13 @@
### What is the process of creating a new SD card image release?
Work notes for the process of producing a new SD card image release:
Checklist before making a SD card image release:
* "Versioning" number is upfates in your RaspiBlitz Source Code (_version.info)
* Latest code is merged in release branch
Creating the base minimal sd card:
* Make sure you have the "Versioning" final in your RaspiBlitz Source Code
* Start [`Ubuntu LIVE`](http://releases.ubuntu.com/18.04.3/ubuntu-18.04.3-desktop-amd64.iso) from USB stick
* Under Settings: best to set correct keyboard language & power settings to prevent monitor turn off
* Connect to a secure WiFi (hardware switch on) or LAN
@ -33,6 +37,9 @@ Work notes for the process of producing a new SD card image release:
* Login new with `ssh admin@[IP-OF-RASPIBLITZ]` (pw: raspiblitz) and run `release`
* Disconnect WiFi/LAN on build laptop (hardware switch off) and shutdown
* Remove `Ubuntu LIVE` USB stick and cut power from the RaspberryPi
Creating the image of sd card:
* Connect USB stick with latest `TAILS` (make it stay offline)
* Boot Tails with extra setting of Admin-Passwort and remember (use later for sudo)
* Menu > Systemtools > Settings > Energy -> best to set monitor to never turn off
@ -43,18 +50,45 @@ Work notes for the process of producing a new SD card image release:
* Take the SD card from the RaspberryPi and connect with an external SD card reader to the laptop
* Click on `boot` volume once in the file manger
* Connect the NTFS USB stick, open in file manager and delete old files
* To make a raw image from sd card - second way (UI with progress):
* Search "Laufwerke" or "Drives" on Tails Apps
* Create image named `raspiblitz.img` to USB storage
* Open Terminal and cd into directory of NTFS USB stick under `/media/amnesia`
* `shasum -a 256 ./pishrink.sh` should be `e46e1e1e3c6e3555f9fff5435e2305e99b98aaa8dc28db1814cf861fbb472a69`
* `chmod +x ./pishrink.sh | sudo ./pishrink.sh ./raspiblitz.img`
* `gzip -c ./raspiblitz.img > ./raspiblitz-vX.X-YEAR-MONTH-DAY.img.gz`
* Then run `shasum -a 256 *.gz > sha256.txt`
* Sign with `gpg --output raspiblitz-vX.X-YEAR-MONTH-DAY.img.gz.sig --detach-sign *.gz`
* Shutdown build computer
* `gzip -c ./raspiblitz.img > ./raspiblitz-min/fat-vX.X.X-YEAR-MONTH-DAY.img.gz`
* `shasum -a 256 ./raspiblitz-min/fat-vX.X.X-YEAR-MONTH-DAY.img.gz > ./raspiblitz-min/fat-vX.X.X-YEAR-MONTH-DAY.img.gz.sha`
* make analog copy/note of checksum
* Sign with `gpg --output raspiblitz-min/fat-vX.X.X-YEAR-MONTH-DAY.img.gz.sig --detach-sign raspiblitz-min/fat-vX.X.X-YEAR-MONTH-DAY.img.gz`
Prepare template for subversion update later:
* `mv ./raspiblitz.img ./raspiblitz-min-vX.X.X.img`
* `shasum -a 256 ./raspiblitz-min-vX.X.img > ./raspiblitz-min-vX.X.X.img.sha`
* make analog copy/note of checksum
Creating a fatpack sd card from the minimal image:
* Start TAILS live image
* On NTFS USB Stick (Open in Terminal) check hash of raspiblitz-min-vX.X.X.img wit analog note:
* `shasum -a 256 ./raspiblitz-min-vX.X.X.img`
* Right-Click the file and write to a min 32GB sd card
* On `bootfs` in FileManger (Open in Terminal):
* `touch stop` & `exit` terminal
* Shutdown TAILS & eject sd card
* Bootup UBUNTU LIVE
* Connect a RaspiBlitz (without HDD) to network, insert sd card and power up
* Find the IP of the RaspiBlitz (arp -a or check router)
* In terminal `ssh admin@[IP-OF-RASPIBLITZ]`
* Update to latest code with `patch code`
* the following only if its a `fatpack`:
* run command `fatpack`
* if it reboot, ssh in again & again run command `fatpack`
* check that script ended without errors
* do the creation & signing of the image file like in chapter above
Publishing the images:
* Connect the NTFS USB stick to MacOS (it is just read-only)
* Run tests on the new image
* Upload the new image to the Download Server - put sig-file next to it