Установка CLI и вход

xvii — один бинарник для macOS и Linux. Каждый сервис добавляет в него свои команды: xvii pages, xvii apps, xvii env и так далее.

Установка

curl -fsSL https://xvii.network/install.sh | sh

curl -fsSL https://xvii.network/install.sh | XVII_INSTALL_DIR="$HOME/.local/bin" sh

Скрипт скачивает сборку для вашей системы из хранилища релизов инстанса, проверяет SHA-256 и пишет, куда её поставил. Убедитесь, что эта папка есть в PATH:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc

fish_add_path ~/.local/bin

Вход

xvii login xvii.network

CLI покажет короткий код и откроет id в браузере. Проверьте, что код совпадает, подтвердите ключом доступа — и терминал продолжит сам. Вход сохраняется как контекст с именем домена.

На сервере по SSH браузер не откроется:

xvii login xvii.network --no-browser

CLI напечатает ссылку и QR-код; откройте её на любом устройстве, где есть ваш ключ доступа.

xvii whoami

показывает, кто вы, ваши команды и способ входа. Машины, на которых выполнен вход, видны (и из них можно выйти) в id в разделе Аккаунт → Входы CLI.

Автодополнение

xvii completion --install

дополняет команды, флаги, а ещё имена: алиасы, приложения, проекты, команды.

Несколько инстансов

Каждый инстанс — это контекст. login создаёт его, context показывает и переключает:

xvii context                      # ● — текущий
xvii login work.example.com --name work
xvii context use work
xvii --context work apps ls       # одна команда на другом инстансе

Обновления

Раз в день CLI проверяет, не предлагает ли инстанс новую версию, и сообщает об этом после команды.

xvii update            # поставить версию, которую предлагает инстанс
xvii update --check    # только сказать, есть ли она

XVII_NO_UPDATE_CHECK=1 отключает ежедневную проверку.

Без сохранённого входа (CI)

XVII_DOMAIN и XVII_TOKEN заменяют контекст, так что задаче CI не нужен xvii login:

export XVII_DOMAIN=xvii.network
export XVII_TOKEN=xv_…            # API-токен, см. Понятия → Токены
xvii pages deploy dist

В GitLab CI и GitHub Actions можно обойтись вовсе без токена: см. Деплой из CI.

Справка

xvii help                 # все команды
xvii help apps deploy     # флаги и примеры одной команды

То же самое на одной странице: справочник CLI.