Richmond

https://richmond.cfapps.io/

Pivotal Tracker

Google Drive

Installation

Install .NET Core.

For development, I would recommend Visual Studio Code with the C# plugin.

Build and run locally

Environment variables

Our workstation image includes direnv, so you should just be able to add these to a file named .envrc in the root of the project.

FOODTRUCK_PATH=https://www.seattlefoodtruck.com/api/events?page=1&for_locations=39&with_active_trucks=true&include_bookings=true&with_booking_status=approved

Populate local dependency cache

richmond> dotnet restore

Run backend tests:

richmond> dotnet test test-backend

Run frontend tests:

With PhantomJS on the commandline: (if phantomJs is not installed first run brew install phantomjs)

richmond> cd test-frontend
richmond/test-frontend> phantomjs run-jasmine.js SpecRunner.html

Or, open richmond/test-frontend/SpecRunner.html in a JS-enabled web browser.

Run server:

The default location is http://localhost:5000

richmond> cd src
richmond/src> dotnet run

Custom scripts

We also include some custom scripts at the root, which you can install with:

richmond> ./scripts/install.sh

Deployment

The app is deployed in the seattle-beach PWS org, space name richmond. We have a deployment service account sealabs-beach@googlegroups.com; ask another beach person for the password.

To cf push or update the CI pipeline, environment variables CF_PASSWORD and CF_USERNAME must be set. We're using direnv to manage these, but anything is fine.

cf push needs to be run from the root directory, but it points at the src directory.

cf push -p src

CI

We're currently using the monitor between Lovelace and Hopper as our Concourse CI server. In order to view the CI pipeline simply visit http://10.37.2.27:8080 click the login button in the upper right corner and select the 'main' pipeline.

Updating CI:

1. Connect to the machine: ssh sea-ci1.local
2. See the vagrant installation instructions
3. On the Concourse host, uncomment (or add a line to) the Vagrantfile like:

config.vm.network "forwarded_port", guest: 8080, host: 8080

4. Visit http://sea-ci1.local:8080 and login, then download fly
5. richmond/concourse> ./update-concourse.sh

Optionally, start vagrant on Mac reboot (note: may depend on VB/vagrant version? Currently does not work...):

richmond/concourse> ln -s vagrant.startup.plist ~/Library/LaunchAgents/vagrant.startup.plist
richmond/concourse> launchctl load -w ~/Library/LaunchAgents/vagrant.startup.plist

In order to update the concourse pipelines, you'll need to set the TRACKER_API_TOKEN environment variable. You can get it from the Profile page on the sealabs-beach@googlegroups.com user on pivotaltracker.com

dotnet core resources

• project.json (similar to package.json, Gemfile, Cargo.toml, build.gradle, *.csproj, ...)
• .NET Core