A modern dashboard for OpenStack - API server
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
Gao Hanxiang 3176cfbc47 fix: 400 page appears when using http protocol to access 1 week ago
container feat: Add bootstrap support for skyline image 5 days ago
docs/api refactor: Streamline libs directory structure 5 days ago
etc feat: Add make build 5 days ago
libs fix: 400 page appears when using http protocol to access 2 days ago
skyline refactor: Move skyline-apiserver to libs 5 days ago
tools/git_config feat: Add initial code of skyline-apiserver 2 months ago
.dockerignore chore: Add make clean to clean up project directory 5 days ago
.flake8 feat: Add initial code of skyline-apiserver 2 months ago
.gitignore feat: Add initial code of skyline-apiserver 2 months ago
.gitmodules feat: Add skyline-console to submodule 2 weeks ago
.gitreview Added .gitreview 3 months ago
.zuul.yaml Add Zuul support for new repository 3 months ago
LICENSE feat: Add initial code of skyline-apiserver 2 months ago
Makefile chore: Add make clean to clean up project directory 5 days ago
README-zh_CN.md docs: Add quick start docs 4 days ago
README.md docs: Add quick start docs 4 days ago
mypy.ini chore: Add make clean to clean up project directory 5 days ago
poetry.lock refactor: Move skyline-apiserver to libs 5 days ago
poetry.toml feat: Add initial code of skyline-apiserver 2 months ago
pyproject.toml refactor: Move skyline-apiserver to libs 5 days ago

README.md

Skyline API

English | 简体中文

Skyline is an OpenStack dashboard optimized by UI and UE. It has a modern technology stack and ecology, is easier for developers to maintain and operate by users, and has higher concurrency performance.

Table of contents

Resources

Quick Start

Prerequisites

  • An OpenStack environment that runs at least core components and can access OpenStack components through Keystone endpoints
  • A Linux server with container engine (docker or podman) installed

Configure and deployment

1. Connect to database of the OpenStack environment and create the skyline database

$ mysql -u root -p
MariaDB [(none)]> CREATE DATABASE IF NOT EXISTS skyline DEFAULT CHARACTER SET utf8 DEFAULT COLLATE utf8_general_ci;
Query OK, 1 row affected (0.001 sec)

2. Grant proper access to the databases

Replace SKYLINE_DBPASS with a suitable password.

MariaDB [(none)]> GRANT ALL PRIVILEGES ON skyline.* TO 'skyline'@'localhost' IDENTIFIED BY 'SKYLINE_DBPASS';
Query OK, 0 rows affected (0.001 sec)

MariaDB [(none)]> GRANT ALL PRIVILEGES ON skyline.* TO 'skyline'@'%'  IDENTIFIED BY 'SKYLINE_DBPASS';
Query OK, 0 rows affected (0.001 sec)

3. Create skyline service credentials

# Source the admin credentials
$ source admin-openrc

# Create the skyline user
$ openstack user create --domain default --password-prompt skyline
User Password:
Repeat User Password:
+---------------------+----------------------------------+
| Field               | Value                            |
+---------------------+----------------------------------+
| domain_id           | default                          |
| enabled             | True                             |
| id                  | 1qaz2wsx3edc4rfv5tgb6yhn7ujm8ikl |
| name                | skyline                          |
| options             | {}                               |
| password_expires_at | 2020-08-08T08:08:08.123456       |
+---------------------+----------------------------------+

# Add the admin role to the skyline user:
$ openstack role add --project service --user skyline admin

4. Edit the /etc/skyline/skyline.yaml file in linux server

You can refer to the sample file, and modify the following parameters according to the actual environment

  • database_url
  • keystone_url
  • default_region
  • interface_type
  • system_project_domain
  • system_project
  • system_user_domain
  • system_user_name
  • system_user_password

5. Run the skyline_bootstrap container to bootstrap

docker run -d --name skyline_bootstrap -e KOLLA_BOOTSTRAP="" -v /etc/skyline/skyline.yaml:/etc/skyline/skyline.yaml --net=host skyline:latest

# Check bootstrap is normal `exit 0`
docker logs skyline_bootstrap

5. Run the skyline service after bootstrap is complete

docker rm -f skyline_bootstrap

docker run -d --name skyline --restart=always -v /etc/skyline/skyline.yaml:/etc/skyline/skyline.yaml --net=host skyline:latest

6. finish installation

You can now access the dashboard: https://<ip_address>:8080

Develop Skyline-apiserver

Support Linux & Mac OS (Recommend Linux OS) (Because uvloop & cython)

Dependent tools

Install & Run

1. Installing dependency packages

make install

2. Set skyline.yaml config file

cp etc/skyline.yaml.sample etc/skyline.yaml
export OS_CONFIG_DIR=$(pwd)/etc

Maybe you should change the params with your real environment as followed:

- database_url  (you can set sqlite:////tmp/skyline.db to use sqlite)
- keystone_url
- default_region
- interface_type
- system_project_domain
- system_project
- system_user_domain
- system_user_name
- system_user_password

3. Init skyline database

pushd /skyline/libs/skyline-apiserver/
make db_sync
popd

4. Run skyline-apiserver

$ poetry run uvicorn --reload --reload-dir libs/skyline-apiserver/skyline_apiserver --port 28000 --log-level debug skyline_apiserver.main:app

INFO:     Uvicorn running on http://127.0.0.1:28000 (Press CTRL+C to quit)
INFO:     Started reloader process [154033] using statreload
INFO:     Started server process [154037]
INFO:     Waiting for application startup.
INFO:     Application startup complete.

You can now access the online API documentation: http://127.0.0.1:28000/docs