snap - スナップと対話するためのツール
概要
snap [オプション]
説明
^ nap コマンドを使用すると、スナップのインストール、構成、更新、および削除ができます。スナップは、
多くの異なる Linux ディストリビューションで動作するパッケージであり、最新のアプリとユーティリティを安全に配信および実行できます。
オプション
アプリケーションオプション
コマンド
abort
保留中の変更を中止します。
^ bort コマンドは、まだ保留中のタスクがある変更を中止しようとします。
使用法: snap [オプション] abort [abort-オプション]
--last 指定されたタイプ (インストール、更新、削除、試行、自動更新など) の最後の変更を選択します。
タイプの最後に疑問符が付いている場合、指定されたタイプの変更が見つからない場合にエラーを返す代わりに、何も行いません。
疑問符をシェルから保護する必要がある場合があります。
ack
システムにアサートを追加します。
^ ck コマンドは、システムのアサートデータベースにアサートを追加しようとします。
アサートは、既存のアサートの新しいバージョンであり、既存のアサートを置き換えることもあります。
アサートが成功するには、アサートが有効であり、既知の公開キーで署名が検証され、アサートが一貫性があり、データベース内の前提条件と一致している必要があります。
alias
手動エイリアスを設定します。
^ lias コマンドは、指定されたスナップアプリケーションを指定されたエイリアスにエイリアスを設定します。
この手動エイリアスを設定すると、それぞれのアプリケーションコマンドは、単にエイリアスを使用して呼び出すことができます。
使用法: snap [オプション] alias [alias-オプション]
--no-wait
操作が完了するのを待たずに、変更 ID を出力します。
aliases
システム内のエイリアスをリストします。
^ liases コマンドは、システムで使用できるすべてのエイリアスとそのステータスをリストします。
$ snap aliases <スナップ>
指定されたスナップによって定義されたエイリアスのみをリストします。
changes
システム変更をリストします。
^ hanges コマンドは、最近実行されたシステム変更の概要を表示します。
使用法: snap [オプション] changes [changes-オプション]
--abs-time
絶対時間 (RFC 3339 形式) を表示します。それ以外の場合は、相対時間を 60 日まで表示し、YYYY-MM-DD を表示します。
check-snapshot
スナップショットをチェックします。
^ heck-snapshot コマンドは、指定されたスナップショットに含まれるスナップのユーザー、システム、および構成データを検証します。
チェック操作は、スナップショットを復元するときに実行されるのと同じデータ整合性検証を実行します。
デフォルトでは、このコマンドはスナップショット内のすべてのデータをチェックします。または、チェックするスナップのデータ、またはチェックするユーザーを指定することもできます。
スナップがチェック操作に含まれている場合、そのスナップのシステムデータと構成データをチェックから除外することは現在できません。この制限は将来削除される可能性があります。
使用方法:snap [オプション] check-snapshot [check-snapshot-オプション]
--no-wait
操作の完了を待たずに、変更 ID のみを表示します。
--users
特定のユーザーのデータのみをチェックします(カンマ区切り)(デフォルト:すべてのユーザー)。
components
インストールされているスナップの利用可能なコンポーネントとインストール済みコンポーネントを一覧表示します。
components コマンドは、現在インストールされているスナップの利用可能なコンポーネントとインストール済みコンポーネントの概要を表示します。
特定のインストール済みスナップのコンポーネントを照会するには、スナップ名を引数として指定します。
connect
プラグをスロットに接続します。
connect コマンドは、プラグをスロットに接続します。次の方法で呼び出すことができます。
$ snap connect <スナップ>:<プラグ> <スナップ>:<スロット>
指定されたプラグを指定されたスロットに接続します。
$ snap connect <スナップ>:<プラグ> <スナップ>
特定のプラグを、指定されたスナップ内の接続されたインターフェイスと一致する唯一のスロットに接続します。一致するスロットが複数存在する場合、コマンドは失敗します。
$ snap connect <スナップ>:<プラグ>
指定されたプラグを、コアスナップ内のプラグ名と一致する名前のスロットに接続します。
使用方法:snap [オプション] connect [connect-オプション]
--no-wait
操作の完了を待たずに、変更 ID のみを表示します。
connections
インターフェイス接続を一覧表示します。
<スナップ> が指定されていない場合、システム内のすべてのスナップの接続されているプラグとスロットが一覧表示されます。このモードでは、--all を渡すと、接続されていないプラグとスロットも一覧表示されます。
$ snap connections <スナップ>
指定されたスナップの接続されているプラグとスロット、および接続されていないプラグとスロットを一覧表示します。
使用方法:snap [オプション] connections [connections-オプション]
--all
接続されているプラグとスロット、および接続されていないプラグとスロットを表示します。
create-cohort
スナップのセットのコホートキーを作成します。
create-cohort コマンドは、指定されたスナップのセットのコホートキーのセットを作成します。
コホートは、他の制約(チャネルまたはアーキテクチャなど)が与えられた時点で、スナップの「チャネルマップ」のスナップショットであり、スナップの修正のセットを固定します。コホートは、システム間で機能する不透明なスナップごとのキーによって識別されます。特定のコホートキーを使用してスナップをインストールまたは更新すると、90 日間固定の修正が使用されます。その後、同じコホートキーの下で、修正の新しいセットが固定され、90 日間のウィンドウが開始されます。
debug
デバッグコマンドを実行します。
debug コマンドには、追加のサブコマンドのセットが含まれています。
デバッグコマンドは、予告なしに削除される可能性があり、開発環境以外のシステムでは機能しない場合があります。
debug api
snapd API への生のクエリを実行します。
snapd API への生のクエリを実行します。複雑な入力は stdin から読み取り、出力は stdout に出力されます。以下の例を参照してください。
すべてのスナップを一覧表示:$ snap debug api /v2/snaps
名前が "foo" のスナップを見つける:$ snap debug api '/v2/find?name=foo'
スナップ "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 コマンドは、システムが動作する confinement モード(strict、partial、または none)を表示します。
debug connectivity
ネットワーク接続ステータスを確認する
connectivity コマンドは、snapd のネットワーク接続を確認します。
debug execution
snap ツールチェーンコマンドの実行に関する情報を取得する
snap ツールチェーンの実行に関するデバッグ情報を表示します。これには、再実行、ツールの場所などが含まれます。
debug execution apparmor
AppArmor を表示する
debug execution internal-tool
内部ツールの実行情報を表示する
debug execution snap
snap の実行情報を表示する
debug features
すべての機能タグのリストを取得する
snapd と snap に存在するすべての機能タグのリストを含む JSON 出力を表示します。機能タグは、snapd 内のタスク、変更、インターフェイス、エンドポイント、snap コマンド、および ensure ヘルパー関数など、snapd 内の重要なコードパスを記述するデータのコレクションです。
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 コマンドは、snapd が特定のシステムで使用する個々のサンドボックスコンポーネントの機能を説明するタグを表示します。
使い方:debug sandbox-features [sandbox-features-OPTIONS]
--required
指定されたバックエンド:機能が利用可能であることを確認する
debug seeding
シードおよびプリシードの詳細を取得する
シードおよびプリシードの詳細を取得します。
使い方:debug seeding [seeding-OPTIONS]
--unicode <デフォルト: "auto">
debug stacktraces
すべての snapd goroutine のスタックトレースを取得する
すべての snapd goroutine のスタックトレースを取得します。
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
「保留」状態のタスクを変更出力から省略
debug 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.yaml ファイルを含むディレクトリに配置されているスナップのシードの整合性を検証します。
disable
システム内のスナップを無効化
disable コマンドはスナップを無効化します。スナップのバイナリとサービスは利用できなくなりますが、すべてのデータは利用可能であり、スナップは簡単に再度有効にできます。
使用法:snap [OPTIONS] disable [disable-OPTIONS]
--no-wait
操作の完了を待たずに変更 ID のみを表示します。
disconnect
プラグとスロットの接続を解除
disconnect コマンドは、プラグとスロットの接続を解除します。 以下の方法で呼び出すことができます。
$ snap disconnect <snap>:<plug> <snap>:<slot>
特定のプラグを特定のソケットから切断します。
$ snap disconnect <snap>:<slot or plug>
指定されたプラグまたはスロットからすべてを切断します。スナップ名に「core」スナップを指定することもできます。
自動接続を手動で切断した場合、その切断された状態はスナップのリフレッシュ後に保持されます。disconnect コマンドに --forget フラグを追加すると、この動作がリセットされ、スナップのリフレッシュ後に自動再接続が再度有効になります。
使用法:snap [OPTIONS] disconnect [disconnect-OPTIONS]
--no-wait
操作の完了を待たずに変更 ID のみを表示します。
--forget
指定された接続に関する記憶された状態を忘却します。
download
指定されたスナップをダウンロード
download コマンドは、指定されたスナップ、コンポーネント、およびそれらのサポートアサーションを、それぞれ .snap、.comp、および .assert ファイル拡張子を持つ現在のディレクトリにダウンロードします。
使用法:snap [OPTIONS] download [download-OPTIONS]
--channel
stable の代わりにこのチャネルを使用します
--edge edge チャネルからインストール
--beta beta チャネルからインストール
--candidate candidate チャネルからインストール
--stable stable チャネルからインストール
--revision
指定されたリビジョンのスナップをダウンロードします。コンポーネントをダウンロードする場合は、指定されたスナップリビジョンに関連付けられているコンポーネントをダウンロードします。
--basename
スナップ、コンポーネント、アサーションファイルにこのベース名を使用します(デフォルトは <snap>_<revision>)。
--target-directory
このディレクトリにダウンロードします(デフォルトは現在のディレクトリ)。
--only-components
スナップではなく、指定されたコンポーネントのみをダウンロードします。
--cohort
指定されたコホートからダウンロードします。
enable
システムでスナップを有効にします。
enable コマンドは、以前に無効になっていたスナップを有効にします。
使用法: snap [OPTIONS] enable [enable-OPTIONS]
--no-wait
操作の完了を待たずに、変更 ID を出力します。
export-snapshot
スナップショットをエクスポートします。
指定されたファイル名にスナップショットをエクスポートします。
find
インストールするパッケージを検索します。
find コマンドは、利用可能なパッケージについてストアをクエリします。
--private フラグを使用すると、ユーザーがストアにログインしている必要があります(「snap help login」を参照)。この場合、直接またはストアの共同作業機能を通じて、ユーザーが開発者アクセス権を持つプライベートスナップを検索します。
パブリッシャー名の後に緑色のチェックマーク(色と Unicode のサポートがある場合)が表示されている場合、そのパブリッシャーは検証済みであることを示します。
使用法: snap [OPTIONS] find [find-OPTIONS]
エイリアス: search
--private
プライベートスナップを検索します。
--narrow
「安定版」のスナップのみを検索します。
--section [="show-all-sections-please"] <default: "no-section-specified">
検索を特定のセクションに制限します。
--color <default: "auto">
少し色を使用して、いくつかの項目を強調表示します。
--unicode <default: "auto">
少し Unicode を使用して、可読性を向上させます。
forget
スナップショットを削除します。
forget コマンドは、スナップショットを削除します。この操作は元に戻せません。
スナップショットには、含まれる各スナップのユーザー、システム、および構成データに対するアーカイブが含まれます。
デフォルトでは、このコマンドはスナップショット内のすべてのデータを削除します。あるいは、削除するスナップのデータを指定することもできます。
使用法: snap [OPTIONS] forget [forget-OPTIONS]
--no-wait
操作の完了を待たずに、変更 ID を出力します。
get
構成オプションを出力します。
get コマンドは、指定されたスナップの構成オプションを出力します。
$ 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 [OPTIONS] get [get-OPTIONS]
-t 厳密な型チェックで、null と引用符付きの文字列を使用します。
-d 単一のキーであっても、常にドキュメントを返します。
-l 単一のキーであっても、常にリストを返します。
help
コマンドに関するヘルプを表示します。
help コマンドは、スナップコマンドに関する情報を表示します。
使用法: snap [OPTIONS] help [help-OPTIONS]
--all すべてのコマンドの簡単な概要を表示します。
import-snapshot
エクスポートされたスナップショットセットをシステムにインポートします。スナップショットは、新しいスナップショット ID でインポートされ、restore コマンドを使用して復元できます。
使用法: snap [オプション] import-snapshot [import-snapshot-オプション]
--abs-time
info
スナップに関する詳細情報を表示します。
スナップは、名前またはパスで指定できます。名前は、ストアとインストール済みのスナップの両方で検索されます。パスは、.snapファイル、または「snap try」に適した展開されたスナップを含むディレクトリ(たとえば、snapcraftが生成する「prime」ディレクトリ)を参照できます。
使用法: snap [オプション] info [info-オプション]
--color <デフォルト: "auto">
少し色を使用して、いくつかの情報を強調表示します。
--unicode <デフォルト: "auto">
少しUnicodeを使用して、可読性を向上させます。
--abs-time
絶対時間(RFC 3339形式)で表示します。それ以外の場合は、相対時間を60日まで表示し、その後はYYYY-MM-DDで表示します。
--verbose
スナップに関するより多くの詳細情報(拡張されたメモ、ベースなど)を含めます。
install
システムにスナップをインストールします。
名前付きのスナップをシステムにインストールします。
同じスナップの複数のインスタンスをインストールするには、スナップ名にアンダースコアと一意の識別子(各インスタンスに対して)を付加します。
並列インスタンスは、--unaliasedを暗黙的に渡してインストールされ、既存のインストールとの競合を回避します。この動作は、--preferを渡すことで変更でき、これにより、指定されたスナップのすべてのエイリアスが優先され、他のスナップの競合するエイリアスが無効になり、手動エイリアスが削除されます。
追加のオプションがない場合、スナップは安定チャネルを追跡し、厳密なセキュリティコンテナ化でインストールされます。スナップの利用可能なすべてのチャネルは、その「snap info」出力にリストされています。
--revisionが使用される場合、その後の更新では通常、リビジョンオーバーライドが元に戻り、スナップが追跡しているチャネルの現在のリビジョンに戻ります。
スナップファイルからインストールする場合は、--nameを使用してインスタンス名を設定します。
使用法: snap [オプション] install [install-オプション]
--color <デフォルト: "auto">
少し色を使用して、いくつかの情報を強調表示します。
--unicode <デフォルト: "auto">
少しUnicodeを使用して、可読性を向上させます。
--no-wait
操作の完了を待たずに、変更IDを印刷します。
--channel
代わりにこのチャネルを使用します。
--edge
エッジチャネルからインストールします。
--beta
ベータチャネルからインストールします。
--candidate
候補チャネルからインストールします。
--stable
安定チャネルからインストールします。
--devmode
スナップを開発モードに置き、セキュリティコンテナ化を無効にします。
--jailmode
スナップを強制コンテナ化モードに置きます。
--classic
スナップをクラシックモードに置き、セキュリティコンテナ化を無効にします。
--revision
スナップの指定されたリビジョンをインストールします。
--dangerous
署名が事前に承認されていないスナップファイル(検証されず、危険な可能性がある)をインストールします。(--devmodeはこれを意味します)
--unaliased
指定されたスナップを自動エイリアスを有効にせずにインストールします。
--prefer
指定されたスナップのすべてのエイリアスを、他のスナップの競合するエイリアスよりも優先して有効にする
--name
スナップファイルを指定されたインスタンス名でインストールする
--cohort
スナップを指定されたコホートにインストールする
--ignore-validation
他のスナップによる検証を無視してインストールする
--transaction <デフォルト: "per-snap">
スナップごとに1つのトランザクションを実行するか、指定されたすべてのスナップに対して1つのトランザクションを実行するか
--quota-group
スナップをインストール時にクォータグループに追加する
interface
スナップインターフェースの詳細を表示する
interfaceコマンドは、スナップインターフェースの詳細を表示します。
インターフェース名が指定されていない場合、少なくとも1つの接続を持つインターフェース名のリストが表示されます。または、--allが指定された場合は、すべてのインターフェースのリストが表示されます。
使用法: snap [オプション] interface [インターフェースオプション]
--attrs
インターフェース属性を表示する
--all
未使用のインターフェースを含める
known
指定された型の既知のアサーションを表示する
knownコマンドは、指定された型の既知のアサーションを表示します。アサーション型に続けてヘッダー=値のペアが指定された場合、表示されるアサーションは、指定されたヘッダーが提供された値と一致するように制限されます。
使用法: snap [オプション] known [既知オプション]
--remote
ストアからアサーションを照会し、可能な場合はsnapdを介して照会する
--direct
ストアからアサーションを照会し、snapdを介して照会しない
list
インストールされているスナップを一覧表示する
listコマンドは、現在のシステムにインストールされているスナップの概要を表示します。
パブリッシャー名の後に緑色のチェックマーク(色とUnicodeのサポートがある場合)が表示されると、そのパブリッシャーが検証されていることを示します。
使用法: snap [オプション] 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 [ログオプション]
--abs-time
絶対時間(RFC 3339形式)で表示します。それ以外の場合は、最大60日間の相対時間を表示し、その後YYYY-MM-DDで表示します。
-n <デフォルト: "10">
指定された行数のみ表示するか、または'all'と入力します。
-f
新しい行を待機し、表示されると表示します。
model
このデバイスのアクティブなモデルを取得する
modelコマンドは、このデバイスのアクティブなモデルアサーション情報を返します。
デフォルトでは、出力にはモデルの識別に関する重要な情報のみが含まれますが、これは、アサーションのすべての非メタヘッダーを含めるように拡張できます。
冗長な出力は、構造化された YAML ライクな形式で表示されます。
同様に、アクティブなシリアルアサーションを使用して、モデルアサーションの代わりに、出力に使用できます。
使用法:snap [オプション] モデル [モデル-オプション]
--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 [pack-オプション]
--check-skeleton
snap-dirのメタデータのみを検証します
--filename
このファイル名で出力します
--compression
使用する圧縮(例:xzまたはlzo)
prefer
snapからのエイリアスを有効にし、競合するエイリアスを無効にします
preferコマンドは、指定されたsnapのすべてのエイリアスを有効にし、競合する他のsnapのエイリアスよりも優先します。競合するエイリアスは無効になります(または、手動エイリアスの場合、削除されます)。
使用法:snap [オプション] prefer [prefer-オプション]
--no-wait
操作の完了を待たずに、変更IDのみを印刷します。
prepare-image
デバイスイメージを準備します
prepare-image コマンドは、デバイスイメージを作成するために必要ないくつかの手順を実行します。
coreイメージの場合、これは直接呼び出されず、通常はubuntu-imageによって呼び出されます。
クラシックイメージを準備するには、--classic モードがサポートされています。
使用法:snap [オプション] prepare-image [prepare-image-オプション]
--classic
クラシックモードを有効にして、クラシックモデルイメージを準備します。
--preseed
プリシード(UC20+のみ)
--preseed-sign-key
プリシードアサーションに署名するために使用するキーの名前。指定しない場合は、デフォルトのキーを使用します。
--apparmor-features-dir
AppArmorカーネル機能ディレクトリへのオプションのパス(UC20+のみ)。
--sysfs-overlay
プリシーディングのステップを実行するときに使用するオプションのsysfsオーバーレイ。
--arch
モデルにアーキテクチャが指定されていない場合に、--classicオプションで使用するスナップのアーキテクチャを指定します。
--channel
使用するチャネル。
--snap <snap>[=<channel>]
ストアまたはローカルファイルから指定されたスナップを含め、または指定されたスナップを追跡するチャネルを指定します。
--comp <snap>+<comp>
ストアまたはローカルファイルから指定されたコンポーネントを含めます。
--revisions
提供されたスナップの正確なリビジョンを参照するseeds.manifestファイルを指定し、それらのスナップをインストールします。
--write-revisions [="./seed.manifest"]
使用されたスナップの正確なリビジョンを参照するmanifestファイルを書き込みます。manifestファイルのパスはオプションです。
--validation
検証を無視するか強制するかを制御します(デフォルト:無視)。
--allow-snapd-kernel-mismatch
snapdスナップとカーネル内のsnapdのバージョンの不一致を許可するかどうか。
--assert <filename>
ローカルファイルからアサーションを含めます。
quota
スナップのセットに対するクォータグループを表示します。
quotaコマンドは、クォータグループに関する情報(含まれるスナップとサブグループのセット、および制約されたリソースとそれらのリソースの現在の使用量)を表示します。
quotas
すべてのクォータグループを表示します。
reboot
選択したシステムとモードで再起動します。
rebootコマンドは、システムを特定のリカバリーシステムの特定のモードで再起動します。
システムラベルとモードを指定せずに呼び出した場合、通常の再起動をトリガーします。
ラベルを指定せずに呼び出した場合、現在のシステムが「run」モードで使用されます。デフォルトのリカバリーシステムは、「recover」、「factory-reset」、および「install」モードで使用されます。
「run」モードは現在のシステムでのみ使用できることに注意してください。
Usage: snap [OPTIONS] reboot [reboot-OPTIONS]
--run
runモードで起動します。
--install
installモードで起動します。
--recover
recoverモードで起動します。
--factory-reset
factory-resetモードで起動します。
recovery
利用可能なリカバリーシステムをリストします。
recoveryコマンドは、利用可能なリカバリーシステムをリストします。
--show-keysを指定すると、デバイス固有の自動アンロックが機能しない場合に、暗号化されたパーティションのロックを解除するために使用できるリカバリーキーが表示されます。
Usage: snap [OPTIONS] recovery [recovery-OPTIONS]
--color <default: "auto">
少し色を使用して、いくつかの要素を強調表示します。
--unicode <default: "auto">
少しUnicodeを使用して、読みやすさを向上させます。
--show-keys
暗号化されたパーティションのロックを解除するために使用できるリカバリーキーを表示します(利用可能な場合)。
refresh
システム内の指定されたスナップ、または指定されていない場合はすべてのスナップを更新します。
追加のオプションがない場合、スナップは追跡しているチャネルの現在のリビジョンに更新され、 confinementオプションは保持されます。スナップの利用可能なすべてのチャネルは、その「snap info」出力にリストされています。
`--revision` オプションを使用した場合、後続の更新で通常、リビジョンの上書きが取り消されます。
`--hold` オプションは、スナップが指定されていない場合はすべてのスナップの自動更新を延期するために使用され、スナップが指定されている場合は、指定されたスナップの更新を延期するために使用されます。
スナップが指定されていない場合、--hold オプションは自動更新にのみ有効であり、snap refresh または snap refresh target-snap からの一般的な更新要求や特定のスナップ要求はブロックされません。
スナップが指定されている場合、--hold オプションは、それらの自動更新と snap refresh からの一般的な更新要求の両方に有効です。ただし、snap refresh target-snap からの特定のスナップ要求はブロックされず、通常どおり実行されます。
使用法: `snap [OPTIONS] refresh [refresh-OPTIONS]`
`--color <デフォルト: "auto">`
強調表示するために、少し色を使用します。
`--unicode <デフォルト: "auto">`
可読性を向上させるために、少し Unicode を使用します。
`--abs-time`
絶対時間 (RFC 3339 形式) を表示します。それ以外の場合は、最大 60 日間の相対時間、次に YYYY-MM-DD を表示します。
`--no-wait`
操作の完了を待たずに、変更 ID のみを印刷します。
`--channel`
代わりにこのチャンネルを使用します。
`--edge` エッジチャンネルからインストールします。
`--beta` ベータチャンネルからインストールします。
`--candidate` 候補チャンネルからインストールします。
`--stable` スタブルチャンネルからインストールします。
`--devmode` スナップを開発モードにし、セキュリティ制限を無効にします。
`--jailmode` スナップを強制的な制限モードにします。
`--classic` スナップをクラシックモードにし、セキュリティ制限を無効にします。
`--amend` ストアにないスナップでの更新の試みを許可します。
`--revision` 指定されたリビジョンに更新します。
`--cohort` 指定されたコホートにスナップを更新します。
`--leave-cohort` スナップをそのコホートから削除します。
`--list` 次の更新で更新されるスナップの新しいバージョンを表示します。
`--time` 自動更新の情報を表示しますが、更新は実行しません。
`--ignore-validation` 更新をブロックする他のスナップによる検証を無視します。
`--transaction <デフォルト: "per-snap">`
指定された各スナップに対して 1 つのトランザクションを実行するか、すべてのスナップに対して 1 つのトランザクションを実行します。
`--hold [="forever"]` 指定された期間、更新を保留します (値が指定されていない場合は、永久に保留します)。
`--unhold` 更新の保留を解除します。
`remodel`
このデバイスのモデルアサーションを、新しいリビジョンまたは完全に新しいモデルに変更します。
このプロセスでは、必要な変更 (新しい必須スナップ、新しいカーネルまたはガジェットなど) をデバイスに適用します。
スナップとアサーションは、ローカルファイルとして --snap および --assertion オプションで指定された場合を除き、ストアからダウンロードされます。これらのオプションを使用する場合は、必要なすべてのスナップとアサーションがローカルで提供されていることを想定し、そうでない場合は、リモデルが失敗します。
使用法: `snap [OPTIONS] remodel [remodel-OPTIONS]`
`--no-wait`
操作の完了を待たずに、変更 ID のみを印刷します。
`--snap` ローカルで利用可能な 1 つ以上のスナップを使用します。
`--assertion` ローカルで利用可能な 1 つ以上のアサーションファイルを使用します。
--offline
インストール済みのローカルで提供されるスナップとアサーションのみを使用します。ローカルにスナップまたはアサーションを提供することは、--offline オプションを指定することと同等です。
remove
システムからスナップを削除します。
remove コマンドは、指定されたスナップインスタンスをシステムから削除します。
デフォルトでは、すべてのスナップリビジョンとそのデータ、および共通データディレクトリが削除されます。--revision オプションが指定された場合、指定されたリビジョンのみが削除されます。
自動スナップショットが無効になっていない限り、スナップのすべてのデータのスナップショットが削除時に保存され、後で snap restore を使用して復元できます。--purge オプションは、自動的にスナップショットを作成することを無効にします。
使用法: snap [OPTIONS] remove [remove-OPTIONS]
--no-wait
操作の完了を待たずに、変更 ID のみを表示します。
--revision
指定されたリビジョンのみを削除します。
--purge
スナップのデータを保存せずにスナップを削除します。
--terminate
削除前にスナップに関連付けられた実行中のプロセスを終了します。
remove-quota
クォータグループを削除します。
remove-quota コマンドは、指定されたクォータグループを削除します。
現在、サブグループのないクォータグループのみを削除できます。サブグループを持つクォータグループを削除するには、まずサブグループをすべて削除してから、グループ自体を削除する必要があります。
使用法: snap [OPTIONS] remove-quota [remove-quota-OPTIONS]
--no-wait
restart
サービスを再起動します。
restart コマンドは、指定されたサービスを再起動します。
--reload オプションが指定された場合、アプリに reload コマンドがある各サービスに対して、再起動の代わりに reload が実行されます。
使用法: snap [OPTIONS] restart [restart-OPTIONS]
--no-wait
操作の完了を待たずに、変更 ID のみを表示します。
--system
操作はシステムサービスにのみ影響するようにします。
--user
操作は現在のユーザーのユーザーサービスにのみ影響するようにします。
--users
'all' に設定されている場合、操作はすべてのユーザーのサービスに影響するようにします。
--reload
サービスに reload コマンドがある場合は、再起動の代わりにそれを使用します。
restore
スナップショットを復元します。
restore コマンドは、スナップに含まれるユーザーデータ、システムデータ、および構成データを、指定されたスナップショットの対応するデータに置き換えます。
デフォルトでは、このコマンドはスナップショット内のすべてのデータを復元します。あるいは、復元するスナップのデータ、または復元するユーザーを指定したり、これらを組み合わせたりすることもできます。
スナップが復元操作に含まれている場合、そのシステムデータと構成データを復元から除外することは現在できません。この制限は将来解除される可能性があります。
使用法: snap [OPTIONS] restore [restore-OPTIONS]
--no-wait
操作の完了を待たずに、変更 ID のみを表示します。
--users
特定のユーザーのデータのみを復元します (カンマ区切り) (デフォルト: すべてのユーザー)。
revert
指定されたスナップを前の状態に戻します。
revert コマンドは、指定されたスナップを最新の更新前の状態に戻します。これにより、前のスナップリビジョンが再アクティブ化され、そのリビジョンに関連付けられていた元のデータが使用され、最新のリビジョンで行われたデータ変更は破棄されます。ただし、スナップが明示的にリビジョン間で共有するデータは、revert プロセスによって変更されません。
使用方法: snap [オプション] revert [revert-オプション]
--no-wait
操作の完了を待たずに、変更IDのみを出力します。
--devmode
snapを開発モードにし、セキュリティコンテインメントを無効にします。
--jailmode
snapを強制コンテインメントモードにします。
--classic
snapをクラシックモードにし、セキュリティコンテインメントを無効にします。
--revision
指定されたリビジョンにリバートします。
run
指定されたsnapコマンドを実行します。
使用方法: snap [オプション] run [run-オプション] <SNAPの名前>.<APPの名前> [<SNAP-APP-引数>...]
--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のシステムデータと構成データをスナップショットから除外することは、現在はできません。この制限は将来取り除かれる可能性があります。
使用方法: snap [オプション] save [save-オプション]
--no-wait
操作の完了を待たずに、変更IDのみを出力します。
--abs-time
絶対時間(RFC 3339形式)を表示します。それ以外の場合は、短い相対時間を表示します。
--users
特定のユーザーのデータのみをスナップショットします(カンマ区切り)(デフォルト:すべてのユーザー)。
saved
現在保存されているスナップショットを一覧表示します。
savedコマンドは、以前に「save」コマンドで作成されたスナップショットのリストを表示します。
使用方法: snap [オプション] saved [saved-オプション]
--abs-time
絶対時間(RFC 3339形式)を表示します。それ以外の場合は、短い相対時間を表示します。
--id
特定のスナップショットのみを表示します。
services
サービスの状態を照会します。
servicesコマンドは、指定されたサービス、または現在インストールされているすべてのsnapのサービスに関する情報を一覧表示します。
rootユーザーとして実行された場合、ユーザーサービスの「Startup」列は、グローバルに有効になっているかどうか(つまり、`systemctl is-enabled`)を示します。rootユーザー自体のユーザーサービスの実際の「Startup」|「Current」状態を表示するには、`--user`を指定できます。
非rootユーザーとして実行した場合、「Startup」|「Current」ステータスは、呼び出しユーザーの現在のサービスステータスになります。ユーザーサービスのグローバルな有効化ステータスを表示するには、--globalを指定します。
使用法:snap [OPTIONS] services [services-OPTIONS]
-g、--global
現在のユーザーのステータスではなく、ユーザーサービスのグローバルな有効化ステータスを表示します。
-u、--user
グローバルな有効化ステータスではなく、ユーザーサービスの現在のステータスを表示します。
set
構成オプションを変更します
$ snap set snap-name username=frank password=$PASSWORD
すべての構成変更は、まとめて永続化され、snapの構成フックが正常に返された後にのみ適用されます。
ドット区切りのパスを使用して、ネストされた値を変更できます。
$ snap set snap-name author.name=frank
構成オプションは、感嘆符を使用して解除できます。
$ snap set snap-name author!
使用法:snap [OPTIONS] set [set-OPTIONS]
--no-wait
操作の完了を待たずに、変更IDのみを出力します。
-t
値をJSONドキュメントとして厳密に解析します。
-s
値を文字列として解析します。
set-quota
クォータグループを作成または更新します。
set-quotaコマンドは、指定されたsnapのセットを含むクォータグループを更新または作成します。
クォータグループは、snapまたはsnapサービスセットのリソース制限を設定します。snapは最大1つのクォータグループに属することができますが、クォータグループはネストすることができます。ネストされたクォータグループは、既存の各クォータの合計が、ネストされたグループが属する親グループのクォータを超えないという制限を受けます。
提供されたすべてのsnapはグループに追加されます。snapをクォータグループから削除するには、remove-quotaコマンドでグループ全体を削除し、再作成する必要があります。サブグループをクォータグループから削除するには、remove-quotaコマンドで直接サブグループを削除する必要があります。
個々のサービスに制限を設定するには、1つまたは複数のサービスをサブグループに配置できます。各サービスの対応するsnapは、サブグループの親グループに属する必要があります。これらのサブグループは、ネストされたグループと同じ制限を受けます。つまり、それらの結合されたリソース使用量は、親グループに設定されたリソース制限を超えることはできません。サービスを含むサブグループは、独自のジャーナルクォータを設定することはできず、代わりに親クォータグループが持つ可能性のあるジャーナルクォータを自動的に継承します。
クォータグループのメモリ制限は増やすことはできますが、減らすことはできません。クォータグループのメモリ制限を減らすには、remove-quotaコマンドでグループ全体を削除し、より低い制限で再作成する必要があります。クォータグループのメモリ制限を増やすと、クォータグループ内のsnapに関連付けられたサービスは再起動されません。
クォータグループのCPU制限は、設定後に増減することができます。CPU制限は、単一のパーセンテージとして指定することができます。これは、クォータグループにCPUリソースの全体的なパーセンテージが許可されることを意味します。50%に設定すると、クォータグループはすべてのCPUコアの最大50%を使用できます。パーセンテージを2100%に設定すると、クォータグループは2つのCPUコアで最大100%まで使用できます。
クォータグループの CPU セット制限は、新しい CPU を追加したり、すでに設定されているクォータから既存の CPU を削除したりすることで変更できます。
クォータグループのスレッド制限は増やすことはできますが、減らすことはできません。クォータグループのスレッド制限を減らすには、remove-quota コマンドでグループ全体を削除し、より低い制限で再作成する必要があります。
ジャーナル制限は、設定後に増減できます。グループにジャーナル制限を設定すると、そのグループ内のスナップが同じジャーナルネームスペースに配置され、log コマンドの動作に影響します。
既存のクォータグループに新しいクォータを設定できますが、既存のクォータをクォータグループから削除することはできません。削除するには、グループ全体を削除して再作成する必要があります。
クォータグループに新しいスナップを追加すると、そのスナップ内の無効化されていないすべてのサービスが再起動されます。
既存のサブグループを別の親グループに移動することはできません。
使用法:`snap [OPTIONS] set-quota [set-quota-OPTIONS]`
`--no-wait`
処理の完了を待たずに、変更 ID を出力します。
`--memory [=]`
メモリクォータ
`--cpu [=]`
CPU クォータ
`--cpu-set [=]`
CPU セットクォータ
`--threads [=]`
スレッドクォータ
`--journal-size [=]`
ジャーナルサイズクォータ
`--journal-rate-limit [=]`
ジャーナルレート制限(<メッセージ数>/<メッセージ期間>)
`--parent [=]`
親クォータグループ
`start`
サービスを開始します
^ tart コマンドは、指定されたサービスを開始し、必要に応じて有効にします。
使用法:`snap [OPTIONS] start [start-OPTIONS]`
`--no-wait`
処理の完了を待たずに、変更 ID を出力します。
`--system`
この操作は、システムサービスにのみ影響します。
`--user`
この操作は、現在のユーザーのユーザーサービスにのみ影響します。
`--users`
指定されていて all に設定されている場合、この操作はすべてのユーザーのサービスに影響します。
`--enable`
今、サービスを開始するだけでなく、起動時にサービスが開始されるように設定します。
`stop`
サービスを停止します
^ top コマンドは、指定されたサービスを停止し、必要に応じて無効にします。
使用法:`snap [OPTIONS] stop [stop-OPTIONS]`
`--no-wait`
処理の完了を待たずに、変更 ID を出力します。
`--system`
この操作は、システムサービスにのみ影響します。
`--user`
この操作は、現在のユーザーのユーザーサービスにのみ影響します。
`--users`
指定されていて all に設定されている場合、この操作はすべてのユーザーのサービスに影響します。
`--disable`
今、サービスを停止するだけでなく、起動時にサービスが開始されないように設定します。
`switch`
スナップを別のチャンネルに切り替えます
^ witch コマンドは、スナップを別のチャンネルに切り替えます。リフレッシュは行いません。スナップの利用可能なすべてのチャンネルは、snap info の出力にリストされています。
使用法:`snap [OPTIONS] switch [switch-OPTIONS]`
--no-wait
操作の完了を待たずに、変更IDを出力します。
--channel
代わりにこのチャンネルを使用します。
--edge
エッジチャンネルからインストールします。
--beta
ベータチャンネルからインストールします。
--candidate
候補チャンネルからインストールします。
--stable
安定チャンネルからインストールします。
--cohort
スナップを特定のコホートに切り替えます。
--leave-cohort
スナップを現在のコホートから切り替えます。
tasks
変更に関連付けられたタスクをリストします。
^ asks コマンドは、個々の変更に関連付けられたタスクの概要を表示します。
使用法: snap [オプション] tasks [tasks-オプション]
エイリアス: change
--abs-time
絶対時間(RFC 3339形式)を表示します。そうでない場合は、最大60日までの相対時間、その後はYYYY-MM-DDで表示します。
--last
指定されたタイプの最後の変更(インストール、更新、削除、試行、自動更新など)を選択します。タイプ名の末尾に疑問符が付いている場合、指定されたタイプの変更が見つからない場合にエラーを返すのではなく、何も行いません。ただし、疑問符はシェルから保護する必要がある場合があります。
try
システム内の展開されたスナップをテストします。
^ ry コマンドは、テスト目的でスナップを展開してシステムにインストールします。展開されたスナップの内容はインストール後も使用され続けるため、それに対する非メタデータ変更は即座に反映されます。メタデータ変更(snap.yamlで実行される変更など)を反映するには、再インストールが必要です。
^ nap-dir 引数が省略された場合、try コマンドは、現在の作業ディレクトリを基準として、snapcraft.yaml ファイルとプライムディレクトリ、または meta/snap.yaml ファイルのいずれかを見つけられる場合に、それを推測しようとします。
使用法: snap [オプション] try [try-オプション]
--no-wait
操作の完了を待たずに、変更IDを出力します。
--devmode
スナップを開発モードにし、セキュリティ制限を無効にします。
--jailmode
スナップを強制的な制限モードにします。
--classic
スナップをクラシックモードにし、セキュリティ制限を無効にします。
unalias
手動で作成したエイリアス、またはスナップ全体のエイリアスを削除します。
^ nalias コマンドは、提供された引数が手動エイリアスである場合、単一のエイリアスを削除します。または、引数がスナップ名である場合、手動エイリアスを含むスナップのすべてのエイリアスを無効にします。
使用法: snap [オプション] unalias [unalias-オプション]
--no-wait
操作の完了を待たずに、変更IDを出力します。
unset
構成オプションを削除します。
^ nset コマンドは、要求された構成オプションを削除します。
$ snap unset snap-name name address
すべての構成変更は一度に保存され、スナップの構成フックが正常に終了した後にのみ適用されます。
ドット区切りのパスを使用して、ネストされた値を削除できます。
$ snap unset snap-name user.name
使用法: snap [オプション] unset [unset-オプション]
--no-wait
操作の完了を待たずに、変更IDを出力します。
validate
検証セットをリストまたは適用します。
^ alidate コマンドは、どのスナップを一緒にインストールする必要があるか、または許可するかを定義する検証セットをリストまたは適用します。オプションで、特定のバージョンに制限することもできます。
検証セットは、監視モードで動作するように設定することもできます。この場合、その制約は強制されません。または、強制モードで動作するように設定することもできます。この場合、snapdは、検証セットの制約に違反する可能性のある操作を許可しません。
使用法: snap [オプション] validate [validate-オプション]
--monitor
指定された検証セットを監視する
--enforce
指定された検証セットを適用する
--forget
指定された検証セットを忘却する
--refresh
適用されている検証セットを満たすように、スナップを更新またはインストールする
--color <デフォルト: "auto">
少し色を使って、いくつかの部分を強調表示する
--unicode <デフォルト: "auto">
少しUnicodeを使って、可読性を向上させる
--no-wait
操作の完了を待たずに、変更IDを出力する
version
バージョン詳細を表示する
versionコマンドは、実行中のクライアント、サーバー、およびオペレーティングシステムのバージョンを表示します。
wait
構成の完了を待つ
waitコマンドは、構成がtrueになるまで待ちます。
warnings
警告を一覧表示する
warningsコマンドは、システムに報告された警告を一覧表示します。
'snap warnings'で警告を一覧表示した後、「snap okay」を使用して、警告を抑制できます。
このように抑制された警告は、再度発生し、さらにクールダウン時間が経過するまで、再度一覧表示されません。
警告は自動的に期限切れになり、期限切れになると忘却されます。
使用法: snap [オプション] warnings [warnings-オプション]
--abs-time
絶対時間(RFC 3339形式)を表示します。それ以外の場合は、相対時間を60日まで表示し、その後はYYYY-MM-DDを表示します。
--unicode <デフォルト: "auto">
少しUnicodeを使って、可読性を向上させる
--all
すべての警告を表示する
--verbose
より多くの情報を表示する
watch
進行中の変更を監視する
watchコマンドは、指定された変更IDの完了を待ち、進行状況(利用可能な場合)を表示します。
使用法: snap [オプション] watch [watch-オプション]
--last
指定されたタイプの最後の変更(インストール、更新、削除、試行、自動更新など)を選択します。
タイプの末尾に疑問符が付いている場合、指定されたタイプの変更が見つからない場合にエラーを返す代わりに、何も行いません。
疑問符はシェルから保護する必要がある場合があります。
whoami
ユーザーがログインしているメールアドレスを表示する
whoamiコマンドは、ユーザーがログインしているメールアドレスを表示します。
注意事項
オンラインドキュメント
https://docs.snapcraft.io
バグ
すべてのバグは、https://bugs.launchpad.net/snapd/+filebug で報告してください。