Ruby: Implementar em produção

Como implementar o seu código Ruby em produção em minutos

👋 Bem-vindo à documentação do Stackhero!

A Stackhero oferece uma solução Ruby cloud pronta a usar que proporciona uma série de benefícios, incluindo:

  • Implemente a sua aplicação em segundos com um simples git push.
  • Utilize o seu próprio nome de domínio e beneficie da configuração automática de certificados HTTPS para uma segurança reforçada.
  • Desfrute de tranquilidade com backups automáticos, atualizações com um clique, e preços simples, transparentes e previsíveis.
  • Obtenha desempenho ótimo e segurança robusta graças a uma VM privada e dedicada.

Poupe tempo e simplifique a sua vida: só leva 5 minutos para experimentar a solução de Ruby cloud hosting da Stackhero!

O serviço de alojamento cloud Ruby da Stackhero oferece uma forma poderosa e intuitiva de implementar os seus projetos Ruby em produção em apenas alguns minutos.

As principais funcionalidades incluem:

  • Implementação com um simples git push.
  • Domínio personalizável com gestão automática de certificados TLS (HTTPS).
  • Execução numa VM dedicada e privada para máxima segurança e confidencialidade.
  • Suporte para HTTP/2, TLS 1.3 (HTTPS), WebSockets, compressão GZIP & Brotli, ETag, acesso a portas TCP e UDP, e muito mais.

Para implementar os seus projetos na Stackhero, o único requisito é ter o Git instalado no seu computador.

Para poupar tempo e evitar configurações complexas, especialmente se o seu ambiente de desenvolvimento não estiver pronto, considere usar o Code-Hero da Stackhero.

O Code-Hero é uma plataforma de desenvolvimento poderosa, intuitiva e pronta a usar, acessível diretamente através do seu navegador em qualquer computador, tablet ou telefone. Baseada num fork do VSCode, inclui todas as ferramentas essenciais para o desenvolvimento, pré-instaladas e pré-configuradas, permitindo-lhe começar a programar instantaneamente sem complicações.

<!-- ![Exemplo de uma instância Code-Hero a correr diretamente no navegador](/images/docs/ruby/040_deploy/rubyInCodeHero.png) -->

Implementar a sua aplicação Ruby na Stackhero é simples. Pode seguir estes passos, cada um detalhado mais adiante neste guia:

  1. Crie um serviço Ruby na Stackhero.
  2. Adicione a sua chave pública SSH à configuração do seu serviço Ruby.
  3. Configure o comando git push na sua plataforma de desenvolvimento.
  4. Adicione um Makefile ao seu projeto.
  5. Implemente o seu código em produção.

Se encontrar algum problema durante a implementação, a documentação "Resolução de Problemas" provavelmente fornecerá uma solução. Certifique-se de consultar este guia, pois pode poupar-lhe tempo e evitar frustrações desnecessárias.

Se ainda não iniciou um serviço Stackhero for Ruby, pode criar um no seu painel de controlo Stackhero. Demora apenas 2 minutos.

Assim que o seu serviço Ruby estiver iniciado, precisa de o configurar adicionando a sua chave pública SSH. Pode localizar a sua chave pública executando o comando:

cat ~/.ssh/id_*.pub

Ainda não tem chaves SSH?

Pode criá-las usando:

ssh-keygen -t ed25519

Para configurar o seu serviço Ruby, navegue até ao painel de controlo Stackhero, selecione o seu serviço Ruby, clique no botão "Configurar" e cole o conteúdo da sua chave pública na secção "Chaves públicas SSH".

<!-- ![Exemplo de configuração de um serviço Ruby](/images/docs/ruby/040_deploy/rubyStackheroPublicKey.png) -->

Dica: Pode definir a sua chave pública SSH globalmente para que futuros serviços a incluam automaticamente na sua configuração.

Para fazer isso, navegue até ao painel de controlo Stackhero, clique na sua foto de perfil no canto superior direito, selecione "O seu perfil" e adicione a sua chave pública SSH.

A implementação na Stackhero é feita através da CLI Git com o comando git push. Esta abordagem torna as implementações simples, rápidas e fiáveis sem necessitar de ferramentas adicionais no seu computador.

Para ativar esta funcionalidade, copie e cole o valor do comando git remote da página principal do seu serviço no painel de controlo Stackhero. O comando geralmente parece-se com isto:

git remote add stackhero ssh://stackhero@<XXXXXX>.stackhero-network.com:222/project.git
<!-- ![Comando Git remote Ruby no painel de controlo Stackhero](/images/docs/ruby/040_deploy/rubyStackheroGitRemote.png) -->

Para implementar o seu código na Stackhero, precisa de especificar os comandos para a sua aplicação criando um Makefile. Este ficheiro atua como uma ponte entre a Stackhero e a sua aplicação.

Se não estiver familiarizado com Makefiles e o comando make, não se preocupe. As instruções abaixo irão guiá-lo durante o processo.

Crie um Makefile na raiz do seu projeto e adicione o seguinte conteúdo:

run:
	rake assets:precompile
	rake db:migrate RAILS_ENV=production
	RAILS_ENV=production bundle exec puma -C config/puma.rb

Este Makefile contém três componentes importantes:

  1. A regra run, que é obrigatória pois é automaticamente executada pela Stackhero. Não a renomeie porque serve como ponto de entrada para a sua implementação.
  2. Os comandos executados usando rake e bundle. Pode substituí-los pelos comandos apropriados para a sua aplicação, se necessário.
  3. Cada comando deve ser prefixado com um carácter de tabulação em vez de espaços. Se vir um erro como "*** missing separator", verifique se está a usar um carácter de tabulação.

Neste exemplo, três comandos são executados durante a implementação:

  1. Os assets como JavaScript e CSS são pré-compilados no diretório public/assets.
  2. As migrações de base de dados são executadas, se necessário.
  3. Um servidor Puma é iniciado para servir a sua aplicação.

Está agora pronto para implementar a sua aplicação Ruby! Para implementar o seu código na Stackhero, execute o seguinte comando:

git push stackhero main

A primeira vez que executar este comando, ser-lhe-á pedido para adicionar a impressão digital da chave SSH. Responda "yes" para continuar.

Após alguns segundos, a sua aplicação estará online.

<!-- ![Exemplo de implementação de código Ruby na Stackhero usando o comando `git push`](/images/docs/ruby/040_deploy/rubyDeployGitPush.png) -->

Para verificar a sua aplicação implementada, navegue até ao URL do site fornecido no painel de controlo Stackhero. Geralmente parece-se com https://XXXXX.stackhero-network.com.

Parabéns, a sua aplicação está agora implementada em produção!

Encontrou problemas durante a implementação?

Consulte a secção Resolução de Problemas, onde provavelmente encontrará uma solução!

Este guia forneceu uma visão geral completa e simples sobre como implementar código Ruby em produção usando a Stackhero. Constitui uma base sólida para gerir eficazmente as suas implementações de aplicações.

Para expandir o seu conhecimento, considere explorar a documentação "Usos Avançados de Implementação". Aqui aprenderá como implementar várias branches git, tags ou commits específicos, e gerir múltiplos ambientes como staging e produção. Também descobrirá dicas sobre como trabalhar com variáveis de ambiente e muito mais.

Se enfrentar algum problema durante o processo de implementação, a documentação "Resolução de Problemas" é um recurso inestimável que pode ajudá-lo a resolver problemas de forma eficiente e minimizar frustrações.