Instalação¶
A Agora é instalada a partir dos pacotes do repositório da Flussonic. São dois, e escolher entre eles é escolher o papel da máquina.
agora— o equipamento inteiro: o plano de controle, o painel e um streamer em uma única máquina. É instalado primeiro, e em uma instalação pequena é o único.agora-base— um servidor sem banco PostgreSQL próprio. Pode aderir ao cluster como streamer ou se tornar outra instância do central sobre o banco compartilhado.
O pacote agora puxa o agora-base: o equipamento é esse mesmo servidor mais o que o torna um plano de controle.
Como ir de uma máquina limpa até uma transmissão no ar de uma só vez está na página Início rápido. O que vem a seguir é o que uma instalação real precisa.
O que a instalação do equipamento faz¶
Durante a instalação, o pacote agora:
- pede a chave de licença e a coloca em
/etc/agora/license.txt; - cria o papel e o banco de dados
agora; - gera a senha do banco e a do administrador e as escreve em
/etc/agora/secrets.env(modo0600, dono root); - inicia o
agora.service, que na primeira execução aplica o esquema do banco de dados.
As senhas não são impressas no terminal: elas são lidas do arquivo. Uma atualização ou uma reinstalação reaproveitam os segredos já escritos.
O que fazer depois com essas senhas está em Administradores: as credenciais estáticas ficam como a entrada de emergência, e o trabalho é feito com contas nominais.
O que a instalação de um nó faz¶
O pacote agora-base pergunta o que esta máquina vai ser:
- Um endereço de banco de dados — se a máquina levanta o seu próprio plano de controle sobre um banco já existente.
- Entrar em um cluster — se não: a instalação pergunta então o endereço do plano de controle e um token de acesso.
O token é obtido no painel, em Cluster → Streamers, com o botão Permitir a entrada; a janela dura uma hora (veja Streamers). Depois da instalação o nó procura o plano de controle sozinho e aparece na lista.
Uma máquina já configurada não é perguntada de novo: o endereço e o token são escritos uma vez, e uma atualização do pacote não repete a pergunta.
Onde cada coisa é guardada¶
/etc/agora/— as configurações do equipamento: o arquivo de licença e osecrets.env./var/lib/agora/— o estado de trabalho.agora.service— a unidade do systemd; com ela o serviço é parado e iniciado.
Aqui não existem, de propósito, arquivos com a configuração do cluster: a configuração — transmissões, modelos, zonas, permissões — vive no banco de dados do plano de controle e é editada no painel. Uma máquina guarda apenas o que a faz ser aquela máquina.
Atualização¶
A atualização é um apt comum:
apt update && apt install --only-upgrade agora
Em um cluster atualiza-se primeiro o plano de controle e depois os nós. O plano de controle tolera nós mais antigos que ele; o contrário não é garantido.
Uma atualização não pede a licença de novo e não toca nos segredos. O esquema do banco de dados é acertado quando a nova versão inicia pela primeira vez.
O que a rede precisa permitir¶
- Os espectadores precisam de acesso aos streamers, não ao plano de controle: o plano de controle decide para onde enviá-los, mas a transmissão vem de um servidor.
- Os nós precisam de acesso ao plano de controle: sem ele um nó continua funcionando, mas não recebe novas atribuições.
- A instalação precisa de acesso de saída para ativar a licença.