Added README.md

This commit is contained in:
B.J. Dweck 2020-10-12 00:12:36 +02:00
parent 29269cc031
commit 14aa70dd77

35
README.md Normal file
View File

@ -0,0 +1,35 @@
# TORch RPi Cloud Init Installer
This project aims to create an easy way to burn a RPi SD card with an [Ubuntu Server pre-installed image](https://ubuntu.com/download/raspberry-pi) with [Torch](/bj/torch-agent) installed and configured to broadcast it's connection info to you.
## Quick Start
Place your settings in `parameters.env`
```bash
cat <<EOF > parameters.env
DISABLE_IPV6=1
USERNAME=ubuntu
USERFULLNAME="Mr. Ubuntu"
SSH_PUBKEY="ssh-rsa AAAAB3NzaC1yc2EAAAABJQAAAQEAiOr5aUytobxxu6TG0CQqqyk3hOaaVyC8ZIt4Es9HGSDmKhBznrvMEJ5GyUIMB85+YLh0ohlVZJyrk8BWaIzoHD8IszKEJvpeYMRTGq8LVRe7YW1lFyJLFdTbLliKY0v1PvJmbrPiijHYjg8/l4gGEGlrg4XcnzdYtl9aHjfdc5nyVWkX1GYwDIP08slyt/gM8u7FIuYi1qyMxgjiEm4dcBECghlC8vN6TRBDW7ssald/jpNDUBOLYVQmGiW1KKI0mHxDFF1HoBAYYKtRz9Y4CdWXGTZ35/I50RhXHaI6hkIzfWiouBasnsMIYAvP1qhTW3EC9FlJVi2j16dN44awqw== rsa-key-20201012"
TORCH_CONFIG_DIR=~/.torch
EOF
```
* DISABLE_IPV6 - Disabled IPv6 on the RPi
* USERNAME - Created a user with the given username
* USERFULLNAME - Full name of the user to create
* SSH_PUBKEY - Pubkey to copy to the ~/.ssh directory for SSH access
* TORCH_CONFIG_DIR - Directory containing Torch [configuration](/bj/torch-agent) files
Run `build.sh`
```bash
./build.sh
```
Find the built configuration bundle in the `build` directory and extract it to the boot partition of the SD card after the Ubuntu server image has been burned
```bash
tar -xzvf build/rpi-cloud-init.tgz /mnt/rpi-boot/
```