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