Adding instructions for Multipass
This commit is contained in:
parent
f9127baef6
commit
d050205ff6
3 changed files with 77 additions and 0 deletions
|
@ -75,6 +75,7 @@ There are also a number of tutorials in Spanish on [Vimeo](https://vimeo.com/use
|
|||
|
||||
## For Developers and Contributors
|
||||
* [Setting up a LibreTime instance with Vagrant](vagrant)
|
||||
* [Setting up a LibreTime instance with Multipass](multipass)
|
||||
* [Database access](database)
|
||||
* [Translating LibreTime](manual/interface-localization/index)
|
||||
|
||||
|
|
52
docs/multipass.md
Normal file
52
docs/multipass.md
Normal file
|
@ -0,0 +1,52 @@
|
|||
# Testing LibreTime with Canonical's Multipass
|
||||
|
||||
Ever wanted to test out LibreTime but didn't want to tango with
|
||||
Virturalbox, Vagrent, or Docker?
|
||||
|
||||

|
||||
|
||||
Canonical released [Multipass](https://multipass.run), a tool for setting up Ubuntu VMs with cloud-init files in a snap.
|
||||
Multipass is available for Windows and macOS, as well as Linux OSes that support snaps.
|
||||
|
||||
Similar to Docker, Multipass works through a CLI. To use, clone this repo and then open a Terminal
|
||||
(or Command Prompt) inside the `libretime` folder and run
|
||||
```
|
||||
multipass launch bionic -n ltTEST --cloud-init libretimeTest.yaml # to launch VM
|
||||
multipass shell ltTEST # to enter VM's shell
|
||||
```
|
||||
|
||||
And that's it! At the moment, Multipass isn't patient enough for an automated install,
|
||||
so after you enter the shell for the first time, you will still need to run the install script for LibreTime.
|
||||
|
||||
```
|
||||
sudo ./libretime/install -fiap
|
||||
|
||||
sudo service airtime-liquidsoap start
|
||||
sudo service airtime-playout start
|
||||
sudo service airtime-celery start
|
||||
sudo service airtime_analyzer start
|
||||
```
|
||||
|
||||
The IP address of your new VM can be found by running `multipass list`.
|
||||
Copy and paste it into your web browser to access the LibreTime interface.
|
||||
|
||||
You can stop the VM with `multipass stop ltTEST` and restart with `multipass start ltTEST`.
|
||||
If you want to delete the image and start again, run `multipass delete ltTEST && multipass purge`.
|
||||
|
||||
---
|
||||
### Cloud-init options in libretimeTest.yaml
|
||||
|
||||
You may wish to change the below fields as per your location.
|
||||
```
|
||||
timezone: America/New York # change as needed
|
||||
ntp:
|
||||
pools: ['north-america.pool.ntp.org']
|
||||
servers: ['0.north-america.pool.ntp.org', '0.pool.ntp.org']
|
||||
```
|
||||
|
||||
If you are running your forked repo of LibreTime for testing purposes,
|
||||
modify the URL on this line:
|
||||
```
|
||||
runcmd:
|
||||
- cd / && git clone https://github.com/LibreTime/libretime.git
|
||||
```
|
24
libretimeTest.yaml
Normal file
24
libretimeTest.yaml
Normal file
|
@ -0,0 +1,24 @@
|
|||
# Maintainer: Zachary Klosko (kloskoz@vcu.edu)
|
||||
|
||||
hostname: libretimeTest
|
||||
timezone: America/New York # change as needed
|
||||
ntp:
|
||||
pools: ['north-america.pool.ntp.org']
|
||||
servers: ['0.north-america.pool.ntp.org', '0.pool.ntp.org']
|
||||
|
||||
password: hackme
|
||||
chpasswd: { expire: False }
|
||||
|
||||
packages:
|
||||
- git
|
||||
apt_update: true
|
||||
apt_upgrade: true
|
||||
|
||||
|
||||
runcmd:
|
||||
- cd / && git clone https://github.com/LibreTime/libretime.git
|
||||
# - sudo ./install -fiap # not working yet, uncomment once Canonical fixes bugs in Multipass
|
||||
# - service airtime-liquidsoap start
|
||||
# - service airtime-playout start
|
||||
# - service airtime-celery start
|
||||
# - service airtime_analyzer start
|
Loading…
Add table
Add a link
Reference in a new issue