Подключение репозиториев
Подключение репозиториев - это часть процесса обновления компонентов, поэтому приступайте к данной процедуре только тогда, когда это предусматривает процедура обновления соответствующего компонента.
|
При отсутствии сетевого доступа к онлайн-репозиториям zVirt SE можно настроить локальные репозитории. |
1. Подключение онлайн-репозиториев
|
При использовании локальных репозиториев описанные в этом разделе шаги выполнять не нужно. |
-
С помощью команды
wgetскачайте пакет zvirt-repos-stable с новыми репозиториями и установите его:-
для расширенной версии:
wget \ --user=<имя_пользователя> --password=<пароль> \ (1) https://repo-zvirt-se.orionsoft.ru/repository/1.0-ADV/packages/zvirt-repos-stable-1.0.0-2.408267.zvirt.zvn2.noarch.rpm (2)1 Атрибуты <имя_пользователя> и <пароль> копируются из лицензионного сертификата, выданного при покупке продукта 2 В репозитории уточните актуальную версию пакета. dnf install -y zvirt-repos-stable-1.0.0-2.408267.zvirt.zvn2.noarch.rpmЕсли на хосте уже настроен доступ к репозиторию, можно установить пакет непосредственно из него:
dnf install -y https://repo-zvirt-se.orionsoft.ru/repository/1.0-ADV/packages/zvirt-repos-stable-1.0.0-2.408267.zvirt.zvn2.noarch.rpm (1) -
для базовой версии:
wget \ --user=<имя_пользователя> --password=<пароль> \ (1) https://repo-zvirt-se.orionsoft.ru/repository/1.0-BSD/packages/zvirt-repos-stable-1.0.0-2.408267.zvirt.zvn2.noarch.rpm (2)1 Атрибуты <имя_пользователя> и <пароль> копируются из лицензионного сертификата, выданного при покупке продукта 2 В репозитории уточните актуальную версию пакета. dnf install -y zvirt-repos-stable-1.0.0-2.408267.zvirt.zvn2.noarch.rpmЕсли на хосте уже настроен доступ к репозиторию, можно установить пакет непосредственно из него:
dnf install -y https://repo-zvirt-se.orionsoft.ru/repository/1.0-BSD/packages/zvirt-repos-stable-1.0.0-2.408267.zvirt.zvn2.noarch.rpm (1)
-
-
Убедитесь, что включены новые репозитории zvirt-se-main и zvirt-se-extras:
dnf repolist allОжидаемый вывод:
идентификатор репозитория имя репозитория состояние zvirt-se-extras zVirt SE 1.0 extras repository включено zvirt-se-main zVirt SE 1.0 main repository включеноЕсли указанные репозитории по каким-то причинам отключены, их можно включить следующей командой:
dnf config-manager --enable "*"После использования команды убедитесь, что все репозитории zVirt SE включились.
-
Настройте доступ к репозиториям:
zvirt-credentials.py -u <имя_пользователя> -p <пароль>Если утилита не найдена, переустановите её:
-
для расширенной версии:
wget \ --user=<имя_пользователя> --password=<пароль> \ (1) https://repo-zvirt-se.orionsoft.ru/repository/1.0-ADV/packages/zvirt-credentials-0.1.1-1.408266.zvirt.zvn2.noarch.rpm (2)1 <имя_пользователя> и <пароль> берутся из лицензионного сертификата, выданного при покупке продукта. 2 В репозитории уточните актуальную версию пакета. dnf install -y install -y zvirt-credentials-0.1.1-1.408266.zvirt.zvn2.noarch.rpm -
для базовой версии:
wget \ --user=<имя_пользователя> --password=<пароль> \ (1) https://repo-zvirt-se.orionsoft.ru/repository/1.0-BSD/packages/zvirt-credentials-0.1.1-1.408266.zvirt.zvn2.noarch.rpm (2)1 <имя_пользователя> и <пароль> берутся из лицензионного сертификата, выданного при покупке продукта. 2 В репозитории уточните актуальную версию пакета. dnf install -y zvirt-credentials-0.1.1-1.408266.zvirt.zvn2.noarch.rpm
-
2. Организация локального репозитория
2.1. Общие сведения
Для организации локального доступа к репозиториям zVirt SE существует два варианта: использование протокола NFS или веб-сервера NGINX.
Независимо от выбранного способа, общая процедура состоит из следующих шагов:
-
Создание локальных репозиториев на выбранном сервере путем синхронизации с официальными репозиториями Orionsoft.
-
Настройка доступа к локальным репозиториям:
-
с помощью NFS или
-
с помощью NGINX.
-
-
Настройка клиентских машин для работы с локальными репозиториями.
2.2. Требования к серверу с локальными репозиториями
-
RedHat-подобная операционная система.
-
Утилита
reposyncиз состава пакетаyum-utils. -
Установленный пакет
nfs-utils; -
Наличие доступа в интернет;
-
Действующие логин и пароль от репозиториев zVirt;
-
Наличие свободного дискового пространства объемом не менее 20 ГБ.
2.3. Создание локальных репозиториев
Способ 1. С помощью синхронизации с онлайн-репозиториями
Для создания локальных репозиториев на выбранном сервере выполните следующие действия:
-
В каталоге /etc/yum.repos.d/ создайте файл конфигурации репозиториев zVirt SE, например, /etc/yum.repos.d/zvirt-local.repo со следующим содержимым:
-
для расширенной версии:
[zvirt-se-main] # Настройки для доступа к официальному репозиторию zvirt-se-main name=zVirt SE ADV 1.0 main baseurl=file:///var/zvirt-se-repo/repo/1.0-ADV/ (1) gpgcheck=0 enabled=1 username=USERNAME (2) password=PASSWORD (3) [zvirt-se-extras] # Настройки для доступа к официальному репозиторию zvirt-se-extras name=zVirt SE ADV 1.0 extras baseurl=file:///var/zvirt-se-repo/repo/1.0-ADV/extras/ (1) gpgcheck=0 enabled=1 username=USERNAME (2) password=PASSWORD (3)1 Ссылка на репозиторий для расширенной версии 2 Имя пользователя для доступа к официальным репозиториям 3 Пароль для доступа к официальным репозиториям -
для базовой версии:
[zvirt-se-main] # Настройки для доступа к официальному репозиторию zvirt-se-main name=zVirt SE BSD 1.0 main baseurl=file:///var/zvirt-se-repo/repo/1.0-BSD/ (1) gpgcheck=0 enabled=1 username=USERNAME (2) password=PASSWORD (3) [zvirt-se-extras] # Настройки для доступа к официальному репозиторию zvirt-se-extras name=zVirt SE BSD 1.0 extras baseurl=file:///var/zvirt-se-repo/repo/1.0-BSD/extras/ (1) gpgcheck=0 enabled=1 username=USERNAME (2) password=PASSWORD (3)1 Ссылка на репозиторий для базовой версии 2 Имя пользователя для доступа к официальным репозиториям 3 Пароль для доступа к официальным репозиториям
Имя пользователя и пароль для доступа к репозиториям скопируйте из лицензионного сертификата, выданного при покупке продукта. -
-
Создайте директорию для локального репозитория, например: /local-repo.
mkdir /local-repo -
Установите (в том случае, если он не установлен ранее) пакет
dnf-utils:dnf install -y dnf-utils -
Выполните синхронизацию локального каталога с официальными репозиториями Orionsoft:
reposync --refresh --delete --download-metadata --repoid=zvirt-se-main,zvirt-se-extras -p /local-repo -
Настройте задание для автоматической синхронизации:
-
Откройте редактор планировщика:
crontab -e -
Внесите параметры заданий (в примере синхронизация настроена на выполнение в 00:00 каждую субботу):
0 1 * * 6 reposync --refresh --delete --download-metadata --repoid=zvirt-se-main,zvirt-se-extras -p /local-repo >> /local-repo/sync.log 2>&1Журнал событий синхронизации при данной настройке будет сохраняться в /local-repo/sync.log.
-
Способ 2. С помощью ISO-образа с актуальными репозиториями
Описанную ниже процедуру можно выполнить:
-
На выделенном сервере, который будет предоставлять сетевой доступ к локальным репозиториям.
-
На хостах виртуализации и/или Менеджере управления.
В этом случае настройка сетевого доступа не потребуется. Достаточно в конфигурации репозиториев на соответствующем хосте (или Менеджере управления) изменить значение параметра
baseurlна путь к каталогу со ссылками на смонтированные репозитории.Для этого на соответствующем хосте (где смонтирован ISO-образ):
-
Отключите онлайн-репозитории:
dnf config-manager --disable "*"
-
Создайте файл описания offline-репозитория /etc/yum.repos.d/offline_zvirt.repo со следующим содержимым:
-
для расширенной версии:
[offline_zvirt_se_main] name=zVirt SE ADV 1.0 main baseurl=file:///var/zvirt-se-repo/repo/1.0-ADV/ (1) gpgcheck=0 enabled=1 [offline_zvirt_se_extras] name=zVirt SE ADV 1.0 extras baseurl=file:///var/zvirt-se-repo/repo/1.0-ADV/extras/ (1) gpgcheck=0 enabled=11 Ссылка на репозиторий для расширенной версии. -
для базовой версии:
[offline_zvirt_se_main] name=zVirt SE BSD 1.0 main baseurl=file:///var/zvirt-se-repo/repo/1.0-BSD/ (1) gpgcheck=0 enabled=1 [offline_zvirt_se_extras] name=zVirt SE BSD 1.0 extras baseurl=file:///var/zvirt-se-repo/repo/1.0-BSD/extras/ (1) gpgcheck=0 enabled=11 Ссылка на репозиторий для базовой версии.
-
Для организации локальных репозиториев с помощью ISO-образа, хранящегося в репозиториях zVirt SE, выполните следующие действия:
-
Скачайте ISO-образ, содержащий актуальные версии репозиториев из каталога iso, например:
-
для расширенной версии:
wget https://repo-zvirt-se.orionsoft.ru/repository/1.0-ADV/iso/repos_se_adv_10_202610282045.iso -
для базовой версии:
wget https://repo-zvirt-se.orionsoft.ru/repository/1.0-BSD/iso/repos_se_bsd_10_202610282046.iso
-
-
Создайте каталог, в который будет смонтирован образ, например:
bash mkdir /mnt/repo -
Смонтируйте образ в созданный каталог:
-
для расширенной версии:
bash mount -o loop ./repos_se_adv_10_202610282045.iso /mnt/repo -
для базовой версии:
bash mount -o loop ./repos_se_bsd_10_202610282046.iso /mnt/repo
-
-
Создайте каталог с символической ссылкой на каталог с репозиториями. Данный каталог будет использоваться для предоставления доступа к репозиториям.
mkdir -p /var/zvirt-se-repo ln -s /mnt/repo /var/zvirt-se-repo
Перейдите к настройке сетевого доступа к репозиториям или настройте локальный доступ, как указано выше.
-
2.4. Настройка сетевого доступа к локальным репозиториям
Доступ к локальным репозиториям можно настроить двумя способами:
-
непосредственно на сервере, выполняющем синхронизацию;
-
на сервере, расположенном в изолированном сегменте сети, путем копирования на него синхронизированных репозиториев с помощью, например, внешнего носителя.
Описанные ниже способы организации доступа подходят для обоих вариантов.
Организация доступа через NFS
На сервере, к которому будут подключаться клиенты для доступа к репозиториям, выполните следующие действия:
-
Установите пакет для создания и настройки NFS-хранилища:
dnf install nfs-utils -y -
Если установлен firewalld, то необходимо открыть порты и перечитать конфигурацию:
firewall-cmd --permanent --zone=public --add-service=nfs firewall-cmd --reload -
Запустите службу NFS сервера:
systemctl enable --now nfs-server -
Опубликуйте каталог с репозиториями и назначьте права доступа в файле
/etc/exports. Например:/local-repo 192.168.1.0/24(ro) (1)1 В этом примере разрешается доступ только для чтения (ro) для устройств с адресами из подсети 192.168.1.0/24. -
Примените новые настройки NFS каталогов:
exportfs -ra
| Если доступ к репозиториям настраивается на изолированном сервере, необходимо синхронизированные репозитории скопировать в каталог, настроенный для экспорта (п.4). |
Организация доступа через HTTP(S) с помощью Nginx
На сервере, к которому будут подключаться клиенты для доступа к репозиториям, выполните следующие действия:
-
Установите веб-сервер
nginxв соответствии с инструкцией согласно своей операционной системе. -
Настройте секцию server конфигурационного файла /etc/nginx/nginx.conf (см. пример ниже).
-
Проверьте конфигурацию на отсутствие ошибок:
nginx -t -
Если установлен firewalld, то необходимо открыть порты (в примере открыт только порт http) и перечитать конфигурацию:
firewall-cmd --permanent --add-service=http firewall-cmd --reload -
Активируйте и запустите сервис:
systemctl enable --now nginx.service
| Если доступ к репозиториям настраивается на изолированном сервере, необходимо синхронизированные репозитории скопировать в каталог, указанный для публикации в файле /etc/nginx/nginx.conf (см. пример ниже). По умолчанию для nginx — /usr/share/nginx/html. |
server {
listen 80 default_server;
listen [::]:80 default_server;
server_name _;
root /local-repo; (1)
# Load configuration files for the default server block.
include /etc/nginx/default.d/*.conf;
location / {
autoindex on;
}
error_page 404 /404.html;
location = /40x.html {
}
error_page 500 502 503 504 /50x.html;
location = /50x.html {
}
}
| 1 | Каталог, в котором находятся локальные репозитории |
3. Настройка клиентов для подключения к локальным репозиториям
Для того, чтобы хосты и Менеджер управления (далее, клиенты) могли использовать локальные репозитории, необходимо отредактировать параметр baseurl в конфигурационном файле репозитория, указав корректную ссылку.
Получение доступа через NFS
-
На клиенте установите пакет nfs-utils:
dnf install nfs-utils -yВ zVirt Node установлен по умолчанию, но рекомендуется убедиться в его наличии. -
На клиенте создайте директорию, в которую будет смонтирован nfs-каталог, например:
mkdir /repo -
Смонтируйте удаленное NFS-хранилище в созданный каталог:
mount -t nfs <IPADDRESS>:/local-repo /repo (1)1 <IPADDRESS> - IP адрес сервера с NFS-хранилищем -
Настройте клиента на использование локального репозитория, указав данные для подключения в файле /etc/yum.repos.d/zvirt-stable.repo:
[zvirt-se-main] name=zvirt se main repository baseurl=file:///repo/zvirt-se-main (1) enabled=1 skip_if_unavailable=1 gpgcheck=1 gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-ZVIRT-NODE [zvirt-se-extras] name=zvirt se extras repository baseurl=file:///repo/zvirt-se-extras (2) enabled=1 skip_if_unavailable=1 gpgcheck=01 Путь к каталогу zvirt-se-main в смонтированной разделяемой папке nfs 2 Путь к каталогу zvirt-se-extras в смонтированной разделяемой папке nfs
Получение доступа через HTTP
Настройте клиента на использование локального репозитория, указав данные для подключения в файле /etc/yum.repos.d/zvirt-stable.repo:
[zvirt-se-main]
name=zvirt se main repository
baseurl=http://<IPADDRESS>/zvirt-se-main/ (1)
enabled=1
skip_if_unavailable=1
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-ZVIRT-NODE
[zvirt-se-extras]
name=zvirt se extras repository
baseurl=http://<IPADDRESS>/zvirt-se-extras/ (1)
enabled=1
skip_if_unavailable=1
gpgcheck=0
| 1 | <IPADDRESS> - IP-адрес сервера Nginx, на котором предоставляется доступ к репозиториям. |
4. Возможные проблемы
4.1. Во время выполнения синхронизации происходят ошибки скачивания
Добавьте в секцию [main] файла /etc/dnf/dnf.conf параметры timeout и max_parallel_downloads:
[main] ... timeout=60 max_parallel_downloads=1
4.2. Во время использования локального репозитория не скачиваются файлы большого объема
-
Добавьте в секцию http конфигурационного файла /etc/nginx/nginx.conf строку
client_max_body_size 2G; -
Проверьте конфигурацию на отсутствие ошибок:
nginx -t -
Перезапустите сервис:
systemctl restart nginx.service
4.3. Если включен SELinux, то возможны следующие ошибки:
При запуске nginx появляется ошибка:
Job for nginx.service failed because the service did not take the steps required by its unit configuration. See "systemctl status nginx.service" and "journalctl -xe" for details.
В sealert присутствует следующее:
SELinux is preventing /usr/sbin/nginx from 'read, write' accesses on the file nginx.pid.
Необходимо:
-
Создать каталог /var/run/nginx.
-
Выполнить команду:
restorecon -R -v /var/run/nginx* -
Попробовать запустить nginx
systemctl enable --now nginx.service
При доступе в репозиторий через веб-браузер каталоги внутри пустые. При попытке подключиться к репозиторию выводится ошибка:
Errors during downloading metadata for repository 'zvirt-local': - Status code: 404 for http://192.168.1.21/repository/zvirt-local-main/repodata/repomd.xml (IP: 192.168.1.21) Error: Failed to download metadata for repo 'zvirt-local-main': Cannot download repomd.xml: Cannot download repodata/repomd.xml: All mirrors were tried Ignoring repositories: zvirt-local-main
Необходимо проверить SELinux атрибуты каталога репозитория и назначить по необходимости, выполнив команды
semanage fcontext -a -t httpd_sys_content_t '/var/www(/.*)?' restorecon -Rv /var/www