VyOSオペレーションメモ

目次

VyOS の基本

VyOSヴィオーエス の基本操作について、日常行う操作を中心にメモしておく。

CLI には モードが2種類

プロンプト モード 作業
$ Operational Mode Linux OS操作や設定表示
# Configration Mode 設定変更・適用・保存

モードの切り換え

変更 コマンド 状態
Operational → Configuration configure プロンプトが # に変わる
Configration → Operational exit プロンプトが $ に変わる

オペレーショナルモード 主なコマンド

コマンド 動作 備考
show configuration 設定表示 ツリー状表示
show configuration commands 設定表示 コマンド形式表示
show version バージョン表示 VyOS / ハードウェア等
show XXX その他状態表示 show [TAB] でサブコマンド一覧
reboot 再起動
configure コンフィグレーションモードへ プロンプトが # に変わる

コンフィグレーション コマンド基本

コマンド 動作 備考
set XXX 設定変更 変更はペンディングされる
delete XXX 特定の設定を削除 変更はペンディングされる
show XXXX 設定表示 ペンディング中の設定を含め表示
commit 変更を適用 ペンディングされた設定をすべて適用
save 保存 スタートアップ設定に保存
run XXXXX オペレーショナル用コマンド XXXX を実行 exitせずに実行できる
例) run show configuration commands
rollback N N個前の commit まで巻き戻す N=0~
run show system commit で N を一覧確認できる
exit オペレーショナルモードへ抜ける プロンプトが $ に変わる

VyOS アップグレード

Rolling Release 版のアップグレード手順: オペレーションモードで実行

アップデート前の確認

現在の VyOS バージョンの確認

show version

Version:          VyOS 1.4-rolling-202302080317
Release train:    current

Built by:         [email protected]
Built on:         Wed 08 Feb 2023 03:17 UTC
Build UUID:       ce4d9361-2f83-44a1-88f4-488f1aa20f02
Build commit ID:  8cade9112a16ed

Architecture:     x86_64
Boot via:         installed image
System type:      VMware guest

Hardware vendor:  VMware, Inc.
Hardware model:   VMware Virtual Platform
Hardware S/N:     VMware-42 04 e6 47 10 ac 81 be-db c7 bc e8 e2 87 ba 2b
Hardware UUID:    47e60442-ac10-be81-dbc7-bce8e287ba2b

Copyright:        VyOS maintainers and contributors

現在の VyOS イメージバージョンを確認

show system image

The system currently has the following image(s) installed:

   1: 1.4-rolling-202302080317 (default boot) (running image)

最新版がリリースされているか、VyOS nightly builds のページで確認する。最新版 ISO ファイルの URL リンクをコピーして、下記の通りコマンドに貼り付ける。

途中で聞かれるのですべて [Enter]

add system image https://github.com/vyos/vyos-rolling-nightly-builds/releases/download/1.X-rolling-YYYYMMDDnnnn/vyos-1.X-rolling-YYYYMMDDnnnn-amd64.iso
Trying to fetch ISO file from https://github.com/vyos/vyos-rolling-nightly-builds/releases/download/1.X-rolling-YYYYMMDDnnnn/vyos-1.X-rolling-YYYYMMDDnnnn-amd64.iso...
Downloading...
The file is 434.000 MiB.
[############################################################################################################] 100%
Download complete.
Done.
Checking for digital signature file...
Downloading...
(中略)
Do you want to continue without signature check? (yes/no) [yes]
Checking SHA256 checksums of files on the ISO image... OK.
Done!
What would you like to name this image? [1.X-rolling-YYYYMMDDnnnn]:
OK.  This image will be named: 1.X-rolling-YYYYMMDDnnnn
Installing "1.X-rolling-YYYYMMDDnnnn" image.
Copying new release files...
Would you like to save the current configuration
directory and config file? (Yes/No) [Yes]:
Copying current configuration...
Would you like to save the SSH host keys from your
current configuration? (Yes/No) [Yes]:
Copying SSH keys...
Running post-install script...
Setting up grub configuration...
Done.

ダウンロードしたimage が準備されているか確認

show system image

The system currently has the following image(s) installed:

  1: 1.4-rolling-202302110748 (default boot)
  2: 1.4-rolling-202302080317 (running image)

再起動

$ reboot
Are you sure you want to reboot this system? [y/N] y

再起動完了後再度 ssh でコンソールに接続する。

起動後の VyOSバージョン、イメージの状態を確認

vyos@gd4rt01:~$ show version
Version:          VyOS 1.4-rolling-202302110748
Release train:    current

Built by:         [email protected]
Built on:         Sat 11 Feb 2023 07:48 UTC
Build UUID:       f3c3ece9-fd81-44a7-835e-ddf75a0c11f9
Build commit ID:  6d90ea4912b158

Architecture:     x86_64
Boot via:         installed image
System type:      VMware guest

Hardware vendor:  VMware, Inc.
Hardware model:   VMware Virtual Platform
Hardware S/N:     VMware-42 04 e6 47 10 ac 81 be-db c7 bc e8 e2 87 ba 2b
Hardware UUID:    47e60442-ac10-be81-dbc7-bce8e287ba2b

Copyright:        VyOS maintainers and contributors

アップデート後の確認

IPsec 接続が定義されている場合は、アップデート後に IPsec 接続が復旧しているか確認する

show vpn ipsec sa 

旧バージョンの削除

動作確認ができたら、古いイメージを削除する。show system image コマンドで表示された、使用していない方の image 名を指定する。

vyos@gd4rt01:~$ delete system image 1.4-rolling-202302080317
Are you sure you want to delete the
"1.4-rolling-202302080317" image? (Yes/No) [No]: Yes
Deleting the "1.4-rolling-202302080317" image...
Done

削除後にイメージ一覧でも削除完了していることを確認する。

vyos@gd4rt01:~$ show system image
The system currently has the following image(s) installed:

   1: 1.4-rolling-202302110748 (default boot) (running image)

参考

公式ドキュメント