Instalando e atualizando Railbase em Linux com apt ou dnf

Em Linux, Railbase é um pacote. Você pode baixar um .deb ou .rpm da sua conta e instalá-lo manualmente, mas em um servidor você geralmente deseja o oposto: Railbase deve ser atualizado junto com o resto da máquina, sob a mesma política e a mesma janela de manutenção de qualquer outro pacote que você executa.

É para isso que serve o repositório de pacotes Railbase.

O que é isso

Um repositório apt e dnf assinado, publicado em railbase.app, contendo os mesmos pacotes que sua conta pode baixar do site. Vale a pena saber duas coisas sobre isso antes de configurá-lo.

Está assinado. Os metadados do repositório são assinados com a chave de empacotamento Railbase. Sua máquina é instruída a confiar nessa chave uma vez e, a partir de então, apt ou dnf recusa qualquer coisa que não tenha sido assinada por ela - que é o que torna um apt upgrade automatizado seguro para ser executado sem supervisão.

Está licenciado. Ao contrário de um espelho de distribuição, este repositório não é público. Cada solicitação carrega uma credencial vinculada à sua conta, e o direito é verificado em cada solicitação, e não uma vez na configuração. Se a conta expirar, as atualizações serão interrompidas; eles não continuam fluindo silenciosamente.

Obtendo uma credencial

Faça login em sua conta, abra a seção Deployments e crie uma credencial de repositório Linux. Você verá os comandos exatos a serem executados, com a credencial já preenchida — copie-os para a máquina e execute-os lá.

A credencial é mostrada uma vez. Se você perder, crie outro; se uma máquina for desativada ou você suspeitar que uma credencial vazou, revogue-a na mesma página. A revogação entra em vigor na próxima solicitação e outras máquinas não são afetadas.

Dê um rótulo a cada credencial ("servidores de produção", "teste") para que a lista em sua conta permaneça legível daqui a um ano.

Debian e Ubuntu

A configuração adiciona dois arquivos: a chave confiável e uma entrada da lista de fontes apontando para o repositório. Depois disso:

sudo apt update
sudo apt install railbase

e a partir daí sudo apt upgrade atualiza Railbase com todo o resto. Como a chave está fixada com signed-by, essa confiança se aplica apenas ao repositório Railbase — ela não dá autoridade à chave Railbase sobre qualquer outro pacote em seu sistema.

RHEL, Fedora e Rocky

A configuração do dnf grava um único arquivo .repo. Ambos gpgcheck e repo_gpgcheck estão habilitados: os pacotes e os metadados do repositório são verificados em relação à chave Railbase.

sudo dnf install railbase

Depois de instalar

O pacote instala Railbase como um serviço systemd com seus dados em /var/lib/railbase. As atualizações substituem o programa e deixam os dados em paz – seu arquivo .vault, arquivos carregados e configuração sobrevivem a uma atualização, como deveriam.

Para verificar o que você está executando:

railbase --version
systemctl status railbase

Atualizações autônomas

Se você usa unattended-upgrades (Debian/Ubuntu) ou dnf-automatic, Railbase pode ser incluído como qualquer outra origem. Se você deveria é um julgamento sobre o seu ambiente: as atualizações automáticas mantêm o fluxo das correções de segurança sem que ninguém se lembre de agir, enquanto uma atualização manual programada lhe dá um momento para ler primeiro as notas de versão. Railbase suporta ambos; isso não decide por você.

Se algo der errado

apt update relata um erro de credencial. A credencial foi revogada ou o direito da conta expirou. Verifique a seção Implantações da sua conta; uma nova credencial corrige o primeiro caso, e o segundo precisa da licença resolvida.

NO_PUBKEY ou um erro de assinatura. A chave confiável não foi instalada ou foi instalada em algum lugar onde o apt não a está lendo. Execute novamente a etapa principal na página da sua conta.

Uma versão que você esperava está faltando. O repositório publica o que sua conta tem direito. Se uma versão foi lançada e sua máquina não consegue vê-la, verifique primeiro a conta – o repositório deliberadamente não é mais permissivo do que a página de download.