chore: enable travis testing and deployment

- add a job for testing
- add a job that deploys after test success when on master
- refactor protractor config into local and travis
- update build.js to account for Travis environment

NOTE: pushing to dist branch on Github is currently not enabled on Travis

Closes #222

Author: Narretz

.firebaserc

@@ -0,0 +1,5 @@
+{
+  "projects": {
+    "default": "google.com:angular-sites"
+  }
+}

.travis.yml

@@ -0,0 +1,38 @@
+language: node_js
+sudo: false
+node_js:
+  - '6'
+
+cache:
+  yarn: true
+
+jobs:
+  include:
+    - stage: test
+      addons:
+        sauce_connect:
+          username: angular-ci
+        jwt:
+          secure: "NJ6eWX3YarBTf2LOjOXFhGfRQ90WQ4ZrukAHUxTyUc1o3AXURb3WRi1HzXFh4fnlliBuaCY85/B5oSctvVg+evAOfnqOPm0WN/AP4/PIY6Xicc3jJDmyaeHtfvq2hb6QwxOciM/Ht7WxPsmlIR0wLz98CwqrOPxltjj25E9pPK4="
+      script:
+        - mkdir build
+        - travis_retry yarn run build copy test
+    - stage: deploy
+      # https://docs.travis-ci.com/user/conditional-builds-stages-jobs#Specifying-conditions
+      if: type != pull_request AND branch = master
+      script:
+        - mkdir build
+        # - "yarn run build copy dist" # dist adds the build to the dist folder
+        - "yarn run build copy"
+      deploy:
+        - provider: Firebase
+          # the upload folder for firebase is configured in /firebase.json
+          skip_cleanup: true
+          message: "Commit: $TRAVIS_COMMIT"
+          token:
+            # token generated by [email protected] on 2017/10/13
+            secure: "GRRRA+vodB/NvBW7BM4UJ9huwcE29pEHMSn6SJWIZtFjeoOpIUVocqQcOxYEDzJqwBxQmpAqejRxHzsNaPLVs+cdC7m0Tg+QH3pktyob3/kqwyOc0wm0WrinswXZ4CcOlFUZ2AGakQYO1QFZWRfoXIfW8WwNApTj/1p9Rc/xLvY="
+          on:
+            repo: angular/angularjs.org
+            branch:
+              - master

DEPLOYMENT.md

@@ -0,0 +1,13 @@
+# Setting up Firebase
+
+- run `yarn add -g firebase-tools`
+
+# Manually deploying the contents of the build folder
+
+(You need to be logged in and have access to the project)
+
+- run `yarn run build`
+- run `firebase deploy --only=hosting`
+
+# Generating a new Token for Travis
+See https://docs.travis-ci.com/user/deployment/firebase/

README.md

@@ -17,11 +17,4 @@ and browse to http://localhost:8080
 The site relies upon accessing numerous additional resources from all over the web.
 
 Hint: to access the AngularJS docs application rather than this site, which is only the homepage,
- clone the main project and build the docs yourself...
-
-    git clone https://github.com/angular/angular.js.git
-    cd angular.js
-    npm install
-    grunt package webserver
-
-Then browse to http://localhost:8000/build/docs/api
+ clone the main project and build the docs yourself. See https://github.com/angular/angular.js/blob/master/CONTRIBUTING.md

firebase.json

@@ -0,0 +1,10 @@
+{
+  "hosting": {
+    "public": "build",
+    "ignore": [
+      "/scss/",
+      "/*.php",
+      "/propagateClusterUpdate.js"
+    ]
+  }
+}

protractorConfLocal.js

@@ -0,0 +1,9 @@
+var config = require('./protractorConfShared').config;
+
+config.capabilities = {
+  'browserName': 'chrome'
+};
+
+config.directConnect = true;
+
+exports.config = config;

protractorConf.js renamed to protractorConfShared.js

@@ -1,10 +1,6 @@
 exports.config = {
   baseUrl: process.env.ANGULAR_HOME_HOST || 'http://angularjs.org',
-  capabilities: {
-    'browserName': 'chrome'
-  },
-  directConnect: true,
   specs: [
     'test/angularjs.org.spec.js',
   ]
-};
+};

protractorConfTravis.js

@@ -0,0 +1,14 @@
+var config = require('./protractorConfShared').config;
+
+config.sauceUser = process.env.SAUCE_USERNAME;
+config.sauceKey = process.env.SAUCE_ACCESS_KEY;
+
+config.capabilities = {
+  'browserName': 'chrome',
+  'build': process.env.TRAVIS_BUILD_NUMBER,
+  'elementScrollBehavior': 1,
+  'name': 'AngularJS.org E2E',
+  'tunnel-identifier': process.env.TRAVIS_JOB_NUMBER
+};
+
+exports.config = config;

scripts/build.js

@@ -15,7 +15,7 @@ const SRC_DIR = 'src';
 const CDN_VERSIONS = ['1.2', '1.6'];
 const CDN_REPLACE_FILES = ['index.html', 'js/download-data.js'];
 const GIT_BRANCH_DIST = 'dist';
-const PTOR_CONF = 'protractorConf.js';
+const PTOR_CONF = process.env.TRAVIS ? 'protractorConfTravis.js' : 'protractorConfLocal.js';
 const PTOR_PORT = '8100';
 const PTOR_ENV = {
   ANGULAR_HOME_HOST: `http://localhost:${PTOR_PORT}`,
@@ -133,20 +133,25 @@ function replaceCdnVersionsInFiles(cdnVersions) {
 function testBuild() {
   announce(`Testing the current build (ENV: ${JSON.stringify(PTOR_ENV, null, 2)})...`);
 
-  const installCmd = `${utils.getExecutable('yarn', true)} install`;
-  const wdrManagerCmd = `${utils.getExecutable('webdriver-manager')} update`;
-  const httpServerCmd = `${utils.getExecutable('http-server')} -p ${PTOR_PORT} ${DST_DIR}`;
-  const protractorCmd = `${utils.getExecutable('protractor')} ${PTOR_CONF}`;
-
   const protractorOptions = {
     env: Object.assign(process.env, PTOR_ENV),
     stdio: 'inherit'
   };
 
-  const installPromise = chain(Promise.resolve(), installCmd);
-  const wdrManagerPromise = chain(installPromise, wdrManagerCmd);
-  const httpServerPromise = chain(wdrManagerPromise, httpServerCmd);
-  const protractorPromise = chain(wdrManagerPromise, protractorCmd, protractorOptions);
+  const installCmd = `${utils.getExecutable('yarn', true)} install`;
+  const httpServerCmd = `${utils.getExecutable('http-server')} -p ${PTOR_PORT} ${DST_DIR}`;
+  const wdrManagerCmd = `${utils.getExecutable('webdriver-manager')} update`;
+  const protractorCmd = `${utils.getExecutable('protractor')} ${PTOR_CONF}`;
+
+  let setupPromise = Promise.resolve();
+
+  if (!process.env.TRAVIS) {
+    setupPromise = chain(setupPromise, installCmd);
+    setupPromise = chain(setupPromise, wdrManagerCmd);
+  }
+
+  const httpServerPromise = chain(setupPromise, httpServerCmd);
+  const protractorPromise = chain(setupPromise, protractorCmd, protractorOptions);
 
   const killHttpServer = () => httpServerPromise.$$killProcess();