The TIBCO® Developer Hub

The TIBCO® Developer Hub is powered by the Backstage platform. See the Backstage.io documentation for more details.

Architecture

See the architecture overview in the Backstage docs.

Pre-requisites

• NodeJs 16.x
• yarn 1.22.19
• Docker (with docker compose) -- to run the database

Getting started

Database

We've included a docker-compose file to make it simpler to start the database.

In a terminal, go to the docker folder and run:

# cd docker
docker compose up -d

Tip: the docker compose command will also start the Adminer database UI in port :8080. If for some reason you want to skip the adminer service, run docker compose up -d db

Stop the database services without deleting their data:

# cd docker
docker compose stop

Stop the database services and delete their data:

# cd docker
docker compose down

You can alternatively set up your own Postgres database instance. You will need to update the connection details in the app-config.local.yaml under backend.database.connection.

Install dependencies

yarn install

Setup local environment files

Create a copy the file ./app-config.template-local.yaml and rename it app-config.local.yaml.

Update the contents of the newly created app-config.local.yaml to suit your local configuration.

The application will load the app-config.local.yaml, overriding the configuration in app-config.yaml. The app-config.local.yaml file is ignored by git, so it's safe to input tokens, passwords, or any other secret values without risk of committing the file by mistake.

Run backend and frontend

You can run start both backend and frontend at once by running:

yarn dev

When the command finishes running, it should open up a browser window displaying your app. If not, you can open a browser and directly navigate to the frontend at http://localhost:3000/tibco/hub .

For development purposes it might be more convenient to start the backend and the frontend server in different terminals. This way you can restart each one independently and the most importantly, makes it easier to read the log outputs and identify where the logs are coming from.

Start the backend server

yarn start-backend

Start the frontend server

yarn start

Steps to build

docker build -t <customImageName:customImageTag> .

Helpful Documentation

Docker configuration
Docs
Packages
Plugins
Example Templates, Group and System

Licenses

This project (TIBCO® Developer Hub) is licensed under the Apache 2.0 License.

Other Software

When you use some of the TIBCO® Developer Hub, you fetch and use other charts that might fetch other container images, each with its own licenses.

A partial summary of the third party software and licenses used in this project is available here.

---

Copyright 2023 Cloud Software Group, Inc.

License. This project is Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.