The document provides instructions for customizing a starting point app that uses two microservices - an API server and a web server. The API server receives REST requests on port 8082 and returns mock data. The web server receives browser requests, inserts JSON from the API server into an HTML template, and returns it on port 8080. To customize it, the user can change the team name displayed by editing code files in the API and web server directories that handle data and template insertion. Both services use common Node.js libraries like Express, Body Parser, and testing libraries.

1. © 2020 Copyright ROI Training, Inc.
All rights reserved. Not to be reproduced without prior written consent. 1
CND Lab 01 Instructions:
Case Study Example Starting Point

2. © 2020 Copyright ROI Training, Inc.
All rights reserved. Not to be reproduced without prior written consent. 2
About the Starting Point App
● The starting point app is provided as an example to help get started
○ Uses nodejs with the express web server on two microservices
● The api server service receives REST requests on port 8082 and returns mock data
● The web server service receives requests from the browser and inserts json from the
server into an html template in the Views folder and returns it to the requestor on
port 8080
Web Server
Service
API Server
Service
Port 8082
Port 8080
Web request from
User’s browser

3. © 2020 Copyright ROI Training, Inc.
All rights reserved. Not to be reproduced without prior written consent. 3
Using the Startpoint
● In Google Cloud Shell
○ wget https://storage.googleapis.com/deloitte-sample-masters/sample-master-2021.zip
○ unzip sample-master-2021.zip
○ cd sample-master-2021/
○ Follow the readme file
● Once the app is running in cloud shell, it can be tested with the Preview on port 8080

4. © 2020 Copyright ROI Training, Inc.
All rights reserved. Not to be reproduced without prior written consent. 4
Customizing the App - 1 of 3
● Once you get the app running, customize the app by changing the
“Welcome to {{{team}}}'s application.” message.
○ Using the GCP Shell Editor Explorer to drill down to the
web-server/src/views/layouts/home.hbs file
○ On lIne 25 you will see the html that generates the heading
○ This is a template substitution therefore the value is coming from the code
that responds to the browser request for the home page (/)
○ Use the editor to open the web-server/src/routes/index.js file
○ On line 18 there is a call to the API-Server requesting a configuration object
○ On line 20 the variable team is initialized with the value returned from the
API-Server
○ Continued on next slide ....

5. © 2020 Copyright ROI Training, Inc.
All rights reserved. Not to be reproduced without prior written consent. 5
Customizing the App - 2 of 3
● Use the Editor Explorer to drill down into the api-server to reach
api-server/src/routes/config.js
○ Line 6 refers to the config.service in the services folder
○ Open api-server/src/services/config.service.js
○ Line 4 refers to a file called app.config (actually app.config.js)
○ Open api-server/src/app.config.js
○ On line 8 you will see the config object property “team”
■ Change the value from 'Your Team Name' to the name for your team or your
name (must be quoted)
■ Since you made a change you might want to update the version number.
○ In the Cloud Shell terminal where the api-server is running use Ctrl-C to
stop the api-server then npm start to restart with the changes
○ Refresh the preview of the page on port 8080 (web-server)

6. © 2020 Copyright ROI Training, Inc.
All rights reserved. Not to be reproduced without prior written consent. 6
Customizing the App - 3 of 3
● The CND course is designed to give insight into Cloud Services that can be used
for software development, therefore to take advantage of the tools that you will
use over during the course you will want to make changes to the codebases -
api-server & web-server
● This is not a programming course.
● Feel free to add functionality or simply make changes to comments when a
change to the codebases is needed.

7. © 2020 Copyright ROI Training, Inc.
All rights reserved. Not to be reproduced without prior written consent. 7
Dependencies
● The web-server and api-server services both use the following npm packages:
○ express: a web server https://www.npmjs.com/package/express
○ body-parser to convert json and form data in the request into parameters.
https://www.npmjs.com/package/body-parser
○ mocha, chai and supertest (for unit testing)
https://www.npmjs.com/package/mocha https://www.npmjs.com/package/chai
○ https://www.npmjs.com/package/supertest
○ nyc for code coverage reporting https://www.npmjs.com/package/nyc
○ The web-server service uses the following additional libraries:
○ express-handlebars ( a templating library)
https://github.com/ericf/express-handlebars
○ nock (for mocking the api call) https://www.npmjs.com/package/nock