Skip to main content

Deploy NodeJS application in Oracle Application Container Cloud


Check my previous blog regarding "How to create a NodeJS application for CRUD services on Oracle Database Cloud", I am going to use that application now to explain the deployment process on App Container Cloud.

As mentioned in the previous blog, you need "manifest.json". It should contain some basic config params. My case it contained :



For more info on these params : https://docs.oracle.com/cloud/latest/apaas_gs/DVCJV/GUID-D98FB882-5E58-4318-9DCB-4B404FD86E14.htm

You need to create a .zip file containing all the files and folders inside your NodeJS application :


IMPORTANT : Once you have the zip file, open it and go inside "node_modules" and delete "oracledb" folder from it.
Oracle Application Container Cloud provides this node_module out-of-the-box, so you don't need to include this in the packaging.

Now open service console of Application Container Cloud and click on "Create Application"



Then select "Node"



Give a name and upload your zip by choosing "Upload archive"



This will start the upload and deployment, which will take you to the Application's page and you can see the deployment progress log in the "Activity" section on the bottom of the page.

If it ran into deployment errors, download the deployment logs and check what went wrong, "how to" is here.

If everything goes alright your application will be deployed and will be active. You'll find the application URL in the top section of the page.



You can now check the apis via Postman :



Optionally, you can add your DB Cloud connection details as "Service Bindings" to the application. You need to go to "Deployment" section from the left-hand side and click on "Add" in Service Bindings section.





This will allow you to use "process.env.XXXX" variables in your NodeJS code, which will make the code transportable through different environments (dev, test, uat etc.).
Check in the previous blog : dbutils.js file where I have used these env variables.

That's it. You have now NodeJS application doing mirco CRUD services on DB cloud. A complete JS application for your Oracle DB instance.
Labels:

Comments

Post a Comment

Popular posts from this blog

Chatbots and Oracle Cloud Services

Thanks to Oracle A-Team, I had a chance to work with Chatbots. 3 pure NodeJS applications, on couple of Oracle Cloud platforms and Facebook messenger, and my chatbot was running. Let me explain, the architecture a bit. To start with, following is the simple representation of how it works. Message Platform Server : Is a NodeJS application, deployed on Oracle Application Container cloud, acts as a channel between Facebook Messenger and the chatbot engine. It simply converts the incoming messages from Facebook and sends it to chatbot readable format. Also, when chatbot replies, it converts to Facebook readable formats and passes it to messenger. Chatbot Engine : Is a NodeJS application, which communicate with some REST APIs based on a conversation flow document and moves the flow of the conversation from one state to another. Flow JSON : Where we document, every state of a conversation and which APIs to call to generate a response. For example, at the beginning of the con...
23 comments
Read more

Create Micro CRUD services for Oracle Database Cloud using NodeJS

I will try to explain, how you can use NodeJS to create mirco services for the tables in your Oracle Database Cloud or on-premise Database. Complete Github project : https://github.com/sohamda/LeasifyAPIs You need to do "npm install" to download the node_modules. Step by Step guide : 1. NodeJS : either 32 or 64 bit. If you already have NodeJS installed, please check whether it is 64 or 32. Use below command to figure that out : C:\>node > require('os').arch() If you get : 'ia32' , then it is 32 bit installation. 2. Install oracle-db node module .  This was a lengthy and time consuming installation for me, because for Windows, it has a lot of pre-requisites. If you are a Mac user, you are lucky. :) I followed : https://community.oracle.com/docs/DOC-931127 There is also a detailed one in github : https://github.com/oracle/node-oracledb/blob/master/INSTALL.md 3. Config your DB Cloud Create a user and couple of tables on which we...
25 comments
Read more

Secure your Node/Express REST APIs using Passport JS

Recently I have been involved in various discussions on how to make the REST APIs as secure as SOAP. First of all, let me start with a very basic statement, about security, it doesn't depend on your Webservice type, be it REST or SOAP, your design decisions depicts whether they can be made secure or not. In this example blog, I will use " Micro CRUD services for Oracle Database Cloud " APIs and implement (read attach) Passport's "local" authentication strategy, to make them secure. Code in Github : LeasifyAPIs with Passport What is Passport JS? (from Documentation ) Passport is authentication middleware for Node . It is designed to serve a singular purpose: authenticate requests. When writing modules, encapsulation is a virtue, so Passport delegates all other functionality to the application. This separation of concerns keeps code clean and maintainable, and makes Passport extremely easy to integrate into an application. What are "strateg...
19 comments
Read more