Python: Implementar em produção

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

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

Stackhero oferece uma solução cloud Python 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 performance ótima 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 hospedagem cloud Python do Stackhero!

O serviço de alojamento cloud Python da Stackhero é uma solução poderosa e fácil de usar para implementar os seus projetos Python em produção em minutos. Com uma configuração simples e funcionalidades robustas, pode concentrar-se em escrever código enquanto a Stackhero trata do trabalho pesado.

As funcionalidades principais incluem:

• Implementação com um simples git push
• Domínio personalizável com gestão automática de certificados TLS (HTTPS)
• 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, e acesso a portas TCP/UDP

Pré-requisitos

Antes de implementar os seus projetos na Stackhero, certifique-se de que tem o Git instalado no seu computador.

Para poupar tempo e evitar configurações complexas 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, fácil de usar e pronta a utilizar, que pode aceder diretamente através do seu navegador em qualquer computador, tablet ou telefone. Baseada num fork do VSCode, vem pré-instalada com todas as ferramentas de desenvolvimento essenciais, permitindo-lhe começar a programar imediatamente sem complicações.

Exemplo de uma instância Code-Hero a correr diretamente no navegador

Passos para implementar na Stackhero

Implementar a sua aplicação Python na Stackhero é simples. Pode seguir estes passos:

1. Crie um serviço Python na Stackhero.
2. Adicione a sua chave pública SSH à configuração do seu serviço Python.
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 problemas durante a implementação, a documentação "Resolução de Problemas" provavelmente fornecerá uma solução. Pode poupar-lhe tempo e evitar frustrações desnecessárias.

Configuração do seu serviço "Stackhero for Python"

Se ainda não iniciou um serviço Stackhero for Python, crie um no seu painel de controlo Stackhero (demora apenas 2 minutos).

Assim que o seu serviço Python estiver a funcionar, precisa de o configurar adicionando a sua chave pública SSH. Pode encontrar a sua chave pública executando:

cat ~/.ssh/id_*.pub

Ainda não tem chaves SSH?

Pode criá-las usando:

ssh-keygen -t ed25519

Para configurar o seu serviço Python:

1. Vá ao painel de controlo Stackhero e selecione o seu serviço Python.
2. Clique no botão "Configurar".
3. Cole o conteúdo da sua chave pública na secção "Chaves públicas SSH".

Exemplo de configuração de um serviço Python

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, aceda 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.

Configuração do comando git push para implementação

A implementação na Stackhero utiliza a CLI Git com o comando git push. Este método torna as implementações simples, rápidas e fiáveis e não requer a instalação de ferramentas adicionais.

Para ativar esta funcionalidade, copie o valor do comando git remote da página principal do seu serviço no painel de controlo Stackhero. O comando será semelhante a:

git remote add stackhero ssh://stackhero@<XXXXXX>.stackhero-network.com:222/project.git

Comando Git remote Python no painel de controlo da Stackhero

Criação de um Makefile para implementação na Stackhero

Para implementar o seu código na Stackhero, deve especificar os comandos que a Stackhero deve executar. Isto é feito através de um Makefile, que atua como uma interface entre a Stackhero e a sua aplicação.

Se não estiver familiarizado com ficheiros Makefile e o comando make, não se preocupe. Basta seguir as instruções fornecidas aqui.

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

run:
  gunicorn app:app -b 0.0.0.0:8080 --error-logfile -

Este Makefile inclui três componentes importantes:

1. A regra run é obrigatória porque é automaticamente executada pela Stackhero. Não a renomeie.
2. O comando gunicorn app:app -b 0.0.0.0:8080 --error-logfile - é um exemplo e deve ser substituído pelo comando apropriado para a sua aplicação.
3. Um carácter de tabulação deve preceder o comando gunicorn. Se encontrar um erro indicando "*** missing separator", isso significa que o carácter de tabulação está em falta.

Neste exemplo, um servidor Gunicorn é iniciado (certifique-se de que está instalado e adicionado ao seu ficheiro requirements.txt). O argumento -b 0.0.0.0:8080 configura o servidor para escutar em qualquer interface na porta 8080. Se alterar a porta, atualize-a na configuração do seu serviço Python no painel de controlo Stackhero. A parte app:app indica que o servidor usará o ficheiro app.py e a instância app.

Implementação da sua aplicação Python

A sua aplicação Python está agora pronta para implementação. Para implementar o seu código na Stackhero, execute o seguinte comando a partir do diretório do seu projeto:

git push stackhero main

A primeira vez que executar este comando, será solicitado a adicionar a impressão digital da chave SSH. Responda "yes" quando solicitado. Em apenas alguns segundos, a sua aplicação estará online!

Exemplo de implementação de código Python na Stackhero usando o comando git push

Para verificar a sua aplicação implementada, aceda ao URL "website" exibido no painel de controlo Stackhero (geralmente parece 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 para soluções que o ajudarão a resolver rapidamente os problemas.

Conclusão

Este guia fornece uma visão geral completa mas simples da implementação de código Python em produção usando a Stackhero. Serve como uma base sólida para implementar eficazmente as suas aplicações.

Para expandir ainda mais o seu conhecimento, considere explorar a documentação "Usos Avançados de Implementação". Aprenderá como implementar várias branches git, tags ou commits específicos, bem como gerir múltiplos ambientes como "staging" e "produção". Também descobrirá 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 valioso que pode ajudá-lo a resolver problemas de forma rápida e eficiente.