Primate - modern role-base progressive UI for Apache CloudStack

Clone this repo:

Branches

  1. f79d2b8 package: update dependencies and add core-js (#16) by Rohit Yadav · 2 days ago master
  2. 4cfa1c9 vue: allow both http and https configuration (#2) by Gregor Riepl · 8 weeks ago
  3. 18d1192 autogen: Fix sort functionality to the standard list views (#10) by Greg Goodrich · 5 days ago
  4. d76e458 settings: simplify instance/template settings tab component by Rohit Yadav · 12 days ago
  5. 4ae24ea config: fix duplicate route definition issue by Rohit Yadav · 12 days ago

CloudStack Primate Build Status

A modern role-based progressive CloudStack UI based on VueJS and Ant Design.

Primate Screenshot

Getting Started

Install node: (Debian/Ubuntu)

sudo apt-get install npm nodejs

Install node: (CentOS/Fedora)

curl -sL https://rpm.nodesource.com/setup_10.x | sudo bash -
sudo yum install nodejs

Install tools and dependencies:

sudo npm install -g @vue/cli webpack eslint
sudo npm install -g npm@next
sudo npm install -g npm-check-updates
ncu -u # optional: upgrade dependencies
npm install

Development

Override the default CS_URL to a running CloudStack management server:

cp .env.local.example .env.local
Change the `CS_URL` in the `.env.local` file

To configure https, you may use .env.local.https.example.

Build and run:

npm start
or
npm run serve

Production Build:

npm run build

Upgrade dependencies:

ncu -u

Run Tests:

npm run test
npm run lint
npm run test:unit

Fix issues and vulnerabilities:

npm audit

Documentation

Learning Resources

Primate Development

  css: {
    loaderOptions: {
      less: {
        modifyVars: {
          /* Less variables, required modifyVars*/
          /* Refer to variables at https://vue.ant.design/docs/vue/customize-theme/ */
          'primary-color': '#F5222D',
          'link-color': '#F5222D',
          'border-radius-base': '4px',
        },
        javascriptEnabled: true,
      }
    }
  }

Attributions

Primate uses the following:

History

The project was created by Rohit Yadav over several weekends during late 2018 and early 2019. During ApacheCon CCCUS19, on 9th September 2019, Primate was introduced and demoed as part of the talk Modern UI for CloudStack (video). Primate was accepted by the Apache CloudStack project on 21 Oct 2019.

License

Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you 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.