OpenStack Horizon 快速入门教程

OpenStack Horizon 是一个开源的 Web 控制面板，它提供了图形化的界面来管理和操作 OpenStack 集群。本教程将引导你了解 Horizon 的目录结构、启动文件以及配置文件。

1. 项目目录结构及介绍

在 https://github.com/openstack/horizon.git 中，Horizon 项目的目录结构如下：

.
├──_horizon/        # 主要代码库，包括 Django 应用和模板
│   ├── djangoapps/   # Django 应用目录
│   └── static/       # 存放静态文件，如 CSS 和 JavaScript
├── contrib/        # 第三方贡献或额外功能
├── etc/            # 示例配置文件
├── tests/          # 单元测试和集成测试
└── setup.py         # Python 包安装脚本

• horizon/: 项目的核心代码，包含了 Django 应用和静态资源。
• djangoapps/: Django 应用，如 openstack_dashboard，提供各种管理界面。
• static/: 存储 CSS、JavaScript 和其他前端资源。
• contrib/: 可选组件和服务，可能包含社区贡献的额外功能。
• etc/: 提供示例配置文件，可以作为实际部署时的参考。
• tests/: 测试相关文件，包括单元测试和集成测试。
• setup.py: Python 包的安装脚本，用于构建和安装 Horizon。

2. 项目启动文件介绍

Horizon 使用 Django 框架，因此启动文件位于 horizon/openstack_dashboard/wsgi 目录下，主要文件是 application.py。这个文件是 WSGI 应用程序，负责加载 Django 配置并设置 Horizon 为入口点。

from django.core.wsgi import get_wsgi_application

os.environ.setdefault("DJANGO_SETTINGS_MODULE", "openstack_dashboard.settings")

application = get_wsgi_application()

在生产环境中，通常使用像 Apache 或 Nginx 这样的 web 服务器配置来调用 WSGI 启动 Horizon。

3. 项目配置文件介绍

Horizon 的配置主要通过 Django 的设置来完成，这些设置可以在 horizon/openstack_dashboard/settings.py 文件中找到。主要的配置项有：

• INSTALLED_APPS: 定义了 Django 中安装的应用，包括 Horizon 自身的应用和其他依赖应用。
• HORIZON_CONFIG: 用于定制 Horizon 行为的字典，比如默认主题、菜单结构等。
• OPENSTACK_HOST 和 OPENSTACK_API_VERSIONS: 用于连接 OpenStack 服务的主机地址和 API 版本。
• LOCALIZED_DATE_FORMAT 和 DATE_INPUT_FORMATS: 确定日期和时间的显示格式。

为了适应不同的环境，通常会创建一个单独的配置文件（例如 local_settings.py），并在 settings.py 文件中导入它，以避免修改原始设置文件。

try:
    from .local_settings import *
except ImportError:
    pass

在 local_settings.py 文件中，你可以覆盖任何 settings.py 中的配置，添加私有的数据库连接、密钥或其他敏感信息。

示例配置

local_settings.py

DEBUG = False
ALLOWED_HOSTS = ['yourdomain.com']

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'horizon_db',
        'USER': 'horizon_user',
        'PASSWORD': 'your_password',
        'HOST': 'localhost',
        'PORT': '',
    }
}

HORIZON_CONFIG = {
    'dashboards': ('project', 'admin'),
    'default_dashboard': 'project',
    'customization': {
        'menu_sections': [('access_and_security', 'security')]
    },
}

以上只是一个简单的例子，实际的配置可能会更复杂，需要根据你的 OpenStack 部署情况进行调整。

至此，你已对 Horizon 的基本结构和配置有了初步理解。接下来，你可以设置开发环境，按照官方文档或本文档中的指导进行安装和配置。记得在实际部署之前，先进行充分的测试和验证。