Перейти к содержанию
Скачать
Скачать

Установка Picodata

Данный раздел содержит сведения об установке Picodata из готовых пакетов, а также сборке продукта из исходного кода.

Обзор доступных сборок

Мы предоставляем готовые пакеты с Picodata для следующих операционных систем:

Готовые пакеты можно установить как через добавление репозиториев, так и скачав напрямую — см. инструкции для отдельных дистрибутивов ниже. Имейте в виду, что готовые пакеты имеют в качестве "мягкой" зависимости компонент PostgreSQL, содержащий psql — рекомендуемое приложение для подключения к Picodata. Это означает, что пакетный менеджер ОС может установить вместе с Picodata также и пакет с psql.

Picodata также развивает свой форк Tarantool, который имеет ряд технологических отличий от стандартного Tarantool, в том числе поддержку кластерного SQL и дополнительные Rust API. Скачать нашу версию Tarantool вы также можете по инструкциям ниже.

Также доступны:

См. также:

Примечание

Действия по настройке репозиториев Picodata и установке готовых пакетов следует производить в терминале с правами администратора. Авторизуйтесь под пользователем root или повысьте привилегии через sudo -i.

Инструкции для дистрибутивов Linux

RHEL 8/Rocky 8

Импортируйте ключ репозитория Picodata, используя следующую команду в терминале (здесь и далее команды следует вводить с правами администратора):

rpm --import https://download.picodata.io/tarantool-picodata/picodata.gpg.key

Подключите репозиторий:

dnf install https://download.picodata.io/tarantool-picodata/el/8/x86_64/picodata-release-1.1.3.0-1.el8.x86_64.rpm

После успешного выполнения команды в вашей системе появится дополнительный репозиторий в /etc/yum.repos.d/picodata.repo.

Установите пакет Picodata, скопировав и вставив в терминал следующие команды:

dnf clean all
dnf install -y picodata

Для того чтобы установить только пакет с нашей версией Tarantool, введите следующую команду:

dnf install -y tarantool-picodata

RHEL 9/Rocky 9

Создайте файл /etc/yum.repos.d/picodata.repo:

echo '
[picodata]
name=Picodata Yum Repo
baseurl=https://binary.picodata.io/repository/yum/el/$releasever/$basearch/RELEASE
enabled=1
gpgcheck=0'  > /etc/yum.repos.d/picodata.repo

Установите Picodata (здесь и далее команды следует вводить с правами администратора):

dnf install -y picodata

Для того чтобы установить только пакет с нашей версией Tarantool, введите следующую команду:

dnf install -y tarantool-picodata

Fedora 39–43

Создайте файл /etc/yum.repos.d/picodata.repo:

echo '
[picodata]
name=Picodata Yum Repo
baseurl=https://binary.picodata.io/repository/yum/fedora/$releasever/$basearch/RELEASE
enabled=1
gpgcheck=0'  > /etc/yum.repos.d/picodata.repo

Установите Picodata (здесь и далее команды следует вводить с правами администратора):

dnf install -y picodata

Для того чтобы установить только пакет с нашей версией Tarantool, введите следующую команду:

dnf install -y tarantool-picodata

РЕД ОС/RED OS 7.3 “Муром”

Импортируйте ключ репозитория Picodata, используя следующую команду в терминале (здесь и далее команды следует вводить с правами администратора):

rpm --import https://download.picodata.io/tarantool-picodata/picodata.gpg.key

Подключите репозиторий:

dnf install https://download.picodata.io/tarantool-picodata/redos/7/x86_64/picodata-release-1.1.3.0-1.el7.x86_64.rpm

После успешного выполнения команды в вашей системе появится дополнительный репозиторий в /etc/yum.repos.d/picodata.repo.

Установите пакет Picodata, скопировав и вставив в терминал следующие команды:

dnf clean all
dnf install -y picodata

Для того чтобы установить только пакет с нашей версией Tarantool, введите следующую команду:

dnf install -y tarantool-picodata

Astra Linux 1.7/1.8 SE

Подключите репозиторий Picodata, используя следующие команды в терминале (здесь и далее команды следует вводить с правами администратора):

apt-get update
apt-get install -y --no-install-recommends gpg curl apt-transport-https software-properties-common
curl -s https://download.picodata.io/tarantool-picodata/picodata.gpg.key | gpg --no-default-keyring --keyring gnupg-ring:/etc/apt/trusted.gpg.d/picodata.gpg --import
chmod 644 /etc/apt/trusted.gpg.d/picodata.gpg

Создайте файл /etc/apt/sources.list.d/picodata.list.

Для версии 1.7 SE:

echo '
deb [arch=amd64] https://download.picodata.io/tarantool-picodata/astra/ 1.7 main
' > /etc/apt/sources.list.d/picodata.list

Для версии 1.8 SE:

