Python: Despliegue en producción

Cómo desplegar su código Python en producción en cuestión de minutos

👋 ¡Bienvenido a la documentación de Stackhero!

Stackhero ofrece una solución nube de Python lista para usar que proporciona una serie de beneficios, incluyendo:

• Despliegue su aplicación en segundos con un simple git push.
• Use su propio nombre de dominio y benefíciese de la configuración automática de certificados HTTPS para una mayor seguridad.
• Disfrute de la tranquilidad con copias de seguridad automáticas, actualizaciones con un clic, y precios sencillos, transparentes y predecibles.
• Obtenga un rendimiento óptimo y una seguridad robusta gracias a una VM privada y dedicada.

Ahorre tiempo y simplifique su vida: solo toma 5 minutos probar la solución de alojamiento en la nube de Python de Stackhero.

El servicio de alojamiento en la nube para Python de Stackhero ofrece una forma sencilla y fiable de desplegar sus proyectos Python en producción en solo unos minutos. Gracias a su configuración intuitiva y a sus funciones robustas, puede centrarse en desarrollar su aplicación mientras Stackhero se encarga de los detalles de la infraestructura.

Algunas de las características clave incluyen:

• Despliegue mediante un simple git push
• Dominios personalizados con gestión automática de certificados TLS (HTTPS)
• Máquinas virtuales dedicadas y privadas para mayor seguridad y confidencialidad
• Compatibilidad con HTTP/2, TLS 1.3 (HTTPS), WebSockets, compresión GZIP y Brotli, ETag y acceso a puertos TCP/UDP

Requisitos previos

Antes de comenzar con Stackhero, asegúrese de que Git esté instalado en su ordenador.

Si todavía no ha configurado su entorno de desarrollo o quiere ahorrar tiempo en la configuración, puede probar Code-Hero de Stackhero.

Code-Hero es una plataforma de desarrollo lista para usar, fácil de manejar, que funciona directamente en su navegador, desde cualquier ordenador, tablet o teléfono. Basada en un fork de VSCode, Code-Hero viene con las herramientas esenciales de desarrollo preinstaladas, para que pueda empezar a programar de inmediato sin configuraciones adicionales.

Ejemplo de una instancia de Code-Hero ejecutándose directamente en el navegador

Pasos para desplegar en Stackhero

El despliegue de su aplicación Python en Stackhero está diseñado para ser sencillo y fluido. Así es como puede hacerlo:

1. Cree un servicio Python en Stackhero.
2. Añada su clave pública SSH a la configuración de su servicio Python.
3. Configure el comando git push en su plataforma de desarrollo.
4. Añada un Makefile a su proyecto.
5. Despliegue su código en producción.

Si encuentra algún problema durante el despliegue, probablemente encontrará respuestas en la documentación de "Solución de problemas". Consultarla primero puede ahorrarle frustraciones innecesarias.

Configuración de su servicio "Stackhero for Python"

Si aún no ha iniciado un servicio Stackhero for Python, puede crear uno desde su panel de Stackhero. Normalmente solo tarda unos minutos.

Una vez que su servicio Python esté en funcionamiento, deberá añadir su clave pública SSH a su configuración. Puede mostrar su clave pública ejecutando:

cat ~/.ssh/id_*.pub

¿Todavía no tiene claves SSH?

Puede generarlas con:

ssh-keygen -t ed25519

Para añadir su clave pública a su servicio Python:

1. Abra el panel de Stackhero y seleccione su servicio Python.
2. Haga clic en el botón "Configurar".
3. Pegue su clave pública SSH en la sección "Claves públicas SSH".

Ejemplo de configuración de un servicio Python

Consejo: También puede establecer su clave pública SSH de forma global para que cualquier nuevo servicio que cree la incluya automáticamente. Para ello, vaya a su perfil en el panel de Stackhero, haga clic en su foto de perfil en la esquina superior derecha, seleccione "Su perfil" y añada su clave pública SSH.

Configuración del comando git push para el despliegue

Stackhero facilita los despliegues utilizando la CLI de Git y el conocido comando git push. No es necesario instalar software adicional, solo configure su remoto de Git una vez y estará listo para empezar.

Encontrará su git remote command en la página principal de su servicio en el panel de Stackhero. Será algo similar a esto:

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

Comando Git remote de Python en el panel de Stackhero

Creación de un Makefile para el despliegue en Stackhero

Para indicar a Stackhero cómo ejecutar su aplicación, debe utilizar un Makefile en el directorio raíz de su proyecto.

Si no está familiarizado con los archivos Makefile y el comando make, no se preocupe. Siga estas instrucciones para empezar.

Cree un archivo Makefile en la raíz de su proyecto con el siguiente contenido:

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

Hay algunos aspectos importantes a tener en cuenta con este Makefile:

1. La regla run es obligatoria, ya que Stackhero la ejecuta automáticamente. Por favor, no la renombre.
2. El comando gunicorn app:app -b 0.0.0.0:8080 --error-logfile - es solo un ejemplo. Asegúrese de adaptarlo a las necesidades de su aplicación.
3. Asegúrese de que el comando gunicorn comience con un carácter de tabulación. Si ve un error como "*** missing separator", significa que falta la tabulación.

En este ejemplo, Gunicorn se utiliza para servir su aplicación (asegúrese de que esté incluido en su requirements.txt). El argumento -b 0.0.0.0:8080 indica que escucha en todas las interfaces en el puerto 8080. Si elige otro puerto, también deberá actualizar la configuración de su servicio Python en el panel de Stackhero. La parte app:app hace referencia al objeto app dentro de su archivo app.py.

Desplegar su aplicación Python

Una vez que todo esté configurado, ya puede desplegar. Desde el directorio de su proyecto, utilice este comando para enviar su código a Stackhero:

git push stackhero main

La primera vez que ejecute este comando, se le pedirá que confirme la huella digital de la clave SSH. Simplemente responda "yes" cuando se le solicite. En unos segundos, su aplicación estará en línea.

Ejemplo de despliegue de código Python en Stackhero usando el comando git push

Para ver su aplicación desplegada, vaya a la URL "website" que aparece en su panel de Stackhero (normalmente tiene el formato https://<XXXXXX>.stackhero-network.com).

Eso es todo, su aplicación ya está en producción.

¿Está teniendo problemas durante el despliegue?

La sección de Solución de problemas está llena de soluciones para ayudarle a resolver cualquier inconveniente rápidamente.

Conclusión

Esperamos que esta guía le haya ayudado a desplegar su código Python en producción con Stackhero de forma clara y accesible. Con esta base, puede poner en marcha sus proyectos con total confianza.

Si desea profundizar, la documentación de "Usos avanzados del despliegue" cubre temas como desplegar desde diferentes ramas, etiquetas o commits de git, gestionar varios entornos (como staging y producción), y trabajar con variables de entorno.

Y recuerde, si encuentra algún problema, la documentación de "Solución de problemas" siempre está disponible para ayudarle a volver a la normalidad rápidamente.