Web application development with Node.js and Express using DocumentDB
This sample shows you how to use the Microsoft Azure DocumentDB service to store and access data from a Node.js Express application hosted on Azure Websites.
For a complete end-to-end walk-through of creating this application, please refer to the full tutorial on the Azure documentation page
Running this sample
Before you can run this sample, you must have the following perquisites:
Clone this repository, or download the zip file.
Retrieve the URI and PRIMARY KEY (or SECONDARY KEY) values from the Keys blade of your DocumentDB account in the Azure Preview portal. For more information on obtaining endpoint & keys for your DocumentDB account refer to How to manage a DocumentDB account
If you don't have an account, see Create a DocumentDB database account to set one up.
In the config.js file, located in the src folder, find config.host and config.authKey and replace the placeholder values with the values obtained for your account.
Install the dependencies by opening a terminal, navigating to the directory in which the sample was installed, and running npm install.
In the terminal, run npm start to start your start your node application.
Launch a browser and navigate to http://127.0.0.1:3000/
Deploy this sample to Azure
If you haven't already, enable a git repository for your Azure Website. You can find instructions on how to do this here.
Add your Azure Website as a git remote.
git remote add azure https://firstname.lastname@example.org:443/your-website.git
Deploy by pushing to the remote.
git push azure master
In a few seconds, git will finish publishing your web application and launch a browser where you can see your handy work running in Azure!
About the code
The code included in this sample is intended to get you going with a simple Node.js Express application that connects to Azure DocumentDB with the express intent of demonstrating how to interact with DocumentDB using the documentdb npm package. It is not intended to be a set of best practices on how to build scalable enterprise grade web applications. This is beyond the scope of this quick start sample.