echo '
deb [arch=amd64] https://download.picodata.io/tarantool-picodata/astra/ 1.8 main
' > /etc/apt/sources.list.d/picodata.list

Обновите список источников:

apt-get update

Установите пакет Picodata, скопировав и вставив в терминал следующую команду:

apt install picodata
` Для того чтобы установить только пакет с нашей версией Tarantool, введите следующую команду:

apt install tarantool-picodata

Для работы в режиме Замкнутой программной среды (ЗПС) выполните дополнительную команду:

curl -s https://download.picodata.io/tarantool-picodata/astra/picodata_pub.key -o /etc/digsig/keys/picodata_pub.key

После этого потребуется перезагрузка.

Debian 11–13

Подключите репозиторий Picodata, используя следующие команды в терминале (здесь и далее команды следует вводить с правами администратора):

curl -s https://download.picodata.io/tarantool-picodata/picodata.gpg.key | gpg --no-default-keyring --keyring gnupg-ring:/etc/apt/trusted.gpg.d/picodata.gpg --import
chmod 644 /etc/apt/trusted.gpg.d/picodata.gpg

Создайте файл /etc/apt/sources.list.d/picodata.list:

. /etc/os-release
echo "
deb [arch=amd64] https://download.picodata.io/tarantool-picodata/debian/ $VERSION_CODENAME main
" > /etc/apt/sources.list.d/picodata.list

Обновите список источников:

apt-get update

Установите пакет Picodata, скопировав и вставив в терминал следующую команду:

apt install picodata

Для того чтобы установить только пакет с нашей версией Tarantool, введите следующую команду:

apt install tarantool-picodata

Ubuntu 20.04, 22.04, 24.04

Подключите репозиторий Picodata, используя следующие команды в терминале (здесь и далее команды следует вводить с правами администратора):

curl -s https://download.picodata.io/tarantool-picodata/picodata.gpg.key | gpg --no-default-keyring --keyring gnupg-ring:/etc/apt/trusted.gpg.d/picodata.gpg --import
chmod 644 /etc/apt/trusted.gpg.d/picodata.gpg

Создайте файл /etc/apt/sources.list.d/picodata.list:

. /etc/os-release
echo "
deb [arch=amd64] https://download.picodata.io/tarantool-picodata/ubuntu/ $VERSION_CODENAME main
" > /etc/apt/sources.list.d/picodata.list

Обновите список источников:

apt-get update

Установите пакет Picodata, скопировав и вставив в терминал следующую команду:

apt install picodata

Для того чтобы установить только пакет с нашей версией Tarantool, введите следующую команду:

apt install tarantool-picodata

Alt Linux (платформа p10)

Подключите репозиторий Picodata, используя следующие команды в терминале (здесь и далее команды следует вводить с правами администратора)):

wget https://download.picodata.io/tarantool-picodata/altlinux/p10/picodata-release-1.0.3.0-1.p10.x86_64.rpm
apt-get install -y ./picodata-release-1.0.3.0-1.p10.x86_64.rpm
curl -s https://download.picodata.io/tarantool-picodata/picodata.gpg.key | gpg --no-default-keyring --keyring gnupg-ring:/usr/lib/alt-gpgkeys/pubring.gpg --import

Обновите список источников:

apt-get update

Установите пакет Picodata, скопировав и вставив в терминал следующую команду:

apt-get install picodata

Для того чтобы установить только пакет с нашей версией Tarantool, введите следующую команду:

apt-get install tarantool-picodata

ROSA Chrome (платформа 2021.1)

Подключите репозиторий Picodata, используя следующие команды в терминале (здесь и далее команды следует вводить с правами администратора)):

rpm --import https://download.picodata.io/tarantool-picodata/picodata.gpg.key
dnf install https://download.picodata.io/tarantool-picodata/rosa/chrome/x86_64/picodata-release-1.1.3.0-1-rosa2021.1.x86_64.rpm

Установите пакет Picodata, скопировав и вставив в терминал следующую команду:

dnf install picodata

Для того чтобы установить только пакет с нашей версией Tarantool, введите следующую команду:

dnf install tarantool-picodata

Ночные сборки

Подключите репозиторий ночных сборок с помощью следующей команды:

curl -L https://download.binary.picodata.io/tarantool-picodata/install.sh | bash

Внимание

Одновременное использование репозиториев Picodata для релизных сборок и ночных невозможно!

Docker-образы

Доступны Docker-образы с Picodata, в том числе, distroless:

docker.binary.picodata.io/picodata:latest
docker.binary.picodata.io/picodata:<номер версии>
docker.binary.picodata.io/picodata:<номер версии>-distroless

Сборка из мастера:

docker.binary.picodata.io/picodata:master
docker.binary.picodata.io/picodata:master-distroless

Примеры команд:

docker pull docker.binary.picodata.io/picodata:25.2.1
docker pull docker.binary.picodata.io/picodata:25.1.1-distroless
docker pull docker.binary.picodata.io/picodata:master

Образы собраны на базе ОС Rocky Linux 8.

Установка из исходного кода

Вы можете также собрать Picodata из исходного кода в Linux и macOS, используя инструкции ниже.

Необходимые инструменты

  • Rust и Cargo 1.89 или новее
  • cmake 3.16 или новее
  • gcc, g++
  • libstdc++-static
  • openssl
  • NodeJS и Yarn (требуются для работы веб-интерфейса Picodata)

Установка Rust и Cargo универсальна для всех поддерживаемых ОС:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source "$HOME/.cargo/env"

Установка зависимостей для сборки

Далее приведены команды для установки остальных зависимостей под разные ОС.

RHEL 8/9 и деривативы, Fedora 39-43

Только для ОС, основанных на RHEL 8/9: 

sudo dnf config-manager --set-enabled powertools
Установка общих зависимостей для сборки: 
sudo dnf in -y gcc gcc-c++ make perl automake libtool cmake git patch libstdc++-static openssl-devel
Установка NodeJS и Yarn: 
curl -sL https://rpm.nodesource.com/setup_lts.x | sudo bash -
curl -sL https://dl.yarnpkg.com/rpm/yarn.repo | sudo tee /etc/yum.repos.d/yarn.repo
sudo dnf install yarn nodejs

Ubuntu 22.04 и 24.04

Установка общих зависимостей для сборки: 

sudo apt-get install build-essential git cmake autoconf libtool curl libssl-dev pkg-config -y
Установка NodeJS и Yarn: 
curl -sL https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -
echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list
sudo apt install yarn npm -y
sudo curl --compressed -o- -L https://yarnpkg.com/install.sh | bash

Alt Server p10

Установка общих зависимостей для сборки: 

su -
apt-get install -y gcc gcc-c++ cmake git patch libstdc++-devel-static libgomp-devel-static libssl-devel-static
Установка NodeJS и Yarn: 
su -
apt-get install -y node yarn

macOS

Сборка под macOS почти не отличается от таковой в Linux. Потребуется macOS 10.15 Catalina, либо более новая версия (11+). Для начала следует установить актуальные версии Rust и Cargo.
Для работы веб-интерфейса Picodata следует установить дополнительно NodeJS и Yarn при помощи пакетного менеджера Brew.
Установка Brew: 

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Установка NodeJS и Yarn: 
brew install node yarn

Получение исходного кода

Загрузка с Gitlab:

git clone https://git.picodata.io/core/picodata.git --recursive

Загрузка с зеркала GitHub:

git clone https://github.com/picodata/picodata.git --recursive

Сборка

Используйте приведенные ниже команды для сборки Picodata. Для получения debug-версии:

make build

Для получения release-версии:

make build-release-pkg

Исполняемый файл picodata появится в директории target/debug или target/release соответственно. Далее его следует скопировать в директорию, входящую в $PATH, например в /usr/bin или /usr/local/bin.

Проверка установки

Когда программное обеспечение Picodata установлено, то можно проверить наличие в системе основного исполняемого файла picodata, используя следующую команду:

which picodata

Ответом на нее должно быть значение /usr/bin/picodata, либо — если вы устанавливали ПО вручную с другим префиксом — иное расположение, включенное в $PATH. Чтобы убедиться в работоспособности ПО, а также посмотреть его версию, используйте следующую команду:

picodata --help

В состав ПО также включены юнит-тесты, позволяющие проверить работоспособность основных функций. Юнит-тесты можно запустить следующей командой:

picodata test

Пример вывода команды:

running 6 tests
test test_traft_pool ... ok
test test_storage_peers ... ok
test test_storage_state ... ok
test test_storage_log ... ok
test test_mailbox ... ok
test test_version ... ok

test result: ok. 6 passed; 0 failed; finished in 0.88s

Обновление Picodata

См. Обновление кластера.

Удаление Picodata

Порядок действий для удаления Picodata:

  • перед удалением необходимо остановить и вывести из кластера все запущенные на данном хосте инстансы Picodata
  • для каждого инстанса требуется удалить его рабочие файлы. Например: rm -rf *.xlog *.vylog *.snap *.sock
  • если Picodata была установлена из готового пакета для определенной ОС, то следует удалить этот пакет, используя системный менеджер пакетов (например, sudo apt remove picodata или sudo dnf remove picodata)
  • если Picodata была собрана из исходного кода, то необходимо удалить исполняемый файл picodata. Если этот файл был ранее помещен в одну из директорий, входящих в $PATH, то следует явно удалить его оттуда: sudo rm -rf $(which picodata). После этого следует удалить директорию с Git-репозиторием Picodata
  • после удаления следует удостовериться, что команда which picodata сигнализирует об отсутствии исполняемого файла picodata в $PATH

См. также: