skyline-apiserver 5.0.0

先决条件

• 至少运行核心组件并可以通过Keystone端点访问OpenStack组件的OpenStack环境

• 安装了容器引擎的Linux服务器（docker 或 podman）

配置

1. 编辑Linux服务器上的/etc/skyline/skyline.yaml文件

   您可以参考示例文件，并根据实际环境修改以下参数

   • database_url

   • keystone_url

   • default_region

   • interface_type

   • system_project_domain

   • system_project

   • system_user_domain

   • system_user_name

   • system_user_password

使用SQLite进行部署

1. 运行skyline_bootstrap容器以进行初始化

   rm -rf /tmp/skyline && mkdir /tmp/skyline && mkdir /var/log/skyline
   
   docker run -d --name skyline_bootstrap -e KOLLA_BOOTSTRAP="" -v /var/log/skyline:/var/log/skyline -v /etc/skyline/skyline.yaml:/etc/skyline/skyline.yaml -v /tmp/skyline:/tmp --net=host 99cloud/skyline:latest
   
   # Check bootstrap is normal `exit 0`
   docker logs skyline_bootstrap

2. 初始化完成后运行skyline服务

   docker rm -f skyline_bootstrap

   如果您需要修改skyline端口，请在以下命令中添加-e LISTEN_ADDRESS=<ip:port>

   LISTEN_ADDRESS默认为0.0.0.0:9999

   如果您需要修改服务的策略规则，请在以下命令中添加-v /etc/skyline/policy:/etc/skyline/policy

   将服务策略yaml文件重命名为<service_name>_policy.yaml，并将其放置在/etc/skyline/policy文件夹中

   docker run -d --name skyline --restart=always -v /var/log/skyline:/var/log/skyline -v /etc/skyline/skyline.yaml:/etc/skyline/skyline.yaml -v /tmp/skyline:/tmp --net=host 99cloud/skyline:latest

使用MariaDB进行部署

https://docs.openstack.org/skyline-apiserver/latest/install/docker-install-ubuntu.html

API文档

您可以通过访问API文档 https://<ip_address>:9999/api/openstack/skyline/docs

测试访问

您现在可以访问仪表板： https://<ip_address>:9999

依赖工具

使用python37和uvloop（0.15.0+需要python37）的新功能上下文变量。考虑到大多数系统不支持python37，我们选择至少支持python38。

• make >= 3.82

• python >= 3.8

• node >= 10.22.0（如果您仅使用apiserver进行开发则为可选）

• yarn >= 1.22.4（如果您仅使用apiserver进行开发则为可选）

安装 & 运行

1. 安装依赖包

   tox -e venv

2. 设置skyline.yaml配置文件

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

   您可能需要根据以下您的实际环境更改参数

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

   如果您将sqlite:////tmp/skyline.db设置为database_url，则按以下方式操作。如果您将mysql://root:root@localhost:3306/skyline设置为database_url，则首先应参考第1章和第2节的部署MariaDB步骤。

3. 初始化skyline数据库

   source .tox/venv/bin/activate
   make db_sync
   deactivate

4. 运行skyline-apiserver

   $ source .tox/venv/bin/activate
   $ uvicorn --reload --reload-dir 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.

   您现在可以访问在线API文档： http://127.0.0.1:28000/docs。

   或者，您可以使用vscode的.vscode/launch.json启动调试器。

5. 构建镜像

   make build