Перейти к основному содержанию Перейти к навигации Перейти к нижнему колонтитулу

Установка

Установите CLI Rediacc на Linux, macOS или Windows.

Установка

Установите CLI rdc на свою рабочую станцию. Это единственный инструмент, который нужно установить вручную — все остальное обрабатывается автоматически при настройке удаленных машин.

Быстрая установка

Linux и macOS

curl -fsSL https://www.rediacc.com/install.sh | bash

Эта команда загружает бинарный файл rdc в $HOME/.local/bin/. Убедитесь, что этот каталог присутствует в вашем PATH:

export PATH="$HOME/.local/bin:$PATH"

Добавьте эту строку в профиль вашей оболочки (~/.bashrc, ~/.zshrc и т.д.), чтобы сделать изменение постоянным.

Windows

Выполните в PowerShell:

irm https://www.rediacc.com/install.ps1 | iex

Эта команда загружает rdc.exe в %LOCALAPPDATA%\rediacc\bin\. Установщик предложит добавить его в PATH при необходимости.

Менеджеры пакетов

APT (Debian / Ubuntu)

curl -fsSL https://releases.rediacc.com/apt/stable/gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/rediacc.gpg
echo "deb [signed-by=/usr/share/keyrings/rediacc.gpg] https://releases.rediacc.com/apt/stable stable main" | sudo tee /etc/apt/sources.list.d/rediacc.list
sudo apt-get update && sudo apt-get install rediacc-cli

DNF (Fedora / совместимые с RHEL)

sudo curl -fsSL https://releases.rediacc.com/rpm/stable/rediacc.repo -o /etc/yum.repos.d/rediacc.repo
sudo dnf install rediacc-cli

Oracle Linux, AlmaLinux и Rocky Linux используют один и тот же поток DNF; любой совместимый с RHEL дистрибутив с dnf может подключить указанный репозиторий. Примечание: Oracle Linux 10 является единственным дистрибутивом семейства RHEL, официально поддерживаемым в качестве целевой серверной платформы Rediacc (см. Требования). В Rocky/Alma 10 отсутствует модуль ядра btrfs, необходимый для плоскости данных renet, хотя CLI rdc устанавливается на них без проблем.

Zypper (openSUSE Leap)

sudo zypper addrepo https://releases.rediacc.com/rpm/stable/rediacc.repo
sudo zypper --gpg-auto-import-keys refresh
sudo zypper install rediacc-cli

Протестировано на openSUSE Leap 16.0+.

APK (Alpine Linux)

echo "https://releases.rediacc.com/apk/stable" | sudo tee -a /etc/apk/repositories
sudo apk update
sudo apk add --allow-untrusted rediacc-cli

Примечание: Пакет gcompat (слой совместимости с glibc) устанавливается автоматически как зависимость.

Pacman (Arch Linux)

echo "[rediacc]
SigLevel = Optional TrustAll
Server = https://releases.rediacc.com/archlinux/stable/\$arch" | sudo tee -a /etc/pacman.conf

sudo pacman -Sy rediacc-cli

npm (Node.js)

npm install -g https://releases.rediacc.com/npm/stable/rediacc-cli-latest.tgz

Требуется Node.js версии 22 или новее. Чтобы установить определённую версию:

npm install -g https://releases.rediacc.com/npm/stable/rediacc-cli-0.8.5.tgz

Docker

Загрузите и запустите CLI как контейнер:

docker pull ghcr.io/rediacc/rdc:stable

docker run --rm ghcr.io/rediacc/rdc:stable --version

Создайте псевдоним для удобства:

alias rdc='docker run --rm -it -v $(pwd):/workspace ghcr.io/rediacc/rdc:stable'

Доступные теги Docker:

ТегОписание
:stableПоследний стабильный релиз (рекомендуется)
:edgeПоследний edge-релиз
:0.8.4Фиксированная версия (неизменяемая)
:latestПсевдоним для :stable

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

rdc --version

Обновление

Обновить до последней версии:

rdc update

Проверить наличие обновлений без установки:

rdc update --check-only

Просмотреть текущий статус обновления:

rdc update --status

Откатить до предыдущей версии:

rdc update --rollback

Каналы выпуска

Rediacc использует систему выпуска на основе каналов. Канал определяет, какую версию вы получаете при обновлениях CLI, установках через менеджеры пакетов и загрузках Docker.

КаналОписаниеКогда обновляется
stableРелизы для продакшенаПродвигается из edge после 7-дневного тестирования
edgeПоследние функции и исправленияПри каждом мерже в main
pr-NПревью-сборки PRАвтоматически для каждого pull request

Переключение каналов

rdc update --channel edge      # Переключиться на канал edge
rdc update --channel stable    # Вернуться на канал stable

Установить напрямую из канала edge:

REDIACC_CHANNEL=edge curl -fsSL https://www.rediacc.com/install.sh | bash

Для менеджеров пакетов замените stable на edge в URL репозитория:

# APT edge
echo "deb [signed-by=/usr/share/keyrings/rediacc.gpg] https://releases.rediacc.com/apt/edge stable main" | sudo tee /etc/apt/sources.list.d/rediacc.list

# Docker edge
docker pull ghcr.io/rediacc/rdc:edge

Как работают каналы

Канал применяется единообразно ко всем методам доставки:

  • Скрипты установки: Переменная окружения REDIACC_CHANNEL выбирает канал
  • Репозитории пакетов: releases.rediacc.com/{формат}/{канал}/
  • Теги Docker: ghcr.io/rediacc/rdc:{канал}
  • Обновления CLI: rdc update проверяет канал, настроенный при установке

Автоматическая настройка превью PR

При установке из развертывания превью PR (например, pr-420.rediacc.workers.dev) канал и сервер аккаунта настраиваются автоматически:

  • Бинарный файл CLI загружается из канала pr-420
  • rdc update проверяет канал pr-420 на наличие обновлений
  • Все команды аккаунта/подписки подключаются к серверу превью PR
  • Команды Docker на сайте превью показывают cli:pr-420

Ручная настройка не требуется. Скрипт установки определяет контекст развертывания из URL.

Обновления удаленных бинарных файлов

Команды, которые изменяют машину (развертывание, резервное копирование, rdc machine setup и подобные), автоматически устанавливают соответствующий бинарный файл renet. Если бинарный файл обновляется, маршрутный сервер (rediacc-router) автоматически перезапускается, чтобы подхватить новую версию. Команды только для чтения, например rdc machine status и rdc repo list, никогда не заменяют бинарный файл: они используют версию, уже установленную на машине, и выводят предупреждение, если она отличается от версии CLI.

Перезапуск прозрачен и не вызывает простоя:

  • Маршрутный сервер перезапускается за ~1-2 секунды.
  • В течение этого окна Traefik продолжает обслуживать трафик, используя последнюю известную конфигурацию маршрутизации. Маршруты не теряются.
  • Traefik подхватывает новую конфигурацию в следующем цикле опроса (в течение 5 секунд).
  • Существующие клиентские подключения (HTTP, TCP, UDP) не затрагиваются. Маршрутный сервер является поставщиком конфигурации — он не находится на пути данных. Traefik обрабатывает весь трафик напрямую.
  • Контейнеры ваших приложений не затрагиваются — перезапускается только системный процесс маршрутного сервера.

Чтобы пропустить автоматический перезапуск, передайте --skip-router-restart команде, которая устанавливает renet, или задайте переменную окружения REDIACC_SKIP_ROUTER_RESTART=1.