Centro de pacotes e contentores

6 min · 10 secções

O NAS executa aplicações — um servidor de filmes com capas, uma nuvem privada, o bloqueador de anúncios da casa toda — cada uma fechada no seu contentor, sem mexer no sistema. O Centro de pacotes instala-as e atualiza-as com um clique; a app Contentores mostra a maquinaria que está por baixo, para quando é preciso espreitar.

É preciso um volume criado: as aplicações e os seus dados vivem no volume (<pool>/apps/<aplicação>/), nunca no disco do sistema — uma app que engorda não pode deixar o NAS sem espaço para se atualizar.

Instalar

Escolhe a app no catálogo — por categorias ou a pesquisar — e «Instalar». A transferência e o arranque correm como tarefa com progresso; no fim, as apps com interface web têm o botão «Abrir», que te leva diretamente ao seu ecrã. Cada aplicação guarda o que é seu na sua pasta de dados dentro do volume: reinstalá-la ou atualizá-la não mexe no que está guardado.

«Atualizar» transfere a versão nova da imagem e recria o contentor com as mesmas definições. Os dados nem são tocados: estão na sua pasta, fora do contentor.

O catálogo

O catálogo traz 1058 aplicações, todas de outros programadores, selecionadas por nós e testadas uma a uma: cada receita é instalada a sério, a sua página web é aberta e é removida antes de entrar. Têm a sua categoria, o seu ícone e uma versão fixa: uma aplicação não muda de versão sozinha, e «Atualizar» põe-na em dia quando tu pedires. As receitas apontam os seus dados para a pasta de dados do NAS, por isso a regra de «tudo no volume» cumpre-se em todas.

Portas e pastas

Cada app instalada tem o seu botão «Portas e pastas»:

• Portas: que porta do NAS leva a que porta dentro do contentor. Se a que a receita propõe choca com algo teu, muda-se aqui e a app é recriada com a nova.
• Pastas: que pastas do NAS a app vê por dentro. É a forma de dar a um servidor de filmes a tua pasta de Filmes, ou de uma app de cópias ver o que tem de copiar.

Para o que o ecrã não cobre existe a edição avançada: a receita completa (docker compose) e as suas variáveis, editáveis tal como estão. Com rede de segurança: ao aplicar, os contentores são recriados com a receita nova e, se não arrancarem, a configuração anterior é reposta sozinha — um erro de sintaxe não te deixa a app morta.

Aceleração de vídeo

Se o NAS tem gráfica integrada (Intel ou AMD), o Jellyfin e o Plex podem usá-la para converter vídeo sem sobrecarregar o processador: é a diferença entre ver um filme e ver uma roda a girar. Ao instalá-los aparece o interruptor «Aceleração de vídeo», e para uma app já instalada está em «Portas e pastas». É a única coisa do dispositivo que uma aplicação pode receber: a gráfica; nem discos nem outros dispositivos.

Uma placa Nvidia

Se o NAS tem uma placa Nvidia, o mesmo interruptor serve para ela assim que se cumpram três coisas: que o controlador esteja carregado (existe /dev/nvidia0, que aparece depois de o instalar e reiniciar, ou ao executar nvidia-smi uma vez), que esteja instalado o runtime de contentores da Nvidia, e que esse runtime esteja registado no Docker. É coisa de uma vez, a partir da consola do NAS:

sudo apt install nvidia-driver nvidia-container-toolkit
sudo nvidia-ctk runtime configure --runtime=docker
sudo systemctl restart docker

O pacote nvidia-driver está na secção non-free do Debian e o nvidia-container-toolkit no repositório da Nvidia. Enquanto não estiverem, a opção não aparece: o painel só a oferece quando sabe que vai funcionar.

Dispositivos USB

O Home Assistant com um Zigbee ou um Z-Wave por USB precisa de ver o adaptador. Ao instalá-lo, e em «Portas e pastas», aparecem os adaptadores de porta série ligados ao NAS com o seu nome; marca o que quiseres e a aplicação encontra-o em /dev/serial/by-id/…, um nome que não muda ao voltar a ligá-lo. Só portas série: um disco USB ou outro dispositivo continuam fora do alcance das aplicações.

Limites de memória e CPU

Em «Portas e pastas» de cada aplicação instalada podes fixar quanta memória e quanto CPU pode usar no máximo. Sem limite, uma aplicação que se descontrola (um indexador de fotos, uma base de dados mal afinada) come a memória do NAS e arrasta o painel e as outras. Os escalões oferecidos são os que cabem no teu dispositivo; «Sem limite» retira-os. A alteração reinicia a aplicação.

Desinstalar

«Desinstalar» para a app e retira-a da lista, e di-lo claramente: os dados são conservados no disco. Reinstalá-la amanhã devolve-a com tudo o que era seu. Se o que queres é recuperar o espaço, a opção de eliminar também os dados fá-lo a sério —e se alguma coisa não pudesse ser eliminada, conta-o com nome e motivo, não finge que ficou limpo—.

Contentores, registos e consola

A app Contentores mostra o que corre de verdade: cada contentor com o seu estado, a sua memória e o seu processador.

• Registos: a saída do contentor, com pesquisa — é o primeiro sítio onde olhar quando uma app não arranca ou se porta de forma estranha.
• Consola: um terminal dentro do contentor, para a espreitadela que nenhum painel consegue dar.
• Parar, arrancar e reiniciar contentores avulsos. Cuidado ao eliminar o contentor de uma aplicação do Centro de pacotes: não a desinstala —volta a ser criado ao atualizá-la—, só a deixa parada. Para a remover a sério, «Desinstalar» no Centro de pacotes.

Limpeza

O Docker deixa para trás imagens antigas a cada atualização, e ocupam gigas que ninguém usa. O botão de limpeza recupera-os: elimina o que já nenhum contentor referencia — imagens órfãs, camadas soltas— e diz quanto libertou. As apps e os seus dados nem são tocados.

Como se encaixa no resto

• Os dados das apps são pastas normais do volume: entram nas cópias de segurança e nos instantâneos como tudo o resto.
• Se o volume for destruído ou mudar de sítio, o painel volta a colocar o Docker e diz-te que apps é preciso reinstalar: está explicado em Discos, reservas e replicações.
• Para publicar receitas próprias no catálogo existe o guia de administração.