Boilerplate application for Node/Express on Google Cloud App Engine

Google Cloud Platform project setup and the Google Quickstart "Before You Begin" steps followed.

You'll also need to change the PROJECT_ID in /config/default.js to your Google project id.

1. npm install

1. npm run dev
2. Develop! 🎉

We prefer to use [Mocha] combined with [Sinon] and [Chance] to unit test our applications. You can auto-run the tests using a tool called [Nodemon] which will auto-run the tests. Some helpful commands to use when you want to run a specfic set of tests are

nodemon --watch test --exec "Describe Block"

for this sample project you could use nodemon --watch test --exec "Index Router" which would run all the tests under

describe('Index Router', () => {
    it('should run this test', () => {});

    describe('GET /', () => {
        it('should also run this test', () => {});
    });
});

Logs for this application can be found in your GAE log page. There aren't many options for logging to Google Cloud that are still actively maintained other than the @google-cloud/logging package, so this project takes advantage of that. It follows the same interace as console so it won't be hard to swap to.

1. gcloud app deploy
2. gcloud app browse

Create a service account that you'll use to deploy the application with after it has been built. It will need the following IAM roles:

• App Engine Admin
• App Engine Deployer
• Cloud Build Editor
• Storage Admin

After you've downloaded the credentials, copy the entire contents into an environment variable called GCLOUD_SERVICE_KEY under the url https://circleci.com/gh/<your username>/<your repo>/edit#env-vars. Be sure to add the GOOGLE_PROJECT_ID (which can be found in the dropdown of your Google Cloud Console). Last thing you need to add is the location you would deploy to, GOOGLE_COMPUTE_ZONE, your zone can be found under here

The first build in Circle will fail and it will tell you to enable the App Engine Admin API, do that and re-run