Neste guia, vamos analisar os passos para implementar um aplicativo de exemplo e um banco de dados. Sinta-se à vontade para usar o aplicativo de exemplo abaixo para testes, mas não confie nele para qualquer tipo de uso de produção. O objetivo do aplicativo é testar a implementação na Kinsta.
Aplicativo de exemplo
Nós criamos um pequeno aplicativo para registrar o tempo e exibir os resultados em uma página simples. Você pode encontrar o aplicativo no GitHub.
Abra o aplicativo de exemplo
Primeiro, visite o aplicativo weatherlogger-js no GitHub e leia o arquivo Readme incluído para saber mais sobre o aplicativo. Uma vez que você tenha se familiarizado com ele, clique no botão Fork no canto superior direito para fork para sua própria conta no GitHub.
Crie uma chave API
O aplicativo requer uma chave API do OpenWeather. Uma vez cadastrado, você pode fazer login e criar uma chave API gratuitamente que permite que você faça 1.000 chamadas API diariamente. Nós recomendamos fazer este passo primeiro, pois a chave API leva de 10 a 20 minutos para ficar ativa, o que nós podemos gastar configurando nosso aplicativo.
Processos
Ao implementar o aplicativo na Kinsta, nós precisamos executar dois processos:
- Um servidor web onde podemos ver nossos dados meteorológicos. Isto pode ser iniciado usando o comando
npm start. - Um cronjob que coleta dados meteorológicos a cada poucos minutos. Isto pode ser iniciado usando o comando
npm run weatherLogger
Vamos começar a preparar as coisas para executar esses processos.
Crie um Banco de Dados
No MyKinsta, certifique-se de que você está na página de Aplicações, clique em Adicionar serviço e selecione Banco de Dados no menu suspenso. Nós usamos os seguintes valores no formulário para criar nosso banco de dados de exemplo:
- Nome da base de dados: weatherloggerdb
- Nome de exibição: Weather Logger Database
- Tipo de base de dados: MySQL
- Versão: 8.0
- Nós deixamos o nome de usuário e senha do banco de dados intocados
- Localização do centro de dados: us-central1
- Tamanho do banco de dados: 0.25 núcleo de CPU – 256 MB de RAM (Mini)
Clique em Criar Banco de Dados, e você deve estar pronto.
Crie um aplicativo
Certifique-se de que você está na página de Aplicativos, clique em Adicionar serviço, então selecione Aplicativo no menu suspenso. Ao clicar no campo de repositório do GitHub, você precisará permitir que Kinsta interaja com seu repositório.
Para mais documentação passo a passo, veja Adicionar um aplicativo.
Utilizamos os seguintes valores no formulário de múltiplas partes para criar nosso exemplo de aplicativo:
Detalhes do aplicativo
- Repositório GitHub:
danielpataki/weatherlogger-js(no seu caso, isso será algo comoyour-organization/weatherlogger-js) - Ramo padrão: main
- Desdobramento automático no momento do compromisso: desmarcado
- Nome do aplicativo: Weather Logger
- Localização do centro de dados: us-central1
Construir ambiente
- Construir recursos: Padrão
- Construir ambiente: Configurar a imagem do contêiner automaticamente
Recursos
- Configure seus processos:
- Nome do processo: Processo Web
- Tipo de processo: web
- Comando start:
npm start - Tamanho do Pod: Padrão 0.5 CPU / 1 GB de RAM
- Contagem de instâncias: 1
Clique em Adicionar aplicativo e o processo de implantação será iniciado.
Forma de pagamento
Reveja os custos mensais de uso do aplicativo de exemplo e confirme seu método de pagamento.
Conectando o Aplicativo e o Banco de Dados
Assim que o banco de dados estiver pronto para conexões (uma marca de verificação verde é mostrada ao lado dele), podemos conectá-lo ao nosso aplicativo, mesmo que o aplicativo ainda esteja sendo implementada. Clique no aplicativo Weather Logger, clique em Configurações na barra lateral, e role para baixo para encontrar a seção Conexões internas.
Clique em Adicionar conexão, e na janela modal/pop-up que aparece, selecione o Weather Logger Database. Selecione a caixa de seleção Adicionar variáveis de ambiente para acessar o banco de dados, selecione a caixa de seleção Disponível durante a execução e Disponível durante o processo de build e clique em Adicionar conexão.
Configuração do aplicativo
A próxima coisa na nossa lista é adicionar todas as informações que nosso aplicativo precisa na forma de variáveis de ambiente. A maioria das informações foi automaticamente adicionada no passo anterior, preenchendo as variáveis de conexão ao banco de dados.
A única que falta no aplicativo é a chave API OpenWeatherMap. Na seção Configurações, logo abaixo da seção Conexões internas, você verá a seção Variáveis de Ambiente. Clique em Adicionar variável de ambiente e use OPENWEATHER_KEY como a chave e sua chave API como o valor.
O aplicativo suporta mais algumas variáveis para controlar a frequências de atualização, unidades usadas, etc. Dê uma olhada na documentação do aplicativo para mais informações.
Configuração de processos
Nós mencionamos no início que vamos precisar de um servidor web e um cronjob. Vá até a seção Processos do aplicativo, e você verá o processo web que roda npm start que criamos ao adicionar o aplicativo.
Para configurar o cronjob, clique no botão Criar processo e preencha o formulário no modal/pop-up que aparece. Nós usamos os seguintes valores para o nosso exemplo:
Nome: Worker
Tipo: Background job
Iniciar comando: npm run weatherLogger
Tamanho do Botão: Padrão 0.5 CPU / 1 GB de RAM
Instâncias: 1
Depois clique em Criar processo.
Implantar o aplicativo
Finalmente, volte para a seção Deployments e clique no botão Deploy now. A implantação geralmente leva cerca de 90 segundos, mas você pode precisar esperar um pouco mais para que todos os processos entrem em funcionamento corretamente. Sua primeira medição do tempo deve ser registrada alguns minutos depois disso. Para verificar se tudo está funcionando, dê uma olhada na seção de Logs.
Após alguns minutos, você deve ver os processos bem sucedidos nos logs de tempo de execução. Na imagem de exemplo acima, a linha 482 mostra que o logger começou a funcionar (Starting weather logging), e a linha 483 mostra que o servidor web está rodando (Weather server is up and running). A linha 245 em diante mostra os eventos de registro (Weather data retrieved e Weather data logged).
Perto do topo da página, você pode ver a URL do seu aplicativo (isso também pode ser encontrado na página de Implantação sob Última Implantação). Clique neste URL para ser levado para a página que está sendo servida pelo serviço web:
