|
4 년 전 | |
---|---|---|
boards | 4 년 전 | |
deps | 4 년 전 | |
presigned | 4 년 전 | |
.gitignore | 4 년 전 | |
Makefile | 4 년 전 | |
README.md | 4 년 전 | |
build-tool.js | 4 년 전 | |
conf-tool.sh | 4 년 전 | |
definition.yaml | 5 년 전 | |
dev.cloud-init.yaml | 4 년 전 | |
json2yaml.js | 4 년 전 | |
package.json | 4 년 전 |
README.md
ppl-os
Files required to build the ubuntu core based pplOS
WORK IN PROGRESS
Everything subject to change, including number of bugs (hopefully to zero ;)
Building
System Requirements
- A linux distro that is either ubuntu based or has support for running lxd containers and snapd
- At least 1GB free disk space
Other Requirements
- Ubuntu One account (create at https://login.ubuntu.com/+login)
- (Optional) Snapcraft signing key (tutorial https://tutorials.ubuntu.com/tutorial/create-your-own-core-image#3)
- Any of the supported boards or at least 4GB RAM free for virtualization
Build environment setup on debian
First you need to add the nodeJS PPA, unless you already installed node v10+ on your system by other means: $ curl https://deb.nodesource.com/setup_10.x | sudo bash -
Now install the necesarry packages: $ sudo apt-get install -y nodejs ubuntu-image snapcraft snapd nodejs
If you also want to test using a virtual device you should install qemu-kvm
, too: $ sudo apt-get install -y qemu-kvm
It is recommended that you build on Ubuntu, as building on other distributions might require the usage of containers. You may want to setup lxd at this point.
Now you need to install the npm dependencies using npm i
Build configuration
It is required that you are signed into your Ubuntu One account on the local snapd instance
If not already done run snap login
to do so
If you're building on a non-ubuntu distro you need to have lxd installed and setup for snap building to work
You can now go ahead and run bash conf-tool.sh
If you're planning to test using the virtual device you can leave eveything as-is, otherwise the defaults might not be suited for your use case.
Creating the image
To build a board's model file run make BOARD.model
To build an image for a specific board run make BOARD.img
The board tag for the virtual device is amd64
Running the virtual device
Use make start
to build the amd64.img and launch it with kvm
If you used the defaults in the configuration step, you should now be able to connect with make ssh
Could not access KVM kernel module: Permission denied
Is your user in the kvm group? Try sudo addgroup $(whoami) kvm
and reboot.