Udagram is a simple cloud application developed alongside the Udacity Cloud Engineering Nanodegree. It allows users to register and log into a web client, post photos to the feed, and process photos using an image filtering microservice.
The project is split into 3 parts:
- Frontend - Angular web application built with Ionic Framework
- Udagram Users RESTful API - Node-Express application - This Project 🤠
- Udagram Feed RESTful API
tip: it's recommended that you start with getting the backend API running since the frontend web application depends on the API.
- The depends on the Node Package Manager (NPM). You will need to download and install Node from https://nodejs.com/en/download. This will allow you to be able to run
npm
commands. - Environment variables will need to be set. These environment variables include database connection details that should not be hard-coded into the application code.
A file named set_env.sh
has been prepared as an optional tool to help you configure these variables on your local development environment.
We do not want your credentials to be stored in git. After pulling this starter
project, run the following command to tell git to stop tracking the script in git but keep it stored locally. This way, you can use the script for your convenience and reduce risk of exposing your credentials.
git rm --cached set_env.sh
Afterwards, we can prevent the file from being included in your solution by adding the file to our .gitignore
file.
Create a PostgreSQL database either locally or on AWS RDS. Set the config values for environment variables prefixed with POSTGRES_
in set_env.sh
.
Create an AWS S3 bucket. Set the config values for environment variables prefixed with AWS_
in set_env.sh
.
- To download all the package dependencies, run the command from the directory
udagram-api/
:npm install .
- To run the application locally, run:
npm run dev
- You can visit
http://localhost:8080/api/v0/feed
in your web browser to verify that the application is running. You should see a JSON payload. Feel free to play around with Postman to test the API's.
- To download all the package dependencies, run the command from the directory
udagram-frontend/
:npm install .
- Install Ionic Framework's Command Line tools for us to build and run the application:
npm install -g ionic
- Prepare your application by compiling them into static files.
ionic build
- Run the application locally using files created from the
ionic build
command.ionic serve
- You can visit
http://localhost:8100
in your web browser to verify that the application is running. You should see a web interface.
- Take a look at
udagram-api
-- does it look like we can divide it into two modules to be deployed as separate microservices? - The
.dockerignore
file is included for your convenience to not copynode_modules
. Copying this over into a Docker container might cause issues if your local environment is a different operating system than the Docker image (ex. Windows or MacOS vs. Linux). - It's useful to "lint" your code so that changes in the codebase adhere to a coding standard. This helps alleviate issues when developers use different styles of coding.
eslint
has been set up for TypeScript in the codebase for you. To lint your code, run the following:To have your code fixed automatically, runnpx eslint --ext .js,.ts src/
npx eslint --ext .js,.ts src/ --fix
- Over time, our code will become outdated and inevitably run into security vulnerabilities. To address them, you can run:
npm audit fix
- In
set_env.sh
, environment variables are set withexport $VAR=value
. Setting it this way is not permanent; every time you open a new terminal, you will have to runset_env.sh
to reconfigure your environment variables. To verify if your environment variable is set, you can check the variable with a command likeecho $POSTGRES_USERNAME
.