1. Conéctese a su servidor
Utilice SSH para conectarse a su servidor:
ssh root@<server-ip>
2. Credenciales de inicio de sesión
Se ha creado un usuario dedicado llamado fastapi para gestionar su aplicación.
Puede encontrar las credenciales de inicio de sesión en este archivo: /root/.fastapi-creds
Para verlos, ejecute:
cat /root/.fastapi-creds
Si desea cambiar la contraseña, utilice:
passwd fastapi
3. Cambiar al usuario de la aplicación
Cambia a la cuenta de usuario fastapi para administrar tu aplicación:
su - flask
Esta cuenta contiene tu proyecto y entorno FastAPI.
4. Estructura del proyecto
Este es el diseño predeterminado del directorio:
/home/fastapi/fastapi_app/
├── main.py → Your main FastAPI application file
├── venv/ → Virtual environment
└── __pycache__/ → Compiled Python files (auto-generated)
5. Gestión de su solicitud
Navega hasta el directorio de la aplicación:
cd ~/fastapi_app
Activar el entorno virtual:
source venv/bin/activate
Edita el archivo principal de la aplicación:
nano main.py
Reinicie el servicio FastAPI para aplicar los cambios:
sudo systemctl restart uvicorn-fastapi
6. Visualización de registros
Puede consultar los registros de Uvicorn y Nginx de la siguiente manera:
- Registros de Uvicorn:
/var/log/uvicorn/ - Registro de errores de Nginx:
/var/log/nginx/error.log - Registro de acceso de Nginx:
/var/log/nginx/access.log
Para verlos:
sudo tail -f /var/log/uvicorn/*
7. Acceso a su API
Una vez que el servicio esté en funcionamiento, tu aplicación FastAPI estará disponible en tu navegador en: http://<server-ip>
Nginx reenvía automáticamente las solicitudes HTTP al socket Uvicorn que ejecuta tu aplicación FastAPI.
8. Cambiar el dominio o el puerto
Si desea actualizar el nombre del servidor, el puerto o el dominio:
- Editar la configuración del sitio Nginx:
sudo nano /etc/nginx/sites-available/uvicorn-fastapi - Configuración de la prueba:
sudo nginx -t - Recargar Nginx:
sudo systemctl restart nginx
9. Servicio Uvicorn
La aplicación FastAPI se ejecuta a través de un servicio systemd denominado uvicorn-fastapi.
Utiliza /home/fastapi/fastapi_app/main:app como punto de entrada de la aplicación y se reinicia automáticamente en caso de fallo.
Para gestionar el servicio:
systemctl status uvicorn-fastapi
systemctl restart uvicorn-fastapi
Para editar el servicio:
sudo vim /etc/systemd/system/uvicorn-fastapi.service
sudo systemctl daemon-reload
sudo systemctl restart uvicorn-fastapi
sudo systemctl status uvicorn-fastapi
10. Habilitar HTTPS (opcional)
Utiliza Certbot para habilitar HTTPS.