Como atualizar a versão do Vyos

A atualização do Vyos pode ser necessária para corrigir bugs, melhorar a segurança, adicionar novas funcionalidades e deixar o sistema sempre o mais compatível que puder.

O processo de atualização não envolve grandes mistérios e é relativamente simples e rápido. Lembre-se de realizar um backup antes de qualquer modificação e não realize em horário de produção.

0 – Enviar a imagem .ISO para um diretório do Vyos

Utilize uma ferramenta para envio SFTP do arquivo de imagem .ISO para o diretório /temp ou /home/usuario. É importante lembrar que o espaço definido na instalação pode fazer diferença nesse primeiro passo.

O diretório onde a imagem vai ser enviada também precisa ter permissão de escrita. No meu caso estarei enviando para o /home/erick usando o FileZilla, mas outros programas de Client FTP podem ser usados.

1 – Antes de atualizar o sistema, vamos ver qual a versão que atualmente está rodando.

Os comandos show system image e show version exemplificam a saída abaixo com as informações que queremos descobrir.

vyos@vyos:~$ show system image 
Name                      Default boot    Running
------------------------  --------------  ---------
1.5-rolling-202408160021  Yes             Yes
vyos@vyos:~$ show version
Version:          VyOS 1.5-rolling-202408160021
Release train:    current
Release flavor:   generic

Built by:         autobuild@vyos.net
Built on:         Fri 16 Aug 2024 02:56 UTC
Build UUID:       34a46723-11f1-4301-a595-41a253d16e48
Build commit ID:  c75174bb4a2230

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

Hardware vendor:  QEMU
Hardware model:   Standard PC (i440FX + PIIX, 1996)
Hardware S/N:     
Hardware UUID:    d5ea04d2-e388-4854-a557-b2d362d4bbc6

Copyright:        VyOS maintainers and contributors

2 – Configure a nova ISO como default

Para isso é preciso adicionar o diretório e o nome do arquivo no comando. Não é necessário estar no modo configure.

$ add system imagem /home/erick/vyos-1.5-rolling-202410060007-generic-amd64.iso

Depois desse comando ele irá te fazer algumas perguntas, a primeira é se você quer manter o nome da vesão do Vyos ou por uma personalizada, depois é só selecionar as opções Y de Yes.

vyos@vyos:~$ add system image /home/erick/vyos-1.5-rolling-202410060007-generic-amd64.iso
Validating image compatibility
Validating image checksums
What would you like to name this image? (Default: 1.5-rolling-202410060007) 
Would you like to set the new image as the default one for boot? [Y/n] y
An active configuration was found. Would you like to copy it to the new image? [Y/n] y
Copying configuration directory
Would you like to copy SSH host keys? [Y/n] y
Copying SSH host keys
Copying system image files
Cleaning up
Unmounting target filesystems
Removing temporary files
vyos@vyos:~$

3 – Por último, reinicie o sistema.

$ reboot

4 – Confirme se o Vyos foi atualizado corretamente

É possível confirmar com o comando abaixo onde ele irá listar todas as imagens instaladas, e a que está com (default boot) é a nova usada a partir da reinicialização anterior do sistema.

erick@vyos:~$ show system image
Name                      Default boot    Running
------------------------  --------------  ---------
1.5-rolling-202410060007  Yes             Yes
1.5-rolling-202408160021
erick@vyos:~$

Você também pode confirmar a versão através do segundo comando.

erick@vyos:~$ show version
Version:          VyOS 1.5-rolling-202410060007
Release train:    current
Release flavor:   generic

Built by:         autobuild@vyos.net
Built on:         Sun 06 Oct 2024 00:07 UTC
Build UUID:       39b27102-39cf-4d4c-9c43-f022ae568da1
Build commit ID:  66f12f1d262231

Architecture:     x86_64
Boot via:         installed image
System type:      KVM guest
Secure Boot:      n/a (BIOS)

Hardware vendor:  QEMU
Hardware model:   Standard PC (i440FX + PIIX, 1996)
Hardware S/N:     
Hardware UUID:    d5ea04d2-e388-4854-a557-b2d362d4bbc6

Copyright:        VyOS maintainers and contributors
erick@vyos:~$

Informação Extra:

Se não estiver satisfeito com a atualização e queira voltar (fazer rollback) para a versão anterior, execute o comando abaixo. Para poder visualizar todas as imagens digite o comando e logo após o default-boot pressione TAB para imprimir todas as imagens disponíveis.

$ set system image default-boot

erick@vyos:~$ set system image default-boot 
Possible completions:
  <Enter>               Execute the current command
  1.5-rolling-202408160021
                        Set default image to boot.
  1.5-rolling-202410060007

Depois de escolher a imagem para rollback, insira o nome dela após o default-boot, pressione enter e reinicie o Vyos.

erick@vyos:~$ set system image default-boot 1.5-rolling-202408160021

Para críticas, dúvidas e sugestões, envie um e-mail para erick{“arrob4”}erickandrade.com.br.