Skip to content
Vagrant enviroment for TWLight
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
backup
bin
docs
puppet
.gitignore
README.md
Vagrantfile

README.md

twlight_vagrant

Overview

Deploys and configures the Library Card Platform for The Wikipedia Library in a vagrant environment.

Audience

Those developing Library Card Platform for The Wikipedia Library.

Requirements

Optional

Notes for Linux users:

For a "just works" experience, I recommend fetching Vagrant and VirtualBox packages from the vendor websites rather than using your distribution's software repositories. Those likely include fairly old versions of the required packages, and you will find yourself having to carefully managing your Vagrant, VirtualBox, and base box updates to avoid breakage, if it's not broken out of the gate.

Notes for Windows users:

Some third-party endpoint security software, such as Dell Data Protection Encryption and several McAfee products, interfere with VirtualBox. You may need to temporarily disable these products or make different endpoint protection choices.

You'll need to add the following directory to your PATH environment variable after installing VirtualBox:

C:\Program Files\Oracle\VirtualBox

See this example from Microsoft for adding a path to the PATH environment variable.

Vagrant's (early but generally working) support for Ubuntu via the Windows Subsystem for Linux is the recommended way to run this enviroment. You should be on Windows 10 Version 1709 or later and perform a store-based Ubuntu installation. See the Vagrant and Windows Subsystem for Linux instructions. You'll install VirtualBox on the Windows side, and then install exactly the same build of Vagrant in both Windows and Ubuntu. The Linux notes apply to the Ubuntu environment. Just download a fixed version of Vagrant (that matches the version you install in Windows) and install using dpkg as described in the instructions. Install any plugins in Ubuntu.

On Vagrant 2.0.2 and earlier, issue #9298 means you'll need to create a symlink in the location of the deprecated lxrun installation that points to the new store-based installation. As pointed out in the reported issue, running the following powershell commands on the windows side will pull the information from the registry and create the appropriate symlink.

$WSLREGKEY="HKCU:\Software\Microsoft\Windows\CurrentVersion\Lxss"
$WSLDEFID=(Get-ItemProperty "$WSLREGKEY").DefaultDistribution
$WSLFSPATH=(Get-ItemProperty "$WSLREGKEY\$WSLDEFID").BasePath
New-Item -ItemType Junction -Path "$env:LOCALAPPDATA\lxss" -Value "$WSLFSPATH\rootfs"

Usage

Clone this repository, which is where you will be running Vagrant.

You might need to configure some of the settings for the puppet module; to do so, create the following yaml file:

./puppet/data/nodes/twlight.vagrant.localdomain.yaml

and configure any parameters you'd like to override, such as the git repository or revision. See the parameters manifest in the puppet module.

If you have a tarball that you'd like to load on provision, place it

./backup/twlight.tar.gz

Alternatively, scripts are included to create a superuser and generate example data. Before doing anything else, login to the platform as normal, then run

sudo -u www /var/www/html/TWLight/bin/virtualenv_example_data.sh

The account you used to login will be made a superuser, giving you access to the Admin interface. The values in that file can be modified to generate more or less users, partners, and applications, but the file should only be run once.

You'll need to use an SSH SOCKS proxy to access the web interface. To do so specify a dynamic tunnel when you vagrant ssh, e.g.

vagrant up
vagrant ssh -- -D 2080

Then point a browser (configured to use your proxy on 2080) to: http://twlight.vagrant.localdomain

You can now work on the running app inside Vagrant and view the changes in your browser. As you are making local changes, make sure to take advantage of the included test suite. To do so, run the following command within the vagrant machine:

sudo su www /var/www/html/TWLight/bin/virtualenv_test.sh
You can’t perform that action at this time.