Editando a sua Home

Tutorial: Atualizando o config.yml do Homer via Portainer

Pré-requisitos

• Portainer Instalado: Certifique-se de que o Portainer está instalado e acessível.

• Acesso ao Portainer: Tenha as credenciais necessárias para acessar o Portainer.

• Editor vi Disponível: O editor vi deve estar disponível no container Homer (geralmente já está instalado).

---

Passo 1: Acessar o Portainer

1. Abra o Navegador:

   • Vá para a URL do seu Portainer (por exemplo, http://seu-dominio.com:9000).

2. Faça Login:

   • Insira suas credenciais de administrador para acessar o painel do Portainer.

---

Passo 2: Localizar o Container do Homer

1. Navegue até a Seção de Containers:

   • No menu lateral esquerdo, clique em "Containers".

2. Identifique o Container do Homer:

   • Procure pelo container que está executando o Homer. O nome pode ser algo como homer, homer_container ou similar, dependendo de como foi configurado.

---

Passo 3: Acessar o Shell do Container

1. Abrir o Terminal do Container:

   • Clique no nome do container do Homer para visualizar os detalhes.

   • Na parte superior direita, clique em "Console" ou "Exec Console" (dependendo da versão do Portainer).

2. Selecionar o Tipo de Shell:

   • Na janela que se abre, escolha sh como o shell a ser utilizado.

   • Clique em "Connect" para abrir o terminal.

---

Passo 4: Navegar até o Diretório do config.yml

1. Alterar para o Diretório Correto:

   cd /www/assets

   Este comando navega até o diretório onde o config.yml está localizado.

2. Verificar a Presença do Arquivo:

   ls

   Este comando lista os arquivos no diretório atual. Você deve ver o config.yml listado.

---

Passo 5: Fazer um Backup do config.yml (Opcional, mas Recomendado)

Antes de editar, é uma boa prática criar uma cópia de segurança do arquivo atual.

1. Criar o Backup:

   cp config.yml config_backup.yml

   Este comando cria uma cópia chamada config_backup.yml no mesmo diretório.

---

Passo 6: Editar o config.yml com o vi

1. Abrir o Arquivo no vi:

   vi config.yml

2. Entrar no Modo de Inserção:

   • Pressione a tecla i para entrar no modo de inserção. Você verá -- INSERT -- na parte inferior do editor.

3. Editar o Arquivo:

   • Cole o Novo Código: Se você já copiou o novo conteúdo para a área de transferência, cole-o agora:

     • No Terminal: Clique com o botão direito e selecione "Paste", ou use o atalho Shift + Insert (dependendo do seu terminal).

   • Faça as Alterações Necessárias: Caso precise fazer ajustes manuais, navegue e edite conforme necessário.

   :%d

4. Salvar as Alterações e Sair do vi:

   • Pressione Esc para sair do modo de inserção.

   • Digite :wq e pressione Enter para salvar e sair do editor.

   :wq

   • Alternativas:

     • Salvar sem Sair: :w + Enter

     • Sair sem Salvar: :q! + Enter (use com cautela)

---

Passo 7: Reiniciar o Container do Homer

Para que as alterações no config.yml entrem em vigor, é necessário reiniciar o container.

1. Voltar ao Portainer:

   • Feche o console do container ou abra uma nova aba no navegador e vá para o Portainer.

2. Navegar até a Seção de Containers:

   • No menu lateral esquerdo, clique em "Containers".

3. Reiniciar o Container:

   • Localize o container do Homer.

   • Clique no botão "Restart" (geralmente representado por um ícone de setas circulares) ao lado do nome do container.

   Aguarde alguns instantes para que o container reinicie.

---

Passo 8: Verificar as Alterações no Dashboard

1. Acessar o Dashboard do Homer:

   • Abra o navegador e vá para a URL do seu dashboard Homer (por exemplo, http://homer.elefai.com.br).

2. Verificar o Funcionamento:

   • Confirme se as alterações feitas no config.yml estão refletidas no dashboard.

   • Verifique o cabeçalho, rodapé e quaisquer outras personalizações que você tenha realizado.

3. Testar Funcionalidades Adicionais:

   • Se você integrou notificações com o ntfy, envie uma notificação de teste para verificar se está funcionando corretamente.

   curl -d "Teste de notificação para o dashboard." https://push.elefai.com.br/dashboard

   Substitua dashboard pelo tópico que você configurou.

Considerações Finais

Seguindo este tutorial, você conseguirá atualizar o arquivo config.yml do seu dashboard Homer de forma segura e eficiente utilizando o Portainer e o editor vi dentro do ambiente Docker. Sempre lembre-se de fazer backups e validar a sintaxe para evitar interrupções no funcionamento do seu dashboard.