Установка ClickHouse в Debian/Ubuntu

Установка ClickHouse в Debian/Ubuntu Linux

Рекомендуется использовать официальные предварительно собранные deb-пакеты для Debian или Ubuntu.

1. ​

   Ознакомьтесь с рекомендациями

   Перед установкой ClickHouse ознакомьтесь со следующими рекомендациями:

   • Swap: В рабочей среде отключите файл подкачки операционной системы.
   • Disk space: Для установки бинарного файла ClickHouse требуется не менее 2,5 ГБ дискового пространства.
   • Network: Для распределённых развертываний (кластеризации) используйте сетевое подключение со скоростью не менее 10 Гбит/с. Пропускная способность сети критически важна для выполнения распределённых запросов с большими объёмами промежуточных данных, а также для репликации.

   Оценка требований к хранилищу

   Чтобы оценить, сколько дискового пространства потребуется для ваших данных:

   1. Оцените объём данных: Возьмите выборку данных и вычислите средний размер строки, затем умножьте его на количество строк, которое вы планируете хранить.
   2. Примените коэффициент сжатия: Загрузите выборку в ClickHouse и сравните исходный размер данных с размером сохранённой таблицы. Например, clickstream-данные обычно сжимаются в 6–10 раз.
   3. Учтите реплики: Если вы планируете хранить данные в нескольких репликах, умножьте расчётный объём на количество реплик.

   Более подробные требования к оборудованию см. в разделе “Рекомендации по выбору размера и оборудования”

2. ​

   Настройте репозиторий Debian

   Чтобы установить ClickHouse, выполните следующие команды:

   # Установите необходимые пакеты
   sudo apt-get install -y apt-transport-https ca-certificates curl gnupg
   
   # Загрузите GPG-ключ ClickHouse и сохраните его в keyring
   curl -fsSL 'https://packages.clickhouse.com/rpm/lts/repodata/repomd.xml.key' | sudo gpg --dearmor -o /usr/share/keyrings/clickhouse-keyring.gpg
   
   # Определите архитектуру системы
   ARCH=$(dpkg --print-architecture)
   
   # Добавьте репозиторий ClickHouse в источники apt
   echo "deb [signed-by=/usr/share/keyrings/clickhouse-keyring.gpg arch=${ARCH}] https://packages.clickhouse.com/deb stable main" | sudo tee /etc/apt/sources.list.d/clickhouse.list
   
   # Обновите списки пакетов apt
   sudo apt-get update
   

   • Вы можете заменить stable на lts, чтобы использовать разные типы релизов в зависимости от ваших задач.
   • Вы можете скачать и установить пакеты вручную с packages.clickhouse.com.

   
   

   Старый способ установки deb-пакетов для старых дистрибутивов

   # Установите необходимые пакеты
   sudo apt-get install apt-transport-https ca-certificates dirmngr
   
   # Добавьте GPG-ключ ClickHouse для проверки подлинности пакетов
   sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 8919F6BD2B48D754
   
   # Добавьте репозиторий ClickHouse в источники apt
   echo "deb https://packages.clickhouse.com/deb stable main" | sudo tee \
       /etc/apt/sources.list.d/clickhouse.list
       
   # Обновите списки пакетов apt
   sudo apt-get update
   
   # Установите пакеты сервер ClickHouse и client
   sudo apt-get install -y clickhouse-server clickhouse-client
   
   # Запустите сервис сервер ClickHouse
   sudo service clickhouse-server start
   
   # Запустите клиент командной строки ClickHouse
   clickhouse-client # или "clickhouse-client --password", если вы настроили пароль.
   
3. ​

   Установите сервер ClickHouse и client

   sudo apt-get install -y clickhouse-server clickhouse-client
   
4. ​

   Запустите ClickHouse

   Чтобы запустить сервер ClickHouse, выполните:

   sudo service clickhouse-server start
   

   Чтобы запустить клиент ClickHouse, выполните:

   clickhouse-client
   

   Если для сервера настроен пароль, выполните:

   clickhouse-client --password
   
5. ​

   Установите автономный ClickHouse Keeper

   В средах продакшн мы настоятельно рекомендуем запускать ClickHouse Keeper на выделенных узлах. В тестовых средах, если вы решите запускать ClickHouse Server и ClickHouse Keeper на одном сервере, устанавливать ClickHouse Keeper не нужно, так как он входит в состав сервер ClickHouse.

   Чтобы установить clickhouse-keeper на серверах с автономным ClickHouse Keeper, выполните:

   sudo apt-get install -y clickhouse-keeper
   
6. ​

   Включите и запустите ClickHouse Keeper

   sudo systemctl enable clickhouse-keeper
   sudo systemctl start clickhouse-keeper
   sudo systemctl status clickhouse-keeper
   

​

Пакеты

Ниже приведено описание доступных deb-пакетов:

Package	Description
clickhouse-common-static	Устанавливает скомпилированные бинарные файлы ClickHouse.
clickhouse-server	Создает символическую ссылку для clickhouse-server и устанавливает серверную конфигурацию по умолчанию.
clickhouse-client	Создает символическую ссылку для clickhouse-client и других инструментов клиента, а также устанавливает файлы конфигурации клиента.
clickhouse-common-static-dbg	Устанавливает скомпилированные бинарные файлы ClickHouse с отладочной информацией.
clickhouse-keeper	Используется для установки ClickHouse Keeper на выделенных узлах ClickHouse Keeper. Если ClickHouse Keeper работает на том же сервере, что и сервер ClickHouse, устанавливать этот пакет не нужно. Устанавливает ClickHouse Keeper и файлы конфигурации ClickHouse Keeper по умолчанию.

Если вам нужно установить определенную версию ClickHouse, необходимо установить все пакеты одной и той же версии: sudo apt-get install clickhouse-server=21.8.5.7 clickhouse-client=21.8.5.7 clickhouse-common-static=21.8.5.7