CraigMChen / erda-ui

Erda's frontend UI, dashboard, console

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Frontend UI for Erda platform.

logo

codecov

📣 Introduction

Erda is an open-source platform created by Terminus to ensure the development of microservice applications. It provides DevOps, microservice governance, and multi-cloud management capabilities. The multi-cloud architecture based on Kubernetes and application-centric DevOps and microservice governance can make the development, operation, monitoring, and problem diagnosis of complex business applications simpler and more efficient.

✨ Platforms

  • DevOps platform
  • Microservice Governance platform
  • Multi-Cloud Management platform
  • Edge computing platform
  • Fast-Data platform

For a detailed introduction, please check the official website.

🖥 Environment Support

Modern browsers

Firefox
Firefox
Chrome
Chrome
Safari
Safari
Edge
Edge
last 2 versions last 2 versions last 2 versions last 2 versions

🚀 Quick Start

Usage

Welcome to use Erda Cloud

Installation

Please use the following installation documents to install Erda.

Run Erda-UI project

This repository contains many Node.JS packages. Each package has its own set of commands, but the most common commands are available from the root package.json and can be accessed using the npm run ... command. Just follow the four steps below to start.

# Step1 Install erda-ui cli to global
	npm i @erda-ui/cli -g


# Step2 Initialize the project of erda-ui
  # Run the following command in the root directory of erda-ui
	erda-ui init

  # What does this command do?
  # Generate initial config to the .env file. After successful running, the .env configuration file will be generated in the root directory of erda-ui.


# Step3 Build core package
  # Run the following command in the directory of core
	npm run build

  # What does this command do?
  # The core package file will be generated in the public folder of the root directory, and static files will be read from that directory in development mode.


# Step4 Watch shell package
  # Run the following command in the directory of shell
	npm run watch

  # What does this command do?
  # Watch the shell package file change and build file to the public folder of the root directory.


# Step5 Start App
  # Run the following command in the directory of scheduler
  npm start

  # What does this command do?
  # Start the dev server, redirect /static/{module}/* to the corresponding module folder in public folder based on the .env file, and redirect /api/* to api server.

Architecture

Technology stack:

  • UI library: Ant Design & Terminus NUSI
  • state management: cube-state
  • i18n: i18next
  • bundler: webpack

This project contain the following parts:

  • cli: command line interface for erda-ui, help to quick setup develop environment and pack files to docker images.
  • core: provide registration framework and core functions such as initialize cube-state and i18n etc.
  • shell: provide layout, user and common components for business modules.
  • scheduler: support module federation style development, register and navigate to multiple modules.
  • modules: business modules, each of these can develop and publish standalone.

architecture

architecture of development mode

🔗 Links

🤝 Contributing PRs Welcome

We welcome all contributions. Please read our CONTRIBUTING.md first. You can submit any ideas as pull requests or as GitHub issues. If you'd like to improve code, check out the Development Instructions and have a good time! :)

Contact Us

If you have any questions, please feel free to contact us.

Wechat
  • 钉钉用户群(Dingtalk):
Dingtalk

License

Erda is under the AGPL 3.0 license. See the LICENSE file for details.

About

Erda's frontend UI, dashboard, console

License:GNU Affero General Public License v3.0


Languages

Language:TypeScript 89.8%Language:SCSS 5.2%Language:JavaScript 5.0%Language:HTML 0.0%Language:EJS 0.0%Language:Shell 0.0%Language:Dockerfile 0.0%