Development environment for Firefox Accounts

Prerequisites

For a local virtual machine environment:

• vagrant >=1.5
• ansible >=1.5
• virtualbox or vmware (fusion or workstation)

For an AWS environment:

• ansible >=1.5
• boto

Usage

Local

To run a local virtual machine evironment change directory to vagrant

cd vagrant

Running make or make vmware will:

• build a base vagrant box image
• create a cluster of virtual machines
• provision each machine with a role
• set an entry for fxa.local in /etc/hosts

The fxa-content-server should now be accessible from a browser at http://fxa.local

To pull code changes from github:

make update-code

To update other provisioning changes:

make update

AWS

To run on AWS change directory to aws

cd aws

1. Set the AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY environment variables
2. create a environments/foo.yml file ('foo' can be anything) a) see environments/EXAMPLE.yml for a base reference
3. run make foo

To updated the stack just run make foo again.

You can ssh into the EC2 instance with ssh ec2-user@{{ whatever you configured in foo.yml }}

Layout Notes

• fxa sources are in /data/fxa-*
• node processes are run by supervisord
  • config in /etc/supervisor.d
  • run sudo supervisorctl status for info
• nginx is the web frontend
  • config in /etc/nginx/conf.d
• node process logs are in /var/log/fxa-*

Example urls

• logs: https://latest.dev.lcip.org/logs/
• heka: https://latest.dev.lcip.org/heka/
• content server: https://latest.dev.lcip.org
• auth server: https://latest.dev.lcip.org/auth/
• oauth server: https://oauth-latest.dev.lcip.org
• demo oauth site: https://123done-latest.dev.lcip.org