You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+20-17Lines changed: 20 additions & 17 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,24 +1,24 @@
1
1
# Modern Web Application using MEAN stack
2
2
3
-
This is a basic boilerplate for the MEAN stack ([MongoDB](https://www.mongodb.org/), [Express](http://expressjs.com/), [AngularJS](https://angularjs.org/) and [Node.js](https://nodejs.org)) on [IBM Cloud](http://bluemix.net).
3
+
This is a basic boilerplate for the MEAN stack ([MongoDB](https://www.mongodb.org/), [Express](http://expressjs.com/), [AngularJS](https://angularjs.org/) and [Node.js](https://nodejs.org)) on [IBM Cloud](https://cloud.ibm.com).
4
4
5
-
This application uses the [Compose for MongoDB service](https://console.bluemix.net/catalog/services/compose-for-mongodb) and [Node.js runtime](https://www.ng.bluemix.net/docs/starters/nodejs/index.html) on IBM Cloud.
5
+
This application uses the [IBM Cloud Databases for MongoDB service](https://cloud.ibm.com/catalog/services/databases-for-mongodb) and [Node.js runtime](https://cloud.ibm.com/docs/runtimes/nodejs?topic=Nodejs-nodejs_runtime) on IBM Cloud.
6
6
7
-
<imgsrc="ReadME-Images/Architecture2.png">
7
+
<imgsrc="ReadME-Images/Architecture.png">
8
8
9
9
#### Features
10
10
- MVC project structure
11
11
- Create, edit and delete user accounts
12
12
- Authentication with username/password
13
13
- Protected routes that can only be accessed by authenticated users
- HTTPS built-in if deployed to [IBM Cloud](#deploy-to-bluemix)
15
+
- HTTPS built-in if deployed to [IBM Cloud](#deploy-to-ibm-cloud)
16
16
-[Mongoose](https://github.com/Automattic/mongoose) for MongoDB interactions.
17
17
-[PassportJS](http://passportjs.org) for authentication, with over 300 authentication strategies to pick from.
18
18
19
19
## Application Requirements
20
20
-[Node.js & NPM](https://nodejs.org/en/download/)
21
-
-[Compose for MongoDB database](https://console.bluemix.net/catalog/compose-for-mongodb)
21
+
-[IBM Cloud Databases for MongoDB](https://cloud.ibm.com/catalog/services/databases-for-mongodb)
22
22
-[Cloud Foundry Command Line Tool](https://docs.cloudfoundry.org/devguide/installcf/)
23
23
24
24
## Getting Started
@@ -31,35 +31,38 @@ This application uses the [Compose for MongoDB service](https://console.bluemix.
31
31
6. Run `node server.js` to start your app
32
32
7. Open a browser to the link provided in the terminal prompt to view your app
33
33
34
+
Note that the code assumes a secured connection to MongoDB using SSL and a certificate. This way you can run the app locally but connect to IBM Cloud Databases for MongoDB.
35
+
36
+
An alternative way of local development is using the provided Dockerfile.
37
+
34
38
##### Deploy to IBM Cloud
35
39
36
40
Option 1 (launch this app directly from this repo):
37
41
38
-
[](https://bluemix.net/deploy?repository=https://github.com/IBM-Bluemix/Nodejs-MEAN-Stack)
42
+
[](https://cloud.ibm.com/devops/setup/deploy?repository=https://github.com/IBM-Cloud/nodejs-MEAN-stack)
39
43
40
44
Option 2 (deploy from your local machine):
41
45
42
46
1. Clone or download this repo onto your machine.
43
47
2. Open a terminal prompt to the directory of your application.
44
-
3. If you don't have an account, [create a free one here](https://console.ng.bluemix.net/registration/).
45
-
4. Set your Cloud Foundry CLI tool's API endpoint to: `ibmcloud api https://api.ng.bluemix.net `
46
-
5. Login to your account via the command line: `ibmcloud login`
47
-
6. Target your account ORG and SPACE `ibmcloud target -o ORG -s SPACE`
48
-
7. Create the instance of Compose for MongoDB on IBM Cloud: `ibmcloud cf create-service compose-for-mongodb Standard mean-starter-mongodb`
49
-
8. Push your app to IBM Cloud with `ibmcloud cf push`
50
-
9. Done, the app should be looking like:<imgsrc="ReadME-Images/live-app.png">
48
+
3. If you don't have an account, [create a free one here](https://cloud.ibm.com).
49
+
4. Login to your account via the command line: `ibmcloud login`
50
+
5. Target your account ORG and SPACE `ibmcloud target --cf`
51
+
6. Create the instance of Compose for MongoDB on IBM Cloud: `ibmcloud cf create-service databases-for-mongodb standard mean-starter-mongodb`
52
+
7. Push your app to IBM Cloud with `ibmcloud cf push`
53
+
8. Done, the app should be looking like:<imgsrc="ReadME-Images/live-app.png">
51
54
52
55
53
56
54
57
#### Problems or Questions?
55
58
56
-
Create a [GitHub issue](https://github.com/IBM-Bluemix/nodejs-MEAN-stack/issues/new) for questions or problems occurs using this demo.
59
+
Create a [GitHub issue](https://github.com/IBM-Cloud/nodejs-MEAN-stack/issues/new) for questions or problems occurs using this demo.
| [**manifest.yml**](./manifest.yml) | File that defines deployment paramaters. [More info here](https://www.ng.bluemix.net/docs/manageapps/depapps.html#appmanifest)
65
+
| [**manifest.yml**](./manifest.yml) | File that defines deployment paramaters. [More info here](http://docs.cloudfoundry.org/devguide/deploy-apps/manifest.html)
63
66
| [**.env.example**](./.env.example) | Set custom [environment variables](https://en.wikipedia.org/wiki/Environment_variable) for your application. This is the proper way to store credentials and other sensitive values.
64
67
| [**server.js**](./server.js) | Main server file that the Node.js runtime uses. It contains all the server logic.
65
68
| [**/server**](./server) | Folder for files used by the Node.js server
@@ -92,7 +95,7 @@ If you are not sure what your application name is, use this command to print you
92
95
$ ibmcloud cf apps
93
96
```
94
97
95
-
For more detailed information on troubleshooting your application, see the [Troubleshooting section](https://www.ng.bluemix.net/docs/troubleshoot/tr.html) in the documentation.
98
+
For more detailed information on troubleshooting your application, see the [Troubleshooting section](https://cloud.ibm.com/docs/cloud-foundry-public?topic=cloud-foundry-public-ts-cf-apps) in the documentation.
96
99
97
100
## License
98
-
See [LICENSE.MD](https://github.com/IBM-Bluemix/Nodejs-MEAN-Stack/blob/master/LICENSE.md) for license information.
101
+
See [LICENSE.MD](https://github.com/IBM-Cloud/nodejs-MEAN-stack/blob/master/LICENSE.md) for license information.
0 commit comments