Як встановити CockroachDB на AlmaLinux

У ландшафті систем управління базами даних, що постійно розвивається, CockroachDB стала потужним і стійким рішенням для сучасних додатків. Відома своєю масштабованістю, високою узгодженістю і розподіленою архітектурою, CockroachDB є чудовим вибором для підприємств, які прагнуть обробляти великі обсяги транзакцій і забезпечувати цілісність даних на декількох вузлах.

Ми вже розповідали про встановлення CockroachDB на Ubuntu. Ви можете подивитися цю статтю за посиланням нижче:

Як встановити кластер CockroachDB на Ubuntu

Необхідні умови

Сервер під управлінням однієї з таких операційних систем: AlmaLinux 9.
Рекомендується використовувати свіжу інсталяцію ОС, щоб запобігти можливим проблемам.
SSH-доступ до сервера (або просто відкрийте Terminal, якщо ви працюєте на робочому столі).
Активне підключення до Інтернету. Інтернет-з’єднання знадобиться для завантаження необхідних пакетів і залежностей.
Для роботи CockroachDB потрібно мінімум 2 ядра процесора і 4 ГБ оперативної пам’яті. Однак для оптимальної продуктивності рекомендується мати щонайменше 4 ядра процесора і 8 ГБ оперативної пам’яті, особливо у виробничих середовищах.
Для встановлення Bpftool і внесення загальносистемних змін вам знадобляться права root або sudo. Переконайтеся, що у вас є необхідні права перед початком процесу встановлення.

Встановлення CockroachDB на AlmaLinux 9

Крок 1. Оновіть систему.

Щоб процес встановлення пройшов гладко, рекомендується оновити систему AlmaLinux 9 до останньої версії. Відкрийте термінал і виконайте таку команду:

sudo dnf clean all
sudo dnf update

Ця команда оновить усі встановлені пакети до останніх версій, включно з усіма виправленнями безпеки та помилками.

Крок 2. Встановлення необхідних залежностей.

Для правильної роботи CockroachDB потрібно кілька додаткових залежностей. Встановіть їх, виконавши таку команду:

sudo dnf install wget curl tar

Крок 3. Встановлення CockroachDB.

Відкрийте веб-браузер і перейдіть на офіційну сторінку завантаження CockroachDB. На цій сторінці представлена остання стабільна версія CockroachDB для систем Linux.

На сторінці завантаження знайдіть розділ «Linux» і скопіюйте посилання на завантаження останньої стабільної версії. На момент написання статті останньою стабільною версією є v22.1.11. Використовуйте таку команду для завантаження бінарного файлу CockroachDB за допомогою wget:

wget https://binaries.cockroachdb.com/cockroach-v22.1.11.linux-amd64.tgz

Щоб переконатися в цілісності завантаженого файлу, ви можете порівняти контрольну суму завантаженого архіву з контрольною сумою, зазначеною на сторінці завантаження. Виконайте таку команду, щоб обчислити контрольну суму SHA256 завантаженого файлу:

sha256sum cockroach-v22.1.11.linux-amd64.tgz

Порівняйте згенеровану контрольну суму з тією, що вказана на сторінці завантаження, щоб переконатися, що файл було завантажено правильно.

Потім за допомогою команди tar розпакуйте завантажений архів:

tar -xvf cockroach-v22.1.11.linux-amd64.tgz

Перейдіть у розпакований каталог і перемістіть двійковий файл CockroachDB у системний шлях, наприклад /usr/local/bin, щоб зробити його доступним для всієї системи:

cd cockroach-v22.1.11.linux-amd64
sudo mv cockroach /usr/local/bin/

Щоб переконатися, що двійковий файл CockroachDB має необхідні дозволи для запуску, виконайте наступну команду:

sudo chmod +x /usr/local/bin/cockroach

Щоб перевірити правильність встановлення CockroachDB, виконайте наступну команду:

cockroach version

Крок 4. Ініціалізація кластера CockroachDB.

Встановивши CockroachDB, давайте ініціалізуємо одновузловий кластер:

Виберіть каталог, у якому CockroachDB зберігатиме свої дані. Наприклад, ви можете створити каталог з ім’ям cockroach-data у своєму домашньому каталозі:

mkdir ~/cockroach-data

Щоб запустити одновузловий кластер CockroachDB, виконайте таку команду:

cockroach start-single-node --insecure --listen-addr=localhost --background

Щоб кластер CockroachDB автоматично запускався під час завантаження системи, ви можете створити службу systemd. Створіть файл з ім’ям cockroachdb.service у каталозі /etc/systemd/system з таким вмістом:

[Unit]
Description=CockroachDB
After=network.target

[Service]
Type=simple
ExecStart=/usr/local/bin/cockroach start-single-node --insecure --listen-addr=localhost
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

Збережіть файл і виконайте наступні команди, щоб увімкнути та запустити службу:

sudo systemctl enable cockroachdb.service
sudo systemctl start cockroachdb.service

Крок 5. Налаштування CockroachDB.

Тепер, коли кластер CockroachDB запущено, давайте виконаємо деякі базові налаштування:

Для взаємодії з кластером CockroachDB ви можете використовувати вбудовану оболонку SQL. Для доступу до оболонки виконайте таку команду:

cockroach sql --insecure

В оболонці SQL створіть нового користувача, виконавши такий оператор SQL:

CREATE USER myuser WITH PASSWORD 'mypassword';

Щоб створити нову базу даних, виконайте такий оператор SQL:

CREATE DATABASE mydb;

Щоб дозволити новоствореному користувачеві доступ до бази даних і внесення до неї змін, надайте йому необхідні привілеї:

GRANT ALL ON DATABASE mydb TO myuser;

Щоб вийти з оболонки CockroachDB SQL, введіть q і натисніть Enter.

Крок 6. Тестування встановлення.

Давайте виконаємо кілька основних тестів, щоб переконатися, що встановлення CockroachDB працює правильно:

Знову зайдіть в оболонку CockroachDB SQL, цього разу використовуючи щойно створеного користувача:

cockroach sql --insecure --user=myuser --database=mydb

Усередині оболонки SQL виконайте кілька основних команд SQL для взаємодії з базою даних. Наприклад:

CREATE TABLE users (id INT PRIMARY KEY, name STRING);
INSERT INTO users (id, name) VALUES (1, 'Mey Shela');
SELECT * FROM users;

Ці команди створять нову таблицю з ім’ям users, вставлять у неї рядок і витягнуть дані.

Крок 7. Налаштуйте брандмауер.

Щоб дозволити CockroachDB взаємодіяти з іншими вузлами та клієнтами, необхідно налаштувати брандмауер на дозвіл необхідного трафіку. Виконайте такі команди, щоб відкрити необхідні порти:

sudo firewall-cmd --permanent --add-port=26257/tcp
sudo firewall-cmd --permanent --add-port=8080/tcp
sudo firewall-cmd --reload

Ці команди відкриють порт 26257 для міжвузлового зв’язку і порт 8080 для веб-інтерфейсу CockroachDB.

Крок 8. Перевірте веб-інтерфейс CockroachDB.

CockroachDB надає веб-інтерфейс для моніторингу та управління кластером. Відкрийте веб-браузер і перейдіть за адресою http://localhost:8080. Ви маєте побачити веб-інтерфейс CockroachDB, що відображає огляд кластера і метрики.

Вітаємо! Ви успішно встановили CockroachDB. Для отримання додаткової допомоги або корисної інформації ми рекомендуємо вам відвідати офіційний сайт CockroachDB.