Настройка и использование репозитория пакетов MariaDB

Если вы хотите установить сервер MariaDB, часто проще использовать репозиторий. Фонд MariaDB имеет инструмент конфигурации репозитория по адресу https://mariadb.org/download/, а компания MariaDB предоставляет удобный скрипт оболочки для настройки доступа к своим репозиториям пакетов MariaDB. Он доступен по адресу:

• https://r.mariadb.com/downloads/mariadb_repo_setup

Скрипт по умолчанию настраивает 3 различных репозитория в одном файле конфигурации репозитория. Репозитории:

• Репозиторий сервера MariaDB
• Репозиторий MariaDB MaxScale
• Репозиторий инструментов MariaDB

Скрипт может быть выполнен следующим образом:

curl -LsS https://r.mariadb.com/downloads/mariadb_repo_setup | sudo bash

Для работы скрипта необходимо установить пакеты curl и ca-certificates на вашей системе. Кроме того, на системах Debian и Ubuntu необходимо установить пакет apt-transport-https. Скрипт проверит наличие этих пакетов и сообщит вам об этом перед попыткой создания конфигурации репозитория на вашей системе.

Репозитории

Скрипт будет настраивать 2 различных репозитория в одном файле конфигурации репозитория.

Репозиторий MariaDB

Репозиторий MariaDB содержит пакеты программного обеспечения, относящиеся к серверу MariaDB, включая сам сервер, клиенты и утилиты, библиотеки клиентов, плагины и Mariabackup.

Бинарные файлы в Репозитории MariaDB компании MariaDB в настоящее время идентичны бинарным файлам в Репозитории MariaDB Фонда MariaDB, который настроен с помощью Инструмента конфигурации репозитория MariaDB.

По умолчанию скрипт настраивает вашу систему для установки из репозитория последней версии GA MariaDB. В настоящее время это MariaDB 10.7. Если произойдет выпуск новой основной версии GA, и вы хотите обновиться до нее, вам необходимо либо вручную изменить файл конфигурации репозитория, чтобы указать новую версию, либо снова запустить скрипт настройки репозитория пакетов MariaDB.

Скрипт также может настроить вашу систему для установки из репозитория другой версии MariaDB, если вы используете опцию --mariadb-server-version.

Если вы не хотите настраивать Репозиторий MariaDB на вашей системе, вы можете использовать опцию --skip-server, чтобы предотвратить настройку репозитория пакетов MariaDB.

Репозиторий MariaDB MaxScale

Репозиторий MariaDB MaxScale содержит пакеты программного обеспечения, связанные с MariaDB MaxScale.

По умолчанию скрипт настраивает вашу систему для установки из репозитория последней версии GA MariaDB MaxScale. При выходе новой основной версии GA репозиторий автоматически переключится на новую версию. Если вы хотите остаться на определенной версии, вам необходимо вручную отредактировать файл конфигурации репозитория и изменить 'latest' на желаемую версию (например, '6.1') или снова запустить скрипт настройки репозитория пакетов MariaDB, указав конкретную версию или серию, которую вы хотите.

Более старые версии скрипта настройки репозитория пакетов MariaDB настраивали определенную серию MariaDB MaxScale в репозитории (например, '2.4'), поэтому, если вы ранее использовали скрипт для настройки репозитория и хотите, чтобы MariaDB MaxScale автоматически использовал последнюю версию GA, измените '2.4' или '2.3' в конфигурации репозитория на 'latest'. Или загрузите текущую версию скрипта и запустите его повторно, чтобы настроить репозиторий.

Скрипт может настроить вашу систему для установки из репозитория более старой версии MariaDB MaxScale, если вы используете опцию --mariadb-maxscale-version. Например, --mariadb-maxscale-version=2.4, если вы хотите последнюю версию в серии MariaDB MaxScale 2.4.x.

Если вы не хотите настраивать Репозиторий MariaDB MaxScale на вашей системе, вы можете использовать опцию --skip-maxscale, чтобы предотвратить его настройку.

Поддерживаемые дистрибутивы

Скрипт поддерживает дистрибутивы Linux, которые официально поддерживаются подпиской MariaDB Corporation на MariaDB TX. Однако подписка на MariaDB TX у компании MariaDB не требуется для использования репозитория пакетов MariaDB.

Дистрибутивы, которые в настоящее время поддерживаются скриптом:

• Red Hat Enterprise Linux (RHEL) 7 и 8
• CentOS 7
• Debian 9 (Stretch), 10 (Buster), 11 (Bullseye)
• Ubuntu 18.04 LTS (Bionic) и 20.04 LTS (Focal)
• SUSE Linux Enterprise Server (SLES) 12 и 15

Для установки MariaDB на дистрибутивы, не поддерживаемые скриптом настройки репозитория пакетов MariaDB, воспользуйтесь Инструментом конфигурации репозитория MariaDB Фонда MariaDB. Некоторые дистрибутивы Linux также включают MariaDB в свои собственные репозитории.

