Skip to content

Latest commit

 

History

History
76 lines (54 loc) · 3.6 KB

README.md

File metadata and controls

76 lines (54 loc) · 3.6 KB
Raw
page_type languages products description urlFragment
sample
nodejs
nodejs
This code is part of the Microsoft Learn module of the AKS workshop. It provides the API for the ratings application. The API connects to a MongoDB to store and retrieve data.
aksworkshop-ratings-api

AKS Workshop - ratings-api sample code

This code is part of the Microsoft Learn module of the AKS workshop. It provides the API for the ratings application. The API connects to a MongoDB to store and retrieve data.

Contents

File/folder Description
routes API endpoint implementation.
models Representation of API data model.
data Data to be preloaded into the database.
views Handelbars HTML view templates.
server.js NodeJS web server startup file.
app.js Express NodeJS application startup file.
.gitignore Define what to ignore at commit time.
.dockerignore Define what to ignore at build time.
Dockerfile Define how the Docker image is built.
README.md This README file.
LICENSE The license for the sample.

Prerequisites

To build this sample locally, you can either build using Docker, or using NPM.

Setup

  • To build using Docker, in the project folder, run docker build -t ratings-api .
  • To build using NPM, in the project folder, run npm install

Running the sample

  • To run using Docker, run docker run -it -p 3000:3000 ratings-api
  • To run using NPM, run npm start

Required configuration via environment variables:

  • MONGODB_URI: MongoDB connection is configured using an environment variable called MONGODB_URI. This URI should look like mongodb://[username]:[password]@[endpoint]:27017/ratingsdb

The API exposes port 3000.

You should then be able to access the API at http://localhost:3000/api/items

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.

When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.