Установка Liteset из PyPI
На этой странице описана установка Liteset через пакет liteset, опубликованный на PyPI.
pip install liteset— устанавливает Liteset 6.0.0, асинхронный порт (Litestar/Uvicorn). Эта страница.pip install apache_superset— устанавливает upstream Apache Superset 6.0.0 (Flask/Gunicorn). См. инструкцию Apache Superset PyPI.
OS-зависимости на этой странице применимы к обоим пакетам.
OS-зависимости
Liteset хранит информацию о подключениях к БД в БД метаданных. Для шифрования паролей подключений используется библиотека cryptography, у которой есть зависимости уровня ОС.
Debian / Ubuntu
В Ubuntu 24.04 по умолчанию идёт Python 3.12, который пока не поддерживается. Установите вторую версию Python 3.11 и нужные пакеты:
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
sudo apt install python3.11 python3.11-dev python3.11-venv build-essential libssl-dev libffi-dev libsasl2-dev libldap2-dev default-libmysqlclient-dev
В Ubuntu 20.04 и 22.04 установите зависимости так:
sudo apt-get install build-essential libssl-dev libffi-dev python3-dev python3-pip libsasl2-dev libldap2-dev default-libmysqlclient-dev
В Ubuntu до 20.04:
sudo apt-get install build-essential libssl-dev libffi-dev python-dev python-pip libsasl2-dev libldap2-dev default-libmysqlclient-dev
Fedora и RHEL-производные дистрибутивы
Через yum:
sudo yum install gcc gcc-c++ libffi-devel python-devel python-pip python-wheel openssl-devel cyrus-sasl-devel openldap-devel
В свежих CentOS / Fedora — чере з dnf и слегка другим набором пакетов:
sudo dnf install gcc gcc-c++ libffi-devel python3-devel python3-pip python3-wheel openssl-devel cyrus-sasl-devel openldap-devel
В CentOS может потребоваться обновить pip:
pip3 install --upgrade pip
Mac OS X
Если у вас не самая свежая OS X — рекомендуем обновиться: многие проблемы пользователей упираются в старые версии. После обновления установите свежие command line tools XCode:
xcode-select --install
Не рекомендуется ис пользовать системный Python. Поставьте homebrew, затем:
brew install readline pkg-config libffi openssl mysql postgresql@14
Поставьте свежий Python. Список поддерживаемых версий — в pyproject.toml (3.10–3.13). Рекомендуем менеджер версий Python — pyenv (и pyenv-virtualenv).
Обновите pip и setuptools:
pip install --upgrade setuptools pip
Для некоторых Python-пакетов могут понадобиться LDFLAGS и CFLAGS:
export LDFLAGS="-L$(brew --prefix openssl)/lib"
export CFLAGS="-I$(brew --prefix openssl)/include"
Они будут видны pip'у при установке зависимостей.
Виртуальное окружение Python
Настоятельно рекомендуем устанавливать Liteset внутри виртуального окружения.
Создание и активация (убедитесь, что используете подходящую версию Python — может потребоваться явно python3.11 вместо python3):
# Начиная с Python 3.6 virtualenv поставляется как venv.
# https://docs.python.org/3.6/library/venv.html
python3 -m venv venv
. venv/bin/activate
Или через pyenv-virtualenv:
# Назовём виртуальное окружение 'liteset'
pyenv virtualenv liteset
pyenv activate liteset
После активации виртуального окружения все Python-пакеты, которые вы устанавливаете или удаляете, будут жить только в нём. Выйти можно командой deactivate.
Установка и инициализация Liteset
Сначала установите liteset:
pip install liteset
Затем задайте обязательную конфигурацию — SECRET_KEY и точку входа:
export SUPERSET_SECRET_KEY=YOUR-SECRET-KEY # Для продакшена — сильный ключ, например `openssl rand -base64 42`. См. /docs/configuration/configuring-superset#specifying-a-secret_key
export FLASK_APP=superset
Инициализируйте БД:
superset db upgrade
Завершите установку:
# Создать админа в БД метаданных (имя `admin` нужно, чтобы загрузить примеры)
superset fab create-admin
# Загрузить примеры данных
superset load_examples
# Создать стандартные роли и разрешения
superset init
# Запустить dev-сервер на 8088 (для другого порта используйте -p)
superset run -p 8088 --with-threads --reload --debugger
Если всё прошло успешно — откройте в браузере hostname:port (по умолчанию localhost:8088) и войдите под созданными логином/паролем.