OpenShift Online<\/a>\u00a0–\u00a0Red Hat’s public cloud application development and hosting platform that automates the provisioning, management and scaling of applications so that you can focus on writing the code for your business, startup, or next big idea.<\/p><\/blockquote>\n If you’ve tried OpenShift, you may have come across this offical how-to video<\/a>\u00a0only to find it completely useless. The accompanying official blog post<\/a>\u00a0is way better but still lacks some exact example code on, for example, how to connect to MongoDB from Node.js. Read on to see how I did it.<\/span><\/span><\/p>\n First, you have to create a new OpenShift<\/a> account in case you don’t have one already.<\/p>\n Once you login to the site you get a nice looking dashboard and in order to create a new application you could click on the Add application<\/em> button: which would then offer really a lot of options: Setting up WordPress is easy as clicking the WordPress icon and naming your app on the next page: If you ever installed WordPress before everything should be familiar from now on. And there you have it – you have WordPress installed in a matter of few clicks.<\/p>\n You may be wondering where’s the MongoDB and Node.js from the title? Hack on…<\/p>\n So, we saw how easy it was to create an app from web admin interface, but\u00a0since we’re devs and we loove terminal (don’t we ;)) we’re gonna take a different route here. OpenShift offers the\u00a0OpenShift Client tools<\/em> aka rhc<\/strong>. In order to install rhc you first have to have Ruby installed, and the easiest way to do this on a Windows machine is to install the RubyInstaller<\/a>:<\/p>\n Just click the big red download button and I’m sure you now how to take it from there. Important note though, while installing just make sure that you check the Add Ruby executables to your PATH<\/strong> option: After the installation is done you can fire up your terminal (I use Console 2<\/a>, and you can see my settings here: Customize Console 2 on Windows machine<\/a>) and run<\/p>\n and once this is done just run rhc setup<\/span>\u00a0 (this is an important part for us Windows users, as the official documentation on Installing OpenShift RHC Client Tools<\/a>\u00a0says we should only run rhc<\/span>\u00a0, and that does not work – as noted by the comments on that post).<\/p>\n Now we can use rhc to create a new application. To create a new application named myTest<\/strong>\u00a0with Node.js and MongoDB you have to run:<\/p>\n and you’ll get an output similar to this:<\/p>\n If you’re concerned about that ‘DL is deprecated, please use Fiddle<\/em>‘, don’t be as it’s a mere warning as they say\u00a0on Stackoverflow<\/a>\u00a0(or if you want to explore this topic further make sure you check this question on SO).<\/p>\n If you get an error saying that there’s no such cartridge<\/em> you will get a list of all the available cartridges which you can use, so just adjust the above command accordingly<\/p>\n MongoDB\u00a0is an open-source document database, and the leading NoSQL database<\/a>.\u00a0In order to add\u00a0RockMongo\u00a0<\/a>MongoDB administration, which is a web front-end for interacting with your MongoDB, you have to\u00a0execute this command:<\/p>\n after which you get an output similar to this:<\/p>\n If you login to RockMongo by using the username and pass provided you will get a simple but useful interface: However, if you prefer to do it via shell, you can do this:<\/p>\n and after that start interactive command-line interface by typing\u00a0mongo<\/span>\u00a0:<\/p>\n Now let’s select a database, which will be same as your app’s name.<\/p>\n To insert some record we can do something like this:<\/p>\n and check if it was successfully inserted:<\/p>\n To query this information with Node.js you first have to install mongojs<\/a> with npm install mongojs<\/span>\u00a0. Then open up the server.js<\/span>\u00a0\u00a0file (it is in the root folder of your application) and add these lines in the self.createRoutes<\/span>\u00a0\u00a0object:<\/p>\n Now it’s time to add the changes to the staging state with\u00a0git add .<\/span>\u00a0(you may wanna check Git<\/a> if this looks daunting). You can check the status of the files with\u00a0git status<\/span>\u00a0. To commit the changes you have to execute:\u00a0\u00a0git commit -a -m “Added code to talk to db”<\/span>\u00a0and finally\u00a0git push<\/span>\u00a0 to send the changes to OpenShift for deployment.<\/p>\n
\n![\"openshift_login\"](\"http:\/\/nikola-breznjak.com\/blog\/wp-content\/uploads\/2014\/03\/openshift_login-1024x394.jpg\")
<\/a><\/p>\n
\n![\"openshift_applist\"](\"http:\/\/nikola-breznjak.com\/blog\/wp-content\/uploads\/2014\/03\/openshift_applist-1024x859.jpg\")
<\/a><\/p>\n
\n![\"openshift_wp\"](\"http:\/\/nikola-breznjak.com\/blog\/wp-content\/uploads\/2014\/03\/openshift_wp.jpg\")
<\/a>
\nand clicking the Create Application<\/strong> button. After the process finishes (few mins) you get the instructions on how to alter the application:
\n![\"openshift_wp_done\"](\"http:\/\/nikola-breznjak.com\/blog\/wp-content\/uploads\/2014\/03\/openshift_wp_done-1024x622.jpg\")
<\/a>
\nBasically, you clone the application’s source code with git and after doing some changes you push them back. At this point, all you have to do is visit the link of your newly created application (you can see the link in your Applications tab in the OpenShift admin interface) and you’ll get the WordPress init install screen:
\n![\"openshift_wp_isntall\"](\"http:\/\/nikola-breznjak.com\/blog\/wp-content\/uploads\/2014\/03\/openshift_wp_isntall.jpg\")
<\/a><\/p>\nKeep calm and roll up your sleves<\/h3>\n
![\"openshift_rubyinstaller\"](\"http:\/\/nikola-breznjak.com\/blog\/wp-content\/uploads\/2014\/03\/openshift_rubyinstaller.jpg\")
<\/a><\/p>\n
\n![\"openshift_rubypath\"](\"http:\/\/nikola-breznjak.com\/blog\/wp-content\/uploads\/2014\/03\/openshift_rubypath.jpg\")
<\/a><\/p>\ngem install rhc<\/pre>\n
rhc app create myTest nodejs-0.10 mongodb-2.4<\/pre>\n
C:\\Users\\Nikola\\Desktop>rhc app create myTest nodejs-0.10 mongodb-2.4\r\nDL is deprecated, please use Fiddle\r\nApplication Options\r\n-------------------\r\nDomain: chavo\r\nCartridges: nodejs-0.10, mongodb-2.4\r\nGear Size: default\r\nScaling: no\r\n\r\nCreating application 'myTest' ... done\r\n\r\n MongoDB 2.4 database added. Please make note of these credentials:\r\n\r\n Root User: admin\r\n Root Password: ..bip..Bip..\r\n Database Name: mytest\r\n\r\nConnection URL: mongodb:\/\/$OPENSHIFT_MONGODB_DB_HOST:$OPENSHIFT_MONGODB_DB_PORT\/\r\n\r\nWaiting for your DNS name to be available ... done\r\n\r\nCloning into 'mytest'...\r\nThe authenticity of host 'mytest-chavo.rhcloud.com (54.235.21.98)' can't be established.\r\nRSA key fingerprint is cf:ee:77:cb:0e:fc:02:d7:72:7e:ae:80:c0:90:88:a7.\r\nAre you sure you want to continue connecting (yes\/no)? yes\r\nWarning: Permanently added 'mytest-chavo.rhcloud.com,54.235.21.98' (RSA) to the list of known hosts.\r\nEnter passphrase for key '\/c\/Users\/Nikola\/.ssh\/id_rsa':\r\nremote: Counting objects: 21, done.\r\nremote: Compressing objects: 100% (17\/17), done.\r\nReceiving objects: 100% (21\/21), 20.22 KiB, done.ceiving objects: 90% (19\/21)\r\n\r\nYour application 'mytest' is now available.\r\n\r\n URL: http:\/\/mytest-chavo.rhcloud.com\/\r\n SSH to: 532812f94382eca22b000657@mytest-chavo.rhcloud.com\r\n Git remote: ssh:\/\/532812f94382eca22b000657@mytest-chavo.rhcloud.com\/~\/git\/mytest.git\/\r\n Cloned to: C:\/Users\/Nikola\/Desktop\/mytest\r\n\r\nRun 'rhc show-app myTest' for more details about your app.<\/pre>\n
C:\\Users\\Nikola\\Desktop>rhc app create\r\nDL is deprecated, please use Fiddle\r\nWhen creating an application, you must provide a name and a cartridge from the\r\nlist below:\r\n\r\nShort Name Full name\r\n========== =========\r\ndiy-0.1 Do-It-Yourself 0.1\r\njbossas-7 JBoss Application Server 7\r\njbosseap-6 JBoss Enterprise Application Platform 6\r\njenkins-1 Jenkins Server\r\nnodejs-0.10 Node.js 0.10\r\nnodejs-0.6 Node.js 0.6\r\nperl-5.10 Perl 5.10\r\nphp-5.3 PHP 5.3\r\nzend-5.6 PHP 5.3 with Zend Server 5.6\r\nphp-5.4 PHP 5.4\r\nzend-6.1 PHP 5.4 with Zend Server 6.1\r\npython-2.6 Python 2.6\r\npython-2.7 Python 2.7\r\npython-3.3 Python 3.3\r\nruby-1.8 Ruby 1.8\r\nruby-1.9 Ruby 1.9\r\njbossews-1.0 Tomcat 6 (JBoss EWS 1.0)\r\njbossews-2.0 Tomcat 7 (JBoss EWS 2.0)\r\njboss-vertx-2.1 Vert.x 2.1\r\n\r\nPlease specify the name of the application and the web cartridge to install\r\nUsage: rhc app-create <name> <cartridge> [... <cartridge>] [... VARIABLE=VALUE]\r\n[-n namespace]\r\nPass '--help' to see the full list of options<\/pre>\n
Keep on rockin’ on<\/h3>\n
rhc cartridge add rockmongo<\/pre>\n
C:\\Users\\Nikola\\Desktop\\mytest>rhc cartridge add rockmongo\r\nDL is deprecated, please use Fiddle\r\nUsing rockmongo-1.1 (RockMongo 1.1) for 'rockmongo'\r\nAdding rockmongo-1.1 to application 'mytest' ... done\r\n\r\nrockmongo-1.1 (RockMongo 1.1)\r\n-----------------------------\r\n Gears: Located with mongodb-2.4, nodejs-0.10\r\n Connection URL: https:\/\/mytest-chavo.rhcloud.com\/rockmongo\/\r\n\r\nPlease make note of these MongoDB credentials:\r\n RockMongo User: admin\r\n RockMongo Password: ..i.aint.telin'..\r\nURL: https:\/\/mytest-chavo.rhcloud.com\/rockmongo\/<\/pre>\n
\n![\"openshift_rockmongo\"](\"http:\/\/nikola-breznjak.com\/blog\/wp-content\/uploads\/2014\/03\/openshift_rockmongo.jpg\")
<\/a><\/p>\nrhc ssh<\/pre>\n
[mytest-chavo.rhcloud.com 532812f94382eca22b000657]\\> mongo\r\nMongoDB shell version: 2.4.6\r\nconnecting to: 127.9.197.130:27017\/admin\r\nWelcome to the MongoDB shell.\r\nFor interactive help, type \"help\".\r\nFor more comprehensive documentation, see\r\n http:\/\/docs.mongodb.org\/\r\nQuestions? Try the support group\r\n http:\/\/groups.google.com\/group\/mongodb-user<\/pre>\n
> use mytest\r\nswitched to db mytest<\/pre>\n
> var a = {\"user\":\"nikola\", points:10};\r\n> db.scores.insert(a);<\/pre>\n> db.scores.find();\r\n{ \"_id\" : ObjectId(\"53284189d6e5e4aedb1fbafd\"), \"user\" : \"nikola\", \"points\" : 10 }<\/pre>\nself.routes['\/db'] = function(req, res) {\r\n var mongojs = require('mongojs');\r\n var dbName = \"\/mytest\";\r\n var connection_string = process.env.OPENSHIFT_MONGODB_DB_USERNAME + \":\" + process.env.OPENSHIFT_MONGODB_DB_PASSWORD + \"@\" + process.env.OPENSHIFT_MONGODB_DB_HOST + dbName;\r\n var db = mongojs(connection_string, ['scores']);\r\n var books = db.collection('scores');\r\n\r\n db.scores.find(function(err, docs) {\r\n res.send(docs); \r\n });\r\n};<\/pre>\nAll aboard, and ready to take-off<\/h3>\n
![\"openshift_dboutput\"](\"http:\/\/nikola-breznjak.com\/blog\/wp-content\/uploads\/2014\/03\/openshift_dboutput.jpg\")
<\/a><\/p>\n