Skip to content

A CLI tool enables you to quickly set up a KubeSphere Console extension project.

Notifications You must be signed in to change notification settings

kubesphere/create-ks-project

Repository files navigation

Create KubeSphere Extension Console Project

Heavily inspired by create-next-app and create-react-app, this CLI tool can help you quickly set up The console part of a KubeSphere extension project. You don't need to install or configure tools like webpack, Babel, TypeScript, etc. Just run the command shown as the following and your project will be ready to go.

Prerequisites

Getting Started

Run the command:

yarn create ks-project frontend

The wizard will create the project frontend in the current directory. Inside that folder, it will generate the initial project structure and install the dependencies.

It might take a little while, but as soon as the message similar as below, you can go to the next step.

Success! The project frontend is created at /Users/chenzhen/kubesphere-extensions/frontend
Inside the directory, you can run the following commands:

  yarn create:ext
    Creates a new extension.

  yarn dev
    Starts the development server.

  yarn build:prod
    Builds the app for production to use.

  yarn start
    Runs the built app in production mode.

We suggest that you begin by typing:

  cd frontend
  yarn create:ext

And

  yarn dev

Options

create-ks-project comes with the following option:

  • -f, --fast-mode: Install dependencies from a tarball.

Create your KubeSphere extension

Switch to the directory you just created and run the command:

yarn create:ext

the wizard will ask you the extension name, displayName, description and author.

$ ksc create:ext
? Extension Name demo
? Display Name Demo
? Description this is demo
? Author chenzhen
? Language JavaScript
? Are you sure you want to create extension: [demo] ? Yes
✨  Done in 12.64s.

Then the extension will be created in the extensions directory. The files structure of the extension is as follows:

.
├── Dockerfile
├── README.md
├── package.json
└── src
    ├── App.jsx
    ├── index.js
    ├── locales
    │   ├── en
    │   │   ├── base.json
    │   │   └── index.js
    │   ├── index.js
    │   └── zh
    │       ├── base.json
    │       └── index.js
    └── routes
        └── index.js

Run development environment

  1. Edit the local_config.yaml file in the configs directory. Replace the apiServer value with the real value
server:
  apiServer:
    url: http://apiserver.local
    wsUrl: ws://apiserver.local
  1. run the dev
yarn dev

And open the browser to http://localhost:8000/, you will see the kubesphere page. for more information about the development environment, please refer to the development documentation

About

A CLI tool enables you to quickly set up a KubeSphere Console extension project.

Resources

Stars

Watchers

Forks

Packages

No packages published