IBM / cognos-dashboard-demo

This is an Angular 5 and NodeJs demo application to demonstrate Cognos Dashboard Embedded, an IBM Cloud service that provides application developers with a way to add visualization and analytic capabilities to their application. Dev experience: https://ibm-cognos-dashboard-demo.ng.bluemix.net End-user experience: https://ibm-cognos-dashboard-demo.ng.bluemix.net/dashboard
https://developer.ibm.com/patterns/build-a-dynamic-dashboard-application/
Apache License 2.0
24 stars 38 forks source link

Getting Started with CDE on IBM Cloud

This repo shows a Angular 5.0.0 + Node.js app that demos the IBM Cloud CDE service.

Architecture

Prerequisites

Deployment

In order to deploy to IBM Cloud, you'll need an IBM Cloud account. There are then 2 options to deploy.

Option 1:

Automatically deploy the app using the following deploy to IBM Cloud button.

Deploy to IBM Cloud

Option 2:

To run locally and deploy manually from the command line, follow the instructions below.

Repo setup

Getting started:

$ git clone
$ npm install

Running

Before running locally, please make sure to:

  1. Create a new CDE instance and service credentials in IBM Cloud
  2. Ensure that vcap-local.json contains the CDE credentials
  3. Ensure you update the dde_base_url in config-{env}.js and point it to the correct DDE instance.
$ npm run build

Manual Deployment Steps

Use the bx cli to deploy into IBM Cloud:

  1. Create a new Node.JS Cloud Foundry application in IBM Cloud (https://console.bluemix.net/)
  2. Update manifest.yml and environment / config values
  3. Build locally using npm run build or npm run build-prod
  4. Navigate to the app folder
  5. Issue command to set api endpoint: bx api <API-endpoint> (US South https://api.ng.bluemix.net)
  6. Issue command to login: bx login
  7. Follow the prompts to enter IBM Cloud credentials, select account, and target Cloud Foundry org/space
  8. Issue command to push: bx cf push

Angular setup (front-end only)

Build

Run ng build to build the project. The build artifacts will be stored in the dist/ directory. Use the -prod flag for a production build.

Development server

Run ng serve for a dev server. Navigate to http://localhost:4200/. The app will automatically reload if you change any of the source files.

Resources

ibm

License

This code pattern is licensed under the Apache Software License, Version 2. Separate third party code objects invoked within this code pattern are licensed by their respective providers pursuant to their own separate licenses. Contributions are subject to the Developer Certificate of Origin, Version 1.1 (DCO) and the Apache Software License, Version 2.

Apache Software License (ASL) FAQ