snap - Инструмент для взаимодействия со snap-пакетами
СИНТАКСИС
snap [ОПЦИИ]
ОПИСАНИЕ
Команда snap позволяет устанавливать, настраивать, обновлять и удалять snap-пакеты. Snap-пакеты — это пакеты, которые работают в различных дистрибутивах Linux, обеспечивая безопасную доставку и работу новейших приложений и утилит.
ОПЦИИ
Опции приложений
КОМАНДЫ
abort
Отменить ожидающие изменения
Команда abort пытается отменить изменения, для которых все еще есть ожидающие задачи.
Использование: snap [ОПЦИИ] abort [ОПЦИИ_abort]
--last Выбрать последнее изменение данного типа (install, refresh, remove, try, auto-refresh и т. д.).
Знак вопроса в конце типа означает, что если изменение данного типа не найдено, то ничего не делать (вместо выдачи ошибки).
Обратите внимание, что знак вопроса может потребовать защиты от оболочки.
ack
Добавить утверждение в систему
Команда ack пытается добавить утверждение в базу данных утверждений системы.
Утверждение также может быть более новой версией существующего утверждения, которое оно заменит.
Для успешного выполнения утверждение должно быть действительным, его подпись должна быть проверена с помощью известного открытого ключа, и утверждение должно быть согласовано с его предварительным условием в базе данных.
alias
Настроить ручное псевдоним
Команда alias присваивает указанному snap-приложению указанный псевдоним.
После настройки этого ручного псевдонима соответствующую команду приложения можно вызывать, используя только псевдоним.
Использование: snap [ОПЦИИ] alias [ОПЦИИ_alias]
--no-wait
Не ждать завершения операции, а просто вывести идентификатор изменения.
aliases
Список псевдонимов в системе
Команда aliases перечисляет все псевдонимы, доступные в системе, и их статус.
$ snap aliases <snap>
Выводит только псевдонимы, определенные для указанного snap-приложения.
changes
Список изменений системы
Команда changes отображает сводку изменений системы, выполненных в последнее время.
Использование: snap [ОПЦИИ] changes [ОПЦИИ_changes]
--abs-time
Отображать абсолютное время (в формате RFC 3339). В противном случае отображать относительное время до 60 дней, затем YYYY-MM-DD.
check-snapshot
Проверить снимок
Команда check-snapshot проверяет данные пользователя, системы и конфигурации snap-приложений, включенных в указанный снимок.
Операция проверки выполняет ту же проверку целостности данных, которая выполняется при восстановлении снимка.
По умолчанию эта команда проверяет все данные в снимке. Кроме того, можно указать данные, для которых следует выполнять проверку, или для каких пользователей, или комбинацию этих параметров.
Если snap-приложение включено в операцию check-snapshot, исключить его системные и конфигурационные данные из проверки в настоящее время невозможно. Это ограничение может быть снято в будущем.
Использование: snap [ОПЦИИ] check-snapshot [ОПЦИИ check-snapshot]
--no-wait
Не ждать завершения операции, а просто выводить идентификатор изменения.
--users
Проверять данные только для указанных пользователей (через запятую) (по умолчанию: все пользователи).
components
Список доступных и установленных компонентов для установленных snap-пакетов.
Команда components отображает сводку компонентов, которые установлены и доступны для набора установленных snap-пакетов.
Компоненты для конкретных установленных snap-пакетов можно запросить, указав имена snap-пакетов в качестве позиционных аргументов.
connect
Подключить плагин к слоту.
Команда connect подключает плагин к слоту. Ее можно вызывать следующими способами:
$ snap connect <snap>:<плагин> <snap>:<слот>
Подключает указанный плагин к данному слоту.
$ snap connect <snap>:<плагин> <snap>
Подключает указанный плагин к единственному слоту в указанном snap-пакете, который соответствует подключенному интерфейсу. Если существует более одного потенциального слота, команда завершается с ошибкой.
$ snap connect <snap>:<плагин>
Подключает указанный плагин к слоту в snap-пакете core, имя которого совпадает с именем плагина.
Использование: snap [ОПЦИИ] connect [ОПЦИИ connect]
--no-wait
Не ждать завершения операции, а просто выводить идентификатор изменения.
connections
Список подключений интерфейсов.
Команда connections перечисляет подключения между плагинами и слотами в системе.
Если не указан <snap>, выводятся подключенные плагины и слоты для всех snap-пакетов в системе. В этом режиме используйте --all, чтобы также вывести неподключенные плагины и слоты.
$ snap connections <snap>
Выводит подключенные и неподключенные плагины и слоты для указанного snap-пакета.
Использование: snap [ОПЦИИ] connections [ОПЦИИ connections]
--all Показывать подключенные и неподключенные плагины и слоты.
create-cohort
Создать ключи когорты для набора snap-пакетов.
Команда create-cohort создает набор ключей когорты для заданного набора snap-пакетов.
Когорта — это представление или снимок "карты каналов" snap-пакета в определенный момент времени, который фиксирует набор ревизий для snap-пакета с учетом других ограничений (например, канала или архитектуры). Когорта затем идентифицируется непрозрачным ключом для каждого snap-пакета, который работает в разных системах. Установка или обновление snap-пакета с использованием данного ключа когорты будет использовать фиксированную ревизию в течение 90 дней, после чего будет создан новый набор ревизий под тем же ключом когорты и начат новый 90-дневный период.
debug
Выполнить команды отладки.
Команда debug содержит набор дополнительных подкоманд.
Команды отладки могут быть удалены без предварительного уведомления и могут не работать в не-окружениях разработки.
debug api
Выполнить запрос к API snapd.
Выполняет запрос к API snapd. Сложные входные данные можно считывать из стандартного ввода, а вывод печатается в стандартный вывод. См. примеры ниже:
Список всех snap-пакетов: $ snap debug api /v2/snaps
Поиск snap-пакетов с именем foo: $ snap debug api '/v2/find?name=foo'
Запрос на обновление snap-пакета some-snap: $ echo '{"action": "refresh"}' | snap debug api -X POST \
-H 'Content-Type: application/json' /v2/snaps/some-snap
Использование: debug api [api-OPTIONS]
--snap-socket
Использовать snap-сокет для доступа
-H, --header
Установить заголовок (можно повторить несколько раз), тип заголовка и значение разделяются двоеточием и пробелом
-X, --request
HTTP-метод для использования (по умолчанию GET)
--fail
Возвращать ошибку при возникновении ошибок запроса
debug confinement
Вывести режим ограничения, в котором работает система
Команда confinement выводит режим ограничения (строгий, частичный или отсутствует), в котором работает система.
debug connectivity
Проверить состояние сетевого подключения
Команда connectivity проверяет сетевое подключение snapd.
debug execution
Получить информацию об аспектах выполнения команд инструментария snap
Отображает отладочную информацию об аспектах выполнения команд инструментария snap, таких как повторное выполнение, расположение инструментов и т. д.
debug execution apparmor
Показать AppArmor
debug execution internal-tool
Показать информацию о внутреннем инструменте
debug execution snap
Показать информацию о выполнении snap
debug features
Получить полный список тегов функций
Отображает вывод в формате JSON, содержащий полный список тегов функций, присутствующих в snapd и snap. Теги функций — это набор данных, описывающих важные пути кода в snapd, включая задачи, изменения, интерфейсы, конечные точки, команды snap и вспомогательные функции обеспечения.
debug lsm
(внутренняя команда) получить информацию о состоянии LSM
(внутренняя команда) получить информацию о состоянии LSM
debug migrate-home
Переместить каталог snap в \~/Snap.
Переместить каталог snap в \~/Snap.
Использование: debug migrate-home [migrate-home-OPTIONS]
--no-wait
debug paths
Вывести системные пути
Команда paths выводит список путей, обнаруженных и используемых snapd.
debug refresh-app-awareness
(внутренняя команда) вывести сведения о refresh-app-awareness
(внутренняя команда) вывести сведения о refresh-app-awareness
Использование: debug refresh-app-awareness [refresh-app-awareness-OPTIONS]
--unicode <по умолчанию: "auto">
debug sandbox-features
Вывести доступные функции sandbox на системе
Команда sandbox выводит теги, описывающие функции отдельных компонентов sandbox, используемых snapd на данной системе.
Использование: debug sandbox-features [sandbox-features-OPTIONS]
--required
Убедиться, что указанный backend:feature доступен
debug seeding
Получить сведения о seeding и preseeding
Получить сведения о seeding и preseeding
Использование: debug seeding [seeding-OPTIONS]
--unicode <по умолчанию: "auto">
debug stacktraces
Получить трассировки стека всех горутин snapd
Получить трассировки стека всех горутин snapd.
debug state
Просмотреть файл состояния snapd.
Просмотреть файл состояния snapd, минуя API snapd.
Использование: debug state [state-OPTIONS]
--abs-time
Отображать абсолютное время (в формате RFC 3339). В противном случае отображать относительное время до 60 дней, затем YYYY-MM-DD.
--changes
Вывести все изменения
--task
ID задачи, которую нужно проверить
--change
ID изменения, которое нужно проверить
--check
Проверить согласованность изменения
--connections
Вывести список всех соединений
--connection
Показать детали соответствующих соединений (snap или snap:plug, snap:slot или snap:plug-or-slot)
--is-seeded
Вывести статус инициализации (true или false)
--dot Вывод в формате Dot (graphviz)
--no-hold
Не выводить задачи в состоянии «Hold» в выходных данных об изменениях
debug timings
Получить временные характеристики задач изменения
Команда timings отображает подробную информацию о времени выполнения каждой задачи.
Использование: debug timings [timings-OPTIONS]
--last Выбрать последнее изменение указанного типа (install, refresh, remove, try, auto-refresh и т. д.).
Знак вопроса в конце типа означает, что в случае отсутствия изменения указанного типа ничего не возвращать (вместо выдачи ошибки).
Обратите внимание, что знак вопроса может потребовать защиты от оболочки.
--ensure
Показать временные характеристики изменения, связанного с заданной активностью Ensure (одно из: auto-refresh, become-operational, refresh-catalogs, refresh-hints, seed)
--all Показать временные характеристики всех выполнений заданной активности Ensure или startup, а не только последней
--startup Показать временные характеристики запуска указанной подсистемы (одно из: load-state, ifacemgr)
--verbose
Показать больше информации
debug validate-seed
Проверить seed-файл snap
Проверить правильность seed-файла snap, расположенного в каталоге, содержащем файл seed.yaml.
disable
Отключить snap в системе
Команда disable отключает snap. Бинарные файлы и службы snap больше не будут доступны, но все данные останутся доступными, и snap можно будет легко снова включить.
Использование: snap [OPTIONS] disable [disable-OPTIONS]
--no-wait
Не ждать завершения операции, а просто вывести идентификатор изменения.
disconnect
Отключить плагин от слота
Команда disconnect отключает плагин от слота. Ее можно вызывать следующими способами:
$ snap disconnect <snap>:<plug> <snap>:<slot>
Отключает указанный плагин от указанного слота.
$ snap disconnect <snap>:<slot или plug>
Отключает все от указанного плагина или слота. Имя snap можно опустить для snap core.
Когда автоматическое соединение отключается вручную, его отключенное состояние сохраняется после обновления snap. Флаг --forget можно добавить к команде disconnect, чтобы сбросить это поведение и, следовательно, разрешить повторное автоматическое соединение после обновления snap.
Использование: snap [OPTIONS] disconnect [disconnect-OPTIONS]
--no-wait
Не ждать завершения операции, а просто вывести идентификатор изменения.
--forget
Забыть запомненное состояние о данном соединении.
download
Загрузить данный snap
Команда download загружает указанный snap, компоненты и соответствующие утверждения в текущий каталог с расширениями файлов .snap, .comp и .assert соответственно.
Использование: snap [OPTIONS] download [download-OPTIONS]
--channel
Использовать этот канал вместо stable
--edge Установить из канала edge
--beta Установить из канала beta
--candidate Установить из канала candidate
--stable Установить из канала stable
--revision
Загрузить указанную ревизию snap. При загрузке компонентов загружать компоненты, связанные с указанной ревизией snap.
--basename
Используйте это базовое имя для файлов snap, компонента и утверждения (по умолчанию <snap>\_<revision>)
--target-directory
Загрузите в этот каталог (по умолчанию текущий каталог)
--only-components
Загружайте только указанные компоненты, а не сам snap
--cohort
Загружайте из указанного набора
enable
Включите snap в системе
Команда enable включает snap, который был ранее отключен.
Использование: snap [ОПЦИИ] enable [ОПЦИИ enable]
--no-wait
Не ждите завершения операции, а просто выведите идентификатор изменения.
export-snapshot
Экспортируйте снимок
Экспортируйте снимок в указанный файл.
find
Найдите пакеты для установки
Команда find выполняет запрос к хранилищу доступных пакетов.
С флагом --private, который требует, чтобы пользователь вошел в систему (см. 'snap help login'), он вместо этого ищет частные snap, к которым пользователь имеет доступ, либо напрямую, либо через функцию совместной работы в хранилище.
Зеленая галочка (при наличии поддержки цвета и Unicode) после имени издателя указывает на то, что издатель был проверен.
Использование: snap [ОПЦИИ] find [ОПЦИИ find]
Псевдонимы: search
--private
Поиск частных snap.
--narrow
Искать только snap в разделе «stable».
--section [="show-all-sections-please"] <по умолчанию: "no-section-specified">
Ограничьте поиск заданным разделом.
--color <по умолчанию: "auto">
Используйте немного цвета, чтобы выделить некоторые вещи.
--unicode <по умолчанию: "auto">
Используйте немного Unicode для повышения удобочитаемости.
forget
Удалите снимок
Команда forget удаляет снимок. Эту операцию нельзя отменить.
Снимок содержит архивы данных пользователя, системы и конфигурации каждого snap, включенного в снимок.
По умолчанию эта команда удаляет все данные в снимке. Кроме того, можно указать данные, которые нужно удалить.
Использование: snap [ОПЦИИ] forget [ОПЦИИ forget]
--no-wait
Не ждите завершения операции, а просто выведите идентификатор изменения.
get
Распечатайте параметры конфигурации
Команда get печатает параметры конфигурации для указанного snap.
$ snap get snap-name username
frank
Если указано несколько имен параметров, возвращаются соответствующие значения:
$ snap get snap-name username password
Key Value
username frank
password ...
Вложенные значения можно получить с помощью точечного пути:
$ snap get snap-name author.name
frank
Использование: snap [ОПЦИИ] get [ОПЦИИ get]
-t Строгая типизация с null и строками в кавычках
-d Всегда возвращать документ, даже с одним ключом
-l Всегда возвращать список, даже с одним ключом
help
Покажите справку по команде
Команда help отображает информацию о командах snap.
Использование: snap [ОПЦИИ] help [ОПЦИИ help]
--all Покажите краткое содержание всех команд
import-snapshot
Импортируйте снимок
Импортируйте экспортированный набор снимков в систему. Снимок импортируется с новым идентификатором снимка и может быть восстановлен с помощью команды restore.
Использование: snap [ОПЦИИ] import-snapshot [ОПЦИИ import-snapshot]
--abs-time
info
Отображение подробной информации о snap-пакетах
Команда info отображает подробную информацию о snap-пакетах.
Snap-пакеты могут быть указаны по имени или по пути; имена ищутся как в магазине, так и среди установленных snap-пакетов; пути могут указывать на файл .snap или на каталог, содержащий распакованный snap-пакет, подходящий для 'snap try' (пример этого — каталог 'prime', создаваемый snapcraft).
Использование: snap [ОПЦИИ] info [ОПЦИИ info]
--color <по умолчанию: "auto">
Используйте небольшое количество цветов для выделения некоторых элементов.
--unicode <по умолчанию: "auto">
Используйте немного символов Unicode для улучшения читаемости.
--abs-time
Отображайте абсолютное время (в формате RFC 3339). В противном случае отображайте относительное время до 60 дней, затем YYYY-MM-DD.
--verbose
Включите больше деталей о snap-пакете (расширенные заметки, базовая версия и т. д.).
install
Установка snap-пакетов в системе
Команда install устанавливает указанные snap-пакеты в системе.
Чтобы установить несколько экземпляров одного и того же snap-пакета, добавьте символ подчеркивания и уникальный идентификатор (для каждого экземпляра) к имени snap-пакета.
Параллельные экземпляры устанавливаются с использованием опции --unaliased, чтобы избежать конфликтов с существующими установками. Это поведение можно изменить, передав опцию --prefer, которая включит все псевдонимы данного snap-пакета, предпочтительно перед конфликтующими псевдонимами других snap-пакетов, автоматические псевдонимы которых будут отключены, а ручные псевдонимы будут удалены.
Если не указаны дополнительные параметры, snap-пакеты устанавливаются с отслеживанием стабильного канала и строгим режимом безопасности. Все доступные каналы snap-пакета перечислены в его выходных данных команды 'snap info'.
При использовании опции --revision последующее обновление обычно отменит переопределение версии, вернув snap-пакет к текущей версии канала, за которым он отслеживается.
Используйте опцию --name, чтобы задать имя экземпляра при установке из snap-файла.
Использование: snap [ОПЦИИ] install [ОПЦИИ install]
--color <по умолчанию: "auto">
Используйте небольшое количество цветов для выделения некоторых элементов.
--unicode <по умолчанию: "auto">
Используйте немного символов Unicode для улучшения читаемости.
--no-wait
Не ждите завершения операции, а просто выведите идентификатор изменения.
--channel
Используйте этот канал вместо стабильного
--edge
Установите из канала edge
--beta
Установите из канала beta
--candidate
Установите из канала candidate
--stable
Установите из стабильного канала
--devmode
Поместите snap-пакет в режим разработки и отключите режим безопасности
--jailmode
Поместите snap-пакет в режим строгой изоляции
--classic
Поместите snap-пакет в классический режим и отключите режим безопасности
--revision
Установите указанную ревизию snap-пакета
--dangerous
Установите указанный snap-файл, даже если для него нет предварительно подтвержденных подписей, что означает, что он не был проверен и может быть опасным (опция --devmode подразумевает это)
--unaliased
Установите данный snap-пакет, не включая его автоматические псевдонимы
--prefer
Включить все псевдонимы данного снапа, отдавая им приоритет перед конфликтующими псевдонимами других снапов.
--name
Установить файл снапа под данным именем экземпляра.
--cohort
Установить снап в указанной группе.
--ignore-validation
Игнорировать проверку другими снапами, блокирующими установку.
--transaction <по умолчанию: "per-snap">
Выполнять транзакцию для каждого снапа или для всех указанных снапов.
--quota-group
Добавить снап в группу квот при установке.
interface
Отобразить сведения о снап-интерфейсах.
Команда `interface` отображает сведения о снап-интерфейсах.
Если имя интерфейса не указано, отображается список имен интерфейсов, имеющих хотя бы одно подключение, или список всех интерфейсов, если указан параметр `--all`.
Использование: snap [ОПЦИИ] interface [ОПЦИИ_ИНТЕРФЕЙСА]
--attrs
Отобразить атрибуты интерфейса.
--all
Включить неиспользуемые интерфейсы.
known
Отобразить известные утверждения указанного типа.
Команда `known` отображает известные утверждения указанного типа. Если после типа утверждения указаны пары `header=value`, то отображаемые утверждения также должны иметь указанные заголовки, соответствующие предоставленным значениям.
Использование: snap [ОПЦИИ] known [ОПЦИИ_KNOWN]
--remote
Запросить утверждение из магазина, используя snapd, если это возможно.
--direct
Запросить утверждение из магазина, не пытаясь использовать snapd.
list
Отобразить список установленных снапов.
Команда `list` отображает сводку установленных в системе снапов.
Зеленая галочка (при поддержке цвета и Unicode) после имени издателя указывает, что издатель был проверен.
Использование: snap [ОПЦИИ] list [ОПЦИИ_LIST]
--all
Отобразить все ревизии.
--color <по умолчанию: "auto">
Использовать небольшое количество цветов для выделения некоторых элементов.
--unicode <по умолчанию: "auto">
Использовать небольшое количество символов Unicode для улучшения читаемости.
login
Аутентифицироваться в snapd и магазине.
Команда `login` выполняет аутентификацию пользователя в snapd и магазине, а также сохраняет учетные данные в файле `~/.snap/auth.json`. После этого дальнейшая связь с snapd будет осуществляться с использованием этих учетных данных.
Необязательно выполнять вход для взаимодействия с snapd. Однако, выполнив вход, можно взаимодействовать без использования `sudo`, а также получить доступ к некоторым функциям, предназначенным для разработчиков, как описано в справке для команд `find`, `install` и `refresh`.
Учетную запись можно создать по адресу https://login.ubuntu.com
logout
Выйти из snapd и магазина.
Команда `logout` выполняет выход текущего пользователя из snapd и магазина.
logs
Получить журналы для служб.
Команда `logs` получает журналы указанных служб и отображает их в хронологическом порядке.
Использование: snap [ОПЦИИ] logs [ОПЦИИ_LOGS]
--abs-time
Отображать абсолютное время (в формате RFC 3339). В противном случае отображать относительное время до 60 дней, затем `YYYY-MM-DD`.
-n <по умолчанию: "10">
Отображать только указанное количество строк или `all`.
-f
Ожидать новые строки и выводить их по мере их поступления.
model
Получить активную модель для данного устройства.
Команда `model` возвращает информацию об активной модели утверждений для данного устройства.
По умолчанию в выходных данных включается только основная информация для идентификации модели, но ее можно расширить, включив все немета-заголовки утверждения.
Подробный вывод представлен в структурированном формате, похожем на YAML.
Аналогично, для вывода можно использовать активное серийное утверждение вместо утверждения модели.
Использование: snap [ОПЦИИ] model [ОПЦИИ_МОДЕЛИ]
--abs-time
Отображать абсолютное время (в формате RFC 3339). В противном случае отображать относительное время до 60 дней, затем YYYY-MM-DD.
--color <по умолчанию: "auto">
Использовать немного цвета для выделения некоторых элементов.
--unicode <по умолчанию: "auto">
Использовать немного символов Unicode для улучшения читаемости.
--serial
Выводить серийное утверждение вместо утверждения модели.
--verbose
Выводить все поля конкретного утверждения.
--assertion
Выводить необработанное утверждение.
okay
Подтвердить предупреждения
Команда `okay` подтверждает предупреждения, перечисленные в `snap warnings`.
После подтверждения предупреждение больше не будет отображаться, пока оно не повторится и не пройдет достаточно времени.
pack
Упаковать указанный каталог в snap
Команда `pack` упаковывает указанный каталог `snap-dir` в snap и записывает результат в каталог `target-dir`. Если `target-dir` не указан, результат записывается в текущий каталог. Если опущены и `source-dir`, и `target-dir`, команда `pack` упаковывает текущий каталог.
Имя файла snap по умолчанию может быть получено полностью из `snap.yaml`, но в некоторых ситуациях проще, если скрипт передает имя файла. В этих случаях можно использовать `--filename`, чтобы переопределить имя файла по умолчанию. Если это имя файла не является абсолютным, оно будет рассматриваться как относительное к `targetdir`.
При использовании с `--check-skeleton`, `pack` только проверяет, содержит ли `snap-dir` действительные метаданные snap и выдает ошибку в противном случае. Приложения, перечисленные в файле метаданных snap, но имеющие неправильные биты разрешений, вызывают ошибку. Приложения, отсутствующие в `snap-dir`, перечислены в диагностических сообщениях.
Использование: snap [ОПЦИИ] pack [ОПЦИИ_ПАКОВКИ]
--check-skeleton
Только проверка метаданных `snap-dir`
--filename
Вывод в этот файл
--compression
Используемое сжатие (например, xz или lzo)
prefer
Включить псевдонимы из snap, отключив любые конфликтующие псевдонимы
Команда `prefer` включает все псевдонимы указанного snap, отдавая им приоритет перед конфликтующими псевдонимами других snap, псевдонимы которых будут отключены (или удалены для ручных псевдонимов).
Использование: snap [ОПЦИИ] prefer [ОПЦИИ_ПРИОРИТЕТА]
--no-wait
Не ждать завершения операции, а только выводить идентификатор изменения.
prepare-image
Подготовить образ устройства
Команда `prepare-image` выполняет некоторые шаги, необходимые для создания образов устройств.
Для основных образов она не вызывается напрямую, а обычно используется через `ubuntu-image`.
Для подготовки классических образов поддерживается режим `--classic`.
Использование: snap [ОПЦИИ] prepare-image [ОПЦИИ_ПОДГОТОВКИ_ОБРАЗА]
--classic
Включить классический режим для подготовки классического образа.
--preseed
Предварительная настройка (только для UC20+)
--preseed-sign-key
Имя ключа, используемого для подписи утверждения preseed, в противном случае используется ключ по умолчанию.
--apparmor-features-dir
Необязательный путь к каталогу с функциями AppArmor для ядра (только для UC20+).
--sysfs-overlay
Необязательный наложение sysfs, которое будет использоваться при выполнении этапов предварительной настройки.
--arch
Укажите архитектуру для snap для --classic, когда модель этого не делает.
--channel
Канал, который нужно использовать.
--snap <snap>[=<channel>]
Включите указанный snap из магазина или локального файла и/или укажите канал, за которым нужно следить для данного snap.
--comp <snap>+<comp>
Включите указанный компонент из магазина или локального файла.
--revisions
Укажите файл seeds.manifest, содержащий ссылки на точные версии предоставленных snap, которые должны быть установлены.
--write-revisions [="./seed.manifest"]
Записывает файл манифеста, содержащий ссылки на точные версии snap, используемые для создания образа. Путь к манифесту является необязательным.
--validation
Управление тем, следует ли игнорировать или применять проверки (по умолчанию: игнорировать).
--allow-snapd-kernel-mismatch
Разрешено ли несоответствие между версиями snap snapd и snapd в ядре.
--assert <filename>
Включите утверждение из локального файла.
quota
Показать группу квот для набора snap.
Команда quota показывает информацию о группе квот, включая набор snap и любые подгруппы, которые она содержит, а также ограничения ресурсов и текущее использование этих ограниченных ресурсов.
quotas
Показать группы квот.
Команда quotas показывает все группы квот.
reboot
Перезагрузитесь в выбранную систему и режим.
Команда reboot перезагружает систему в определенный режим выбранной системы восстановления.
При вызове без метки системы и без режима она просто запускает обычную перезагрузку.
При вызове без метки будет использоваться текущая система для режима "run". Система восстановления по умолчанию будет использоваться для режимов "recover", "factory-reset" и "install".
Обратите внимание, что режим "run" доступен только для текущей системы.
Использование: snap [ОПЦИИ] reboot [ОПЦИИ перезагрузки]
--run
Загрузитесь в режим run.
--install
Загрузитесь в режим установки.
--recover
Загрузитесь в режим восстановления.
--factory-reset
Загрузитесь в режим сброса до заводских настроек.
recovery
Список доступных систем восстановления.
Команда recovery перечисляет доступные системы восстановления.
С помощью --show-keys она отображает ключи восстановления, которые можно использовать для разблокировки зашифрованных разделов, если автоматическая разблокировка для конкретного устройства не работает.
Использование: snap [ОПЦИИ] recovery [ОПЦИИ восстановления]
--color <по умолчанию: "auto">
Используйте немного цвета, чтобы выделить некоторые вещи.
--unicode <по умолчанию: "auto">
Используйте немного символов Unicode, чтобы улучшить читаемость.
--show-keys
Показать ключи восстановления (если доступны) для разблокировки зашифрованных разделов.
refresh
Обновить snap в системе.
Команда refresh обновляет указанные snap или все snap в системе, если они не указаны.
Без дополнительных опций snap обновляются до текущей версии канала, на который они подписаны, сохраняя при этом параметры ограничения. Все доступные каналы snap перечислены в выводе команды 'snap info'.
При использовании флага --revision последующее обновление обычно отменяет примененные изменения.
Флаг --hold используется для отсрочки обновлений snap для всех snap-ов, если не указаны конкретные snap-ы, или для указанных snap-ов.
Если не указаны snap-ы, флаг --hold действует только на автоматические обновления и не блокирует обычные запросы на обновление из команды snap refresh или конкретные запросы на обновление из команды snap refresh target-snap.
Если указаны snap-ы, флаг --hold действует как на их автоматические обновления, так и на обычные запросы на обновление из команды snap refresh. Однако конкретные запросы на обновление из команды snap refresh target-snap остаются без изменений и будут выполнены.
Использование: snap [OPTIONS] refresh [refresh-OPTIONS]
^ -color <default: "auto">
Используйте немного цвета для выделения некоторых элементов.
^ -unicode <default: "auto">
Используйте немного символов Unicode для улучшения читаемости.
^ -abs-time
Отображайте абсолютное время (в формате RFC 3339). В противном случае отображайте относительное время до 60 дней, затем YYYY-MM-DD.
^ -no-wait
Не ждите завершения операции, а просто выведите идентификатор изменения.
^ -channel
Используйте этот канал вместо стабильного.
^ -edge
Установите из канала edge.
^ -beta
Установите из канала beta.
^ -candidate
Установите из канала candidate.
^ -stable
Установите из стабильного канала.
^ -devmode
Переведите snap в режим разработки и отключите безопасность.
^ -jailmode
Переведите snap в режим усиленной изоляции.
^ -classic
Переведите snap в классический режим и отключите безопасность.
^ -amend
Разрешите попытку обновления snap, который неизвестен в магазине.
^ -revision
Обновите до указанной ревизии.
^ -cohort
Обновите snap в указанную группу.
^ -leave-cohort
Обновите snap, чтобы вывести его из текущей группы.
^ -list
Отобразите новые версии snap-ов, которые будут обновлены при следующем обновлении.
^ -time
Отобразите информацию об автоматическом обновлении, но не выполняйте обновление.
^ -ignore-validation
Игнорируйте проверку другими snap-ами, блокирующими обновление.
^ -transaction <default: "per-snap">
Используйте одну транзакцию для каждого snap-а или одну для всех указанных snap-ов.
^ -hold [="forever"]
Приостановите обновления на указанный период времени (или навсегда, если значение не указано).
^ -unhold
Снимите приостановку обновлений.
^ emodel
Измените модель утверждения устройства, либо на новую ревизию, либо на полностью новую модель.
В процессе применяются все подразумеваемые изменения к устройству: новые необходимые snap-ы, новое ядро или гаджет и т. д.
Snap-ы и утверждения загружаются из магазина, если они не предоставлены в виде локальных файлов, указанных с помощью флагов --snap и --assertion. При использовании этих флагов предполагается, что все необходимые snap-ы и файлы утверждений предоставлены локально, в противном случае изменение модели не удастся.
Использование: snap [OPTIONS] remodel [remodel-OPTIONS]
^ -no-wait
Не ждите завершения операции, а просто выведите идентификатор изменения.
^ -snap
Используйте один или несколько локально доступных snap-ов.
^ -assertion
Используйте один или несколько локально доступных файлов утверждений.
--offline
Используйте только предварительно установленные и локально предоставленные снапы и утверждения. Предоставление любых снапов или утверждений локально подразумевает использование опции --offline.
remove
Удаляет снапы из системы.
Команда remove удаляет указанный экземпляр снапа из системы.
По умолчанию удаляются все ревизии снапа, включая их данные и общую директорию данных. При передаче опции --revision удаляется только указанная ревизия.
Если автоматические снимки не отключены, при удалении сохраняется снимок всех данных снапа, который затем становится доступным для последующего восстановления с помощью команды snap restore. Опция --purge отключает автоматическое создание снимков.
Использование: snap [OPTIONS] remove [remove-OPTIONS]
--no-wait
Не ждать завершения операции, а просто выводить идентификатор изменения.
--revision
Удалять только указанную ревизию.
--purge
Удалить снап без сохранения снимка его данных.
--terminate
Завершить выполнение процессов, связанных со снапом, перед удалением.
remove-quota
Удалить группу квот.
Команда remove-quota удаляет указанную группу квот.
В настоящее время можно удалять только группы квот, не имеющие подгрупп. Чтобы удалить группу квот с подгруппами, сначала необходимо удалить подгруппы, пока не останется ни одной подгруппы для группы, после чего можно удалить саму группу.
Использование: snap [OPTIONS] remove-quota [remove-quota-OPTIONS]
--no-wait
restart
Перезапустить службы.
Команда restart перезапускает указанные службы.
Если указана опция --reload, для каждой службы, у которой есть команда перезагрузки, выполняется перезагрузка вместо перезапуска.
Использование: snap [OPTIONS] restart [restart-OPTIONS]
--no-wait
Не ждать завершения операции, а просто выводить идентификатор изменения.
--system
Операция должна влиять только на системные службы.
--user Операция должна влиять только на пользовательские службы для текущего пользователя.
--users
Если указано и установлено значение 'all', операция должна влиять на службы для всех пользователей.
--reload
Если у службы есть команда перезагрузки, используйте ее вместо перезапуска.
restore
Восстановить снимок.
Команда restore заменяет текущие пользовательские, системные данные и данные конфигурации включенных снапов соответствующими данными из указанного снимка.
По умолчанию эта команда восстанавливает все данные в снимке. Кроме того, можно указать данные, для которых нужно выполнить восстановление, или для каких пользователей, или комбинацию этих параметров.
Если снап включен в операцию восстановления, исключить его системные данные и данные конфигурации из восстановления в настоящее время невозможно. Это ограничение может быть снято в будущем.
Использование: snap [OPTIONS] restore [restore-OPTIONS]
--no-wait
Не ждать завершения операции, а просто выводить идентификатор изменения.
--users
Восстановить данные только для определенных пользователей (через запятую) (по умолчанию: все пользователи).
revert
Возвращает указанный снап к предыдущему состоянию.
Команда revert возвращает указанный снап к состоянию, предшествовавшему последнему обновлению. Это повторно активирует предыдущую ревизию снапа и использует исходные данные, связанные с этой ревизией, отбрасывая любые изменения данных, внесенные последней ревизией. В качестве исключения данные, которыми снап явно решает делиться между ревизиями, не затрагиваются процессом отката.
Использование: snap [ОПЦИИ] revert [ОПЦИИ revert]
--no-wait
Не ждать завершения операции, а просто вывести идентификатор изменения.
--devmode
Перевести snap в режим разработки и отключить безопасность.
--jailmode
Перевести snap в режим усиленного контроля.
--classic
Перевести snap в классический режим и отключить безопасность.
--revision
Вернуться к указанному номеру редакции.
run
Запустить указанную команду snap.
Команда run выполняет указанную команду snap с соответствующими настройками безопасности и окружением.
Использование: snap [ОПЦИИ] run [ОПЦИИ run] <ИМЯ-SNAP>.<ИМЯ-ПРИЛОЖЕНИЯ> [АРГУМЕНТЫ-ПРИЛОЖЕНИЯ-SNAP]
--shell
Запустить оболочку вместо команды (полезно для отладки).
--debug-log
Включить отладочное ведение журнала во время начальных фаз запуска snap.
--strace [="with-strace"] <по умолчанию: "no-strace">
Запустить команду под strace (полезно для отладки). Дополнительные параметры strace можно указать здесь. Передайте --raw в strace для вспомогательных программ snap.
--gdbserver [=":0"] <по умолчанию: "no-gdbserver">
Запустить команду с помощью gdbserver.
--trace-exec
Отображать данные о времени выполнения exec.
save
Сохранить снимок текущих данных.
Команда save создает снимок текущих данных пользователя, системы и конфигурации для указанных snap-пакетов.
По умолчанию эта команда сохраняет данные для всех snap-пакетов и всех пользователей. В качестве альтернативы можно указать, данные для каких snap-пакетов или для каких пользователей следует сохранить, или их комбинацию.
Если snap-пакет включен в операцию сохранения, исключить его системные и конфигурационные данные из снимка в данный момент невозможно. Это ограничение может быть снято в будущем.
Использование: snap [ОПЦИИ] save [ОПЦИИ save]
--no-wait
Не ждать завершения операции, а просто вывести идентификатор изменения.
--abs-time
Отображать абсолютное время (в формате RFC 3339). В противном случае отображать краткое относительное время.
--users
Сделать снимок данных только для определенных пользователей (через запятую) (по умолчанию: все пользователи).
saved
Список текущих сохраненных снимков.
Команда saved отображает список снимков, которые были созданы ранее с помощью команды save.
Использование: snap [ОПЦИИ] saved [ОПЦИИ saved]
--abs-time
Отображать абсолютное время (в формате RFC 3339). В противном случае отображать краткое относительное время.
--id Показывать только определенный снимок.
services
Запросить статус служб.
Команда services перечисляет информацию об указанных службах или о службах во всех установленных snap-пакетах.
Если выполняется от имени пользователя root, столбец «Запуск» любой пользовательской службы будет указывать, включена ли она глобально (т. е. systemctl is-enabled). Чтобы просмотреть фактический статус «Запуск» | «Текущий» для пользовательских служб для самого пользователя root, можно предоставить параметр --user.
Если команда выполняется от имени пользователя, не являющегося root, статус «Запущено» | «Текущий» для пользовательских служб будет отражать текущий статус для пользователя, выполнившего команду. Чтобы просмотреть глобальный статус включения пользовательских служб, можно использовать флаг --global.
Использование: snap [ОПЦИИ] services [ОПЦИИ_СЛУЖБ]
-g, --global
Отображает глобальный статус включения для пользовательских служб вместо статуса для текущего пользователя.
-u, --user
Отображает текущий статус пользовательских служб вместо глобального статуса включения.
set
Изменяет параметры конфигурации.
Команда `set` изменяет указанные параметры конфигурации.
$ snap set имя-пакета имя-пользователя=frank пароль=$ПАРОЛЬ
Все изменения конфигурации сохраняются одновременно и только после успешного завершения команды конфигурации пакета.
Вложенные значения могут быть изменены с помощью точечного пути:
$ snap set имя-пакета author.name=frank
Параметр конфигурации может быть удален с помощью восклицательного знака:
$ snap set имя-пакета author!
Использование: snap [ОПЦИИ] set [ОПЦИИ_SET]
--no-wait
Не ждать завершения операции, а просто вывести идентификатор изменения.
-t
Строго интерпретировать значение как документ JSON.
-s
Интерпретировать значение как строку.
set-quota
Создает или обновляет группу квот.
Команда `set-quota` обновляет или создает группу квот с указанным набором пакетов.
Группа квот устанавливает ограничения на ресурсы для набора пакетов или служб пакетов, которые она содержит. Пакеты могут быть включены только в одну группу квот, но группы квот могут быть вложенными. Вложенные группы квот подчиняются ограничению, согласно которому общая сумма каждой существующей квоты во вложенных группах не может превышать квоту родительской группы, частью которой являются вложенные группы.
Все указанные пакеты добавляются в группу; для удаления пакета из группы квот необходимо удалить всю группу с помощью команды `remove-quota` и воссоздать ее без этого пакета. Для удаления подгруппы из группы квот подгруппу необходимо удалить непосредственно с помощью команды `remove-quota`.
Для установки ограничений на отдельные службы одна или несколько служб могут быть помещены во вложенную группу. Соответствующий пакет для каждой службы должен принадлежать родительской группе вложенной группы. Эти вложенные группы будут иметь те же ограничения, что и вложенные группы, что означает, что их совокупное использование ресурсов не может превышать ограничения ресурсов, установленные для родительской группы. Вложенные группы, содержащие службы, не могут иметь собственные квоты журнала, и вместо этого автоматически наследуют любую квоту журнала, которая может быть установлена для родительской группы квот.
Предел памяти для группы квот можно увеличить, но не уменьшить. Чтобы уменьшить предел памяти для группы квот, необходимо удалить всю группу с помощью команды `remove-quota` и воссоздать ее с более низким пределом. Увеличение предела памяти для группы квот не перезапускает службы, связанные с пакетами в группе квот.
Предел ЦП для группы квот можно как увеличить, так и уменьшить после установки на группе квот. Предел ЦП можно указать в виде одного процента, что означает, что группе квот разрешено определенное процентное значение ресурсов ЦП. Установка значения 50% означает, что группе квот разрешено использовать до 50% всех ядер ЦП в разрешенном наборе ЦП. Установка процента на 2100% означает, что группе квот разрешено использовать до 100% на двух ядрах ЦП.
Предел CPU для группы квот можно изменить, добавив новые CPU или удалив существующие CPU из уже установленной квоты.
Предел потоков для группы квот можно увеличить, но нельзя уменьшить. Чтобы уменьшить предел потоков для группы квот, необходимо полностью удалить группу с помощью команды remove-quota и воссоздать ее с меньшим пределом.
Пределы журнала можно увеличивать и уменьшать после установки на группу. Установка предела журнала приведет к тому, что снимки в этой группе будут помещены в одно и то же пространство имен журнала. Это повлияет на поведение команды log.
На существующие группы квот можно устанавливать новые квоты, но существующие квоты нельзя удалять из группы квот без удаления и воссоздания всей группы.
Добавление новых снимков в группу квот приведет к перезапуску всех не отключенных служб в этом снимке.
Существующую подгруппу нельзя переместить из одной родительской группы в другую.
Использование: snap [ОПЦИИ] set-quota [ОПЦИИ set-quota]
--no-wait
Не ждать завершения операции, а просто вывести идентификатор изменения.
--memory [=]
Предел памяти
--cpu [=]
Предел CPU
--cpu-set [=]
Предел CPU set
--threads [=]
Предел потоков
--journal-size [=]
Предел размера журнала
--journal-rate-limit [=]
Предел скорости журнала в виде <количество сообщений>/<период>
--parent [=]
Родительская группа квот
start
Запустить службы
Команда start запускает и, при необходимости, включает указанные службы.
Использование: snap [ОПЦИИ] start [ОПЦИИ start]
--no-wait
Не ждать завершения операции, а просто вывести идентификатор изменения.
--system
Операция должна затрагивать только системные службы.
--user Операция должна затрагивать только пользовательские службы для текущего пользователя.
--users
Если указано и установлено значение 'all', операция должна затрагивать службы для всех пользователей.
--enable
Помимо запуска службы сейчас, организовать ее запуск при загрузке.
stop
Остановить службы
Команда stop останавливает и, при необходимости, отключает указанные службы.
Использование: snap [ОПЦИИ] stop [ОПЦИИ stop]
--no-wait
Не ждать завершения операции, а просто вывести идентификатор изменения.
--system
Операция должна затрагивать только системные службы.
--user Операция должна затрагивать только пользовательские службы для текущего пользователя.
--users
Если указано и установлено значение 'all', операция должна затрагивать службы для всех пользователей.
--disable
Помимо остановки службы сейчас, организовать ее исключение из автоматического запуска.
switch
Переключает snap на другой канал
Команда switch переключает указанный snap на другой канал без обновления. Все доступные каналы snap указаны в его выводе команды snap info.
Использование: snap [ОПЦИИ] switch [ОПЦИИ switch]
--no-wait
Не ждать завершения операции, а просто выводить идентификатор изменения.
--channel
Использовать этот канал вместо стабильного.
--edge
Устанавливать из канала edge.
--beta
Устанавливать из канала beta.
--candidate
Устанавливать из канала candidate.
--stable
Устанавливать из стабильного канала.
--cohort
Переключает снип в указанную когорту.
--leave-cohort
Переключает снип из его текущей когорты.
tasks
Выводит список задач изменения.
Команда tasks отображает сводку задач, связанных с отдельным изменением.
Использование: snap [ОПЦИИ] tasks [ОПЦИИ-tasks]
Псевдонимы: change
--abs-time
Отображать абсолютное время (в формате RFC 3339). В противном случае отображать относительное время до 60 дней, затем YYYY-MM-DD.
--last
Выбрать последнее изменение заданного типа (install, refresh, remove, try, auto-refresh и т. д.). Знак вопроса в конце типа означает, что если изменение заданного типа не найдено, ничего не делать (вместо выдачи ошибки). Обратите внимание, что знак вопроса может потребоваться экранировать от оболочки.
try
Тестирует распакованный снип в системе.
Команда try устанавливает распакованный снип в систему для целей тестирования. Содержимое распакованного снипа продолжает использоваться даже после установки, поэтому изменения, не связанные с метаданными, сразу же вступают в силу. Изменения метаданных, такие как изменения, выполненные в файле snap.yaml, потребуют повторной установки, чтобы вступить в силу.
Если аргумент snap-dir опущен, команда try попытается вывести его, если в текущем рабочем каталоге можно найти либо файл snapcraft.yaml и основной каталог, либо файл meta/snap.yaml.
Использование: snap [ОПЦИИ] try [ОПЦИИ-try]
--no-wait
Не ждать завершения операции, а просто выводить идентификатор изменения.
--devmode
Переводит снип в режим разработки и отключает ограничение безопасности.
--jailmode
Переводит снип в режим с усиленным ограничением.
--classic
Переводит снип в классический режим и отключает ограничение безопасности.
unalias
Удаляет ручной псевдоним или псевдонимы для всего снипа.
Команда unalias удаляет один псевдоним, если предоставленный аргумент является ручным псевдонимом, или отключает все псевдонимы снипа, включая ручные, если аргументом является имя снипа.
Использование: snap [ОПЦИИ] unalias [ОПЦИИ-unalias]
--no-wait
Не ждать завершения операции, а просто выводить идентификатор изменения.
unset
Удаляет параметры конфигурации.
Команда unset удаляет запрошенные параметры конфигурации.
$ snap unset snap-name name address
Все изменения конфигурации сохраняются одновременно и только после успешного завершения команды конфигурации снипа.
Вложенные значения можно удалить с помощью точечного пути:
$ snap unset snap-name user.name
Использование: snap [ОПЦИИ] unset [ОПЦИИ-unset]
--no-wait
Не ждать завершения операции, а просто выводить идентификатор изменения.
validate
Выводит список или применяет наборы проверки.
Команда validate выводит список или применяет наборы проверки, которые указывают, какие снипы должны быть установлены вместе или каким снипам разрешено быть установленными вместе, с возможностью ограничения фиксированными версиями.
Набор проверки может находиться либо в режиме мониторинга, в этом случае его ограничения не применяются, либо в режиме применения, в этом случае snapd не будет разрешать операции, которые приведут к нарушению ограничений набора проверки.
Использование: snap [ОПЦИИ] validate [validate-ОПЦИИ]
--monitor
Отслеживать заданный набор проверок.
--enforce
Применять заданный набор проверок.
--forget
Удалять заданный набор проверок.
--refresh
Обновить или установить пакеты, чтобы соответствовать примененным наборам проверок.
--color <по умолчанию: "auto">
Использовать немного цвета для выделения некоторых элементов.
--unicode <по умолчанию: "auto">
Использовать немного Unicode для улучшения читаемости.
--no-wait
Не ждать завершения операции, а просто выводить идентификатор изменения.
version
Показать сведения о версии.
Команда version отображает версии работающего клиента, сервера и операционной системы.
wait
Ожидать конфигурацию.
Команда wait ожидает, пока конфигурация не станет истинной.
warnings
Показать предупреждения.
Команда warnings отображает предупреждения, о которых сообщалось системе.
После того, как предупреждения были перечислены с помощью 'snap warnings', 'snap okay' можно использовать для их отключения. Предупреждение, которое было отключено таким образом, больше не будет отображаться, если оно не произойдет снова и не пройдет время ожидания.
Предупреждения автоматически истекают, и после этого они забываются.
Использование: snap [ОПЦИИ] warnings [warnings-ОПЦИИ]
--abs-time
Отображать абсолютное время (в формате RFC 3339). В противном случае отображать относительное время до 60 дней, затем YYYY-MM-DD.
--unicode <по умолчанию: "auto">
Использовать немного Unicode для улучшения читаемости.
--all
Показать все предупреждения.
--verbose
Показать больше информации.
watch
Наблюдать за процессом изменения.
Команда watch ожидает завершения указанного change-id и показывает прогресс (если доступен).
Использование: snap [ОПЦИИ] watch [watch-ОПЦИИ]
--last
Выбрать последнее изменение указанного типа (install, refresh, remove, try, auto-refresh и т. д.). Знак вопроса в конце типа означает, что если изменение данного типа не найдено, ничего не делать (вместо возврата ошибки). Обратите внимание, что знак вопроса может потребовать экранирования от оболочки.
whoami
Показать адрес электронной почты, с которой вошел пользователь.
Команда whoami показывает адрес электронной почты, с которой вошел пользователь.
ПРИМЕЧАНИЯ
Онлайн-документация
https://docs.snapcraft.io
ОШИБКИ
Пожалуйста, сообщайте обо всех ошибках по адресу https://bugs.launchpad.net/snapd/+filebug.