README.md

Kpt Backstage Plugins

NOTICE This is a fork of the upstream Kpt Backstage Plugin repository. The intention is to upstream relevant changes to that repository after kpt moves to CNCF and has the CNCF CLA. Please keep changes that are Nephio-specific (i.e., do not belong in the upstream project) easily separable (or do them in a different repository).

Welcome! This repository contains the Kpt Backstage Plugins. The plugins can be installed into an existing Backstage Application following the READMEs for each plugin. For development and testing, the plugins can also be executed with the example Backstage Application in this repository.

Configuration as Data is the primary plugin which powers the WYSIWYG Configuration GUI over GitOps using kpt and its new Package Orchestrator, Porch.

New to kpt?

kpt is a package-centric toolchain that enables a WYSIWYG configuration authoring, automation, and delivery experience, which simplifies managing Kubernetes platforms and KRM-driven infrastructure at scale by manipulating declarative Configuration as Data, separated from the code that transforms it. Read kpt.dev to learn more.

New to Backstage?

Backstage is an open platform for building developer portals. Watch What is Backstage? (Explainer Video) on YouTube and read backstage.io to learn more.

Quick Start

Prerequisites

To use the Backstage Application in this repository, you will need:

• Node.js Active LTS Release installed
• yarn installed
• git installed
• Porch (Package Orchestration Server) installed on a Kubernetes cluster

Clone Repository

The first step is to check out the code to your local development environment. We recommend you create your own fork, but we will keep things simple here.

git clone https://github.com/GoogleContainerTools/kpt-backstage-plugins.git
cd kpt-backstage-plugins

Install Dependencies

You'll need to install dependencies before you can run the UI locally.

yarn install

Running the UI

To run the UI, you'll need to use this command will start Backstage frontend and backend instances. The frontend instance is hosted on port 3000 and, the backend instance is on port 7007. Once started, you'll be able to access the UI by browsing to the URL http://localhost:3000.

yarn dev

Executing Tests

Run tests:

yarn test

Executing Linter

Run the linter:

yarn lint

Executing Code Formatting

Run the code formatter:

yarn prettier:check # Checks for any code formatting errors
yarn prettier:write # Formats code

Contributing

If you are interested in contributing, please start with the contribution guidelines.