Использование скрипта настройки репозитория пакетов MariaDB

Скрипт может быть выполнен следующим образом:

curl -LsS https://r.mariadb.com/downloads/mariadb_repo_setup | sudo bash

Скрипту потребуется настроить файлы конфигурации репозитория пакетов, поэтому его необходимо выполнить от имени пользователя root.

Скрипт также установит общедоступные ключи GPG, используемые для проверки подписи пакетов программного обеспечения MariaDB. Если вы хотите этого избежать, вы можете использовать опцию --skip-key-import.

Если скрипт попытается создать файл конфигурации репозитория, а файл с таким именем уже существует, скрипт переименует существующий файл с расширением в формате ".old_[0-9]+", что заставит менеджер пакетов ОС проигнорировать файл. После подтверждения работоспособности обновленного файла конфигурации репозитория, вы можете безопасно удалить эти файлы.

Если вы хотите увидеть файл конфигурации репозитория, который будет создан, не выполняя его фактического создания, вы можете использовать опцию --write-to-stdout. Это также избавит вас от необходимости запуска скрипта от имени root.

Если вы хотите загрузить скрипт вместо его выполнения, вы можете сделать это следующим образом:

curl -LO https://r.mariadb.com/downloads/mariadb_repo_setup

Параметры

Для указания параметров скрипту необходимо указать bash ожидать их, выполнив bash с параметрами -s --, например:

curl -LsS https://r.mariadb.com/downloads/mariadb_repo_setup | sudo bash -s -- --help

--mariadb-server-version

По умолчанию скрипт настраивает вашу систему для установки из репозитория последней версии GA MariaDB. В настоящее время это MariaDB 10.5. Если произойдет выпуск новой основной версии GA, и вы хотите обновиться до нее, вам необходимо либо вручную изменить файл конфигурации репозитория, чтобы указать новую версию, либо снова запустить скрипт настройки репозитория пакетов MariaDB.

Скрипт также может настроить вашу систему для установки из репозитория другой версии MariaDB, если вы используете опцию --mariadb-server-version.

Строка mariadb- должна быть добавлена перед номером версии. Например, для настройки вашей системы на установку из репозитория MariaDB 10.3, это будет:

curl -LsS https://r.mariadb.com/downloads/mariadb_repo_setup | sudo bash -s -- --mariadb-server-version="mariadb-10.6"

В настоящее время поддерживаются следующие версии MariaDB:

• mariadb-10.4
• mariadb-10.5
• mariadb-10.6
• mariadb-10.9
• mariadb-10.10
• mariadb-10.11
• mariadb-11.0
• mariadb-11.1

Если вы хотите закрепить репозиторий конкретного незначительного выпуска, например, MariaDB 10.6.14, вы также можете указать незначительный выпуск. Например, mariadb-10.6.14. Это может быть полезно, если вы хотите избежать обновлений. Однако избегать обновлений не рекомендуется, так как незначительные релизы поддержки могут содержать важные исправления ошибок и уязвимостей.

--mariadb-maxscale-version

По умолчанию скрипт настрои́т вашу систему на установку из репозитория последней GA-версии MariaDB MaxScale.

Если вы хотите зафиксировать репозиторий на определённой версии MariaDB MaxScale, вам нужно либо вручную изменить файл конфигурации репозитория, указав желаемую версию, либо использовать опцию --mariadb-maxscale-version.

Например, чтобы настроить систему на установку из репозитория MariaDB MaxScale версии 6.1, необходимо сделать следующее:

curl -LsS https://r.mariadb.com/downloads/mariadb_repo_setup | sudo bash -s -- --mariadb-maxscale-version="6.1"

В настоящее время поддерживаются следующие версии MariaDB MaxScale:

• MaxScale 1.4
• MaxScale 2.0
• MaxScale 2.1
• MaxScale 2.2
• MaxScale 2.3
• MaxScale 2.4
• MaxScale 2.5
• MaxScale 6.1
• MaxScale 6.2

Также поддерживаются специальные идентификаторы latest (для последней GA-версии) и beta (для последней версии бета-канала). По умолчанию скрипт mariadb_repo_setup использует latest в качестве версии.

--os-type и --os-version

Если вы хотите запустить этот скрипт на недокументированной ОС, которая, по вашему мнению, совместима с поддержанной ОС, вы можете использовать опции --os-type и --os-version для переопределения определения ОС скриптом. Если вы используете одну из этих опций, то вы должны использовать обе опции.

Допустимые значения для --os-type:

• rhel
• debian
• ubuntu
• sles

Если вы используете недопустимое значение, скрипт завершится ошибкой, точно так же, как и при запуске на недокументированной ОС.

Допустимые значения для --os-version полностью зависят от типа ОС.

