branflake2267 / debugging-angular-appengine

Debugging and deploying Angular application to app engine.

Debugging Angular with App Engine Hosting

Debugging Angular with Visual Studio Code hosted on App Engine.

Debugging Angular as the Client & Express as the server

This covers debugging Angular as the client with Express as the web server, which will be hosted on App Engine.

Project Configuration

Setting	Value
Purpose	Debugging with VS Code using a simple Angular project
Client	Angular application
Server	Express web server
Client Framework	Angular
Client Language	TypeScript
Server Language	JavaScript
Architecture	npm/node
IDE	Visual Studio Code
License	GPL v3
Tutorial	Youtube Tutorial

Generate Application

The app generation is based on https://angular.io/guide/setup-local.

• Run npm install -g @angular/cli - Install the app generator CLI tool.
• Run ng new client - Generate an application, I named it client.
• Run cd client - Change directory to the app.
• Run ng serve --open - Start the compiler, web server and open Chrome.

Debugging

• From the project root, run npm install to download the libraries used in the client and server directories.

Debugging Server

• Use the VS Code Launcher 1. Launch Server
• http://localhost:8080 - ./ server
• http://localhost:8080/api - ./api server

Debugging Client

The client uses a proxy to the server. Proxy config reference.

• Use the VS Code Launcher 2. Launch ng serve & Chrome
• http://localhost:4200 - ./ - client
• http://localhost:4200/api - ./api - server

Debugging with npm

• From the ./server directory run npm start to start the express web server.
• From the ./client directory run npm start to start the client compiler and angular debugging.

Deploy

The application is deployed to https://donnelson-sandbox.appspot.com.

Travis CI Deployent

• .travis.yml deploys the application to GAE on master commits.

Manual Deployment

• Run cd ./dist
• Run gcloud app deploy

Init Reference

These are the instructions I used to generate angular and configure App Engine on GCP.

Generate Angular Application

The app generation is based on https://angular.io/guide/setup-local.

• Run npm install -g @angular/cli - Install the app generator CLI tool.
• Run ng new client - Generate an application, I named it client.
• Run cd client - Change directory to the app.
• Run ng serve --open - Start the compiler, web server and open Chrome.

Cloud Tools CLI Installation

1. Sign up for Google Cloud Compute.
2. Create a GCP project.
3. Create an App Engine Application https://console.cloud.google.com/appengine/start.
   • This app is Node.js & a Standard App Engine deployment.
   • Download Cloud SDK CLI tools
   • Run gcloud init
4. Create a service account for App Engine Admin for deployments.
   • And be sure you add the Cloud Build API permissions to the services account.
   • And turn on the Cloud API Dash for the project.
5. Create an App Engine project in the console https://console.cloud.google.com/appengine.
   • After you create an app engine project, follow the App Engine getting strted instructions on how to install Cloud CLI.

app.yaml

app.yaml configures the App Engine web hosting service options. app.yaml reference