DEPRECATED - Migrated to https://github.com/mozilla/fxa
Перейти к файлу
Shane Tomlinson 1fc35b0f3d fix the spelling mistake 2014-02-12 21:59:29 +00:00
app
grunttasks
locale/templates/LC_MESSAGES
scripts
server
tests
.awsbox.json
.bowerrc
.editorconfig
.gitattributes
.gitignore
.jscs.json
.jshintrc
.travis.yml
Gruntfile.js
README.md
bower.json
package.json

README.md

Firefox Accounts Content Server

Build Status

Static server that hosts Firefox Account sign up, sign in, email verification, etc. flows.

Prerequisites

  • node 0.10.x or higher
  • npm
  • Grunt (npm install -g grunt-cli)
  • PhantomJS (npm install -g phantomjs)
  • bower (npm install -g bower)
  • libgmp
    • On Linux: install libgmp and libgmp-dev packages
    • On Mac OS X: brew install gmp
  • fxa-auth-server running on 127.0.0.1:9000.

Development Setup

cp server/config/local.json-dist server/config/local.json
npm install
npm start

Testing

Setup

There is quite a bit of setup to do before you can test this service, which is non-optimal, but for now:

  • Set up saucelabs credentials (we have an opensource account: SAUCE_USERNAME=intern-example-ci SAUCE_ACCESS_KEY=89ac3089-17b3-4e9b-aaf3-c475b27fa441)
  • PhantomJS: phantomjs --webdriver=4444 (see Prerequisites)
  • Run the Firefox Content Server locally: npm start
  • Run an instance of the fxa-auth-server at 127.0.0.1:9000.

e.g. in shell form:

export SAUCE_USERNAME=intern-example-ci
export SAUCE_ACCESS_KEY=89ac3089-17b3-4e9b-aaf3-c475b27fa441
phantomjs --webdriver=4444 &
cd fxa-auth-server
npm start &
cd ../fxa-content-server
npm start &

Running the tests

To run tests locally against phantomjs:

npm test

To run tests against saucelabs:

npm run-script test-remote

Advanced local testing using headed browsers

It is possible to run the Selenium tests against local browsers like Firefox, Chrome, and Safari.

Prerequisites:

Configuration:

  • edit tests/intern.js to select the browsers to test under environments.
  • comment out phantom

Running the tests

  • Start the Selenium Server: java -jar selenium-server-standalone-2.38.0.jar
  • Stop PhantomJS if it is running.
  • from the fxa-content-server directory, type npm test

Configuration

The default auth server is http://api-accounts.dev.lcip.org. To change this, edit server/config/*.json on your deployed instance.

{
  'fxaccount_url': 'http://your.auth.server.here.org'
}

Grunt Commands

Grunt is used to run common tasks to build, test, and run local servers.

  • grunt jshint - run JSHint on client side and testing JavaScript.
  • grunt build - build production resources.
  • grunt clean - remove any built production resources.
  • grunt test - run local Intern tests.
  • grunt server - run a local server running on port 3030 with development resources.
  • grunt server:dist - run a local server running on port 3030 with production resources. Production resources will be built as part of the task.

Servers

License

MPL 2.0