Для Red Hat Enterprise Linux (RHEL) и CentOS допустимы значения 7 и 8.

Для Debian и Ubuntu версия должна быть указана как кодовое имя конкретной версии. Например, Debian 9 должен быть указан как stretch, а Ubuntu 18.04 как bionic.

Эти опции могут быть полезны, если ваша дистрибутива является форком другой дистрибутивы. Например, Linux Mint 8.1 основана на и полностью совместима с Ubuntu 16.04 LTS (Xenial). Поэтому, если вы используете Linux Mint 8.1, вы можете настроить систему на установку из репозитория Ubuntu 16.04 LTS (Xenial). Для этого укажите --os-type=ubuntu и --os-version=xenial в скрипте настройки репозитория MariaDB.

Например, чтобы вручную установить --os-type и --os-version на RHEL 8, необходимо сделать следующее:

curl -LsS https://r.mariadb.com/downloads/mariadb_repo_setup | sudo bash -s -- --os-type=rhel --os-version=8

--write-to-stdout

Опция --write-to-stdout предотвращает изменение скриптом чего-либо в системе. Конфигурация репозитория не будет записана в файл конфигурации репозитория. Вместо этого она будет выведена в стандартный вывод. Это позволяет просмотреть конфигурацию, перенаправить её в другое место, использовать в другом скрипте или каким-либо другим способом.

Опция --write-to-stdout автоматически включает --skip-key-import.

Например:

curl -LsS https://r.mariadb.com/downloads/mariadb_repo_setup | sudo bash -s -- --write-to-stdout

Платформоспецифическое поведение

Платформоспецифическое поведение на RHEL и CentOS

В Red Hat Enterprise Linux (RHEL) и CentOS скрипт настройки репозитория MariaDB выполняет следующие действия:

1. Создаёт файл конфигурации репозитория в /etc/yum.repos.d/mariadb.repo.

2. Импортирует открытый ключ GPG, используемый для проверки подписи пакетов MariaDB, с rpm --import из downloads.mariadb.com.

Платформоспецифическое поведение на Debian и Ubuntu

В Debian и Ubuntu скрипт настройки репозитория MariaDB выполняет следующие действия:

1. Создаёт файл конфигурации репозитория в /etc/apt/sources.list.d/mariadb.list.

2. Создаёт файл предпочтений пакетов в /etc/apt/preferences.d/mariadb-enterprise.pref, который повышает приоритет пакетов из репозиториев MariaDB по сравнению с пакетами из ОС и других репозиториев, что может помочь избежать конфликтов. Он выглядит следующим образом:

Package: *
Pin: origin downloads.mariadb.com
Pin-Priority: 1000

3. Импортирует открытый ключ GPG, используемый для проверки подписи пакетов MariaDB, с apt-key с сервера ключей keyserver.ubuntu.com.

4. Обновляет кеш пакетов с определениями пакетов из репозитория MariaDB с помощью apt-get update.

Платформоспецифическое поведение на SLES

В SUSE Linux Enterprise Server (SLES) скрипт настройки репозитория MariaDB выполняет следующие действия:

1. Создаёт файл конфигурации репозитория в /etc/zypp/repos.d/mariadb.repo.

2. Импортирует открытый ключ GPG, используемый для проверки подписи пакетов MariaDB, с rpm --import из downloads.mariadb.com.

Установка пакетов с помощью репозитория MariaDB

После настройки репозитория MariaDB вы можете установить пакеты в поддерживаемых репозиториях.

Установка пакетов на RHEL и CentOS

Для установки MariaDB на Red Hat Enterprise Linux (RHEL) и CentOS, см. инструкции в Установка пакетов MariaDB с помощью YUM. Например:

sudo yum install MariaDB-server MariaDB-client MariaDB-backup

Для установки MariaDB MaxScale на Red Hat Enterprise Linux (RHEL) и CentOS, см. инструкции в Руководство по установке MariaDB MaxScale. Например:

sudo yum install maxscale

Установка пакетов на Debian и Ubuntu

Для установки MariaDB на Debian и Ubuntu, см. инструкции в Установка пакетов MariaDB с помощью APT. Например:

sudo apt-get install mariadb-server mariadb-client mariadb-backup

Для установки MariaDB MaxScale на Debian и Ubuntu, см. инструкции в Руководство по установке MariaDB MaxScale. Например:

sudo apt-get install maxscale

Установка пакетов на SLES

Для установки MariaDB на SUSE Linux Enterprise Server (SLES), см. инструкции в Установка пакетов MariaDB с помощью ZYpp. Например:

sudo zypper install MariaDB-server MariaDB-client MariaDB-backup

Для установки MariaDB MaxScale на SUSE Linux Enterprise Server (SLES), см. инструкции в Руководство по установке MariaDB MaxScale. Например:

sudo zypper install maxscale

Версии