Las apps de Django que se ejecutan en el entorno estándar de App Engine escalan de manera dinámica en función del tráfico.
En este instructivo, se supone que estás familiarizado con el desarrollo web con Django. Si si recién comienzas a desarrollar en Django, es recomendable escribir tu primera app de Django antes de continuar.
Si bien en este instructivo se muestra Django de forma específica, puedes usar este proceso de implementación con otros marcos de trabajo basados en Django, como Wagtail y el Django CMS.
En este instructivo, se usa Django 4, que requiere al menos Python 3.8. El entorno estándar de App Engine admite Python 3.7 y versiones posteriores, incluido Python 3.8.
Objetivos
En este instructivo, podrás:
- Crear y conectar una base de datos de Cloud SQL
- Crear y usar valores de secretos de Secret Manager
- Implementa una app de Django en el entorno estándar de App Engine.
Costos
En este documento, usarás los siguientes componentes facturables de Google Cloud:
Para generar una estimación de costos en función del uso previsto, usa la calculadora de precios.
Antes de comenzar
- Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.
-
Enable the Cloud SQL Admin API, Secret Manager, and Cloud Build APIs.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.
-
Enable the Cloud SQL Admin API, Secret Manager, and Cloud Build APIs.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
- Si aún no lo has hecho, inicializa App Engine y selecciona tu región preferida:
gcloud app create
Prepara el entorno
Clona una app de ejemplo
El código de la app de ejemplo de Django se encuentra en GoogleCloudPlatform/python-docs-samples en un repositorio de GitHub.
Puedes descargar la muestra. como un archivo ZIP y extráelo o clona el repositorio en tu máquina local:
git clone https://github.com/GoogleCloudPlatform/python-docs-samples.git
Ve al directorio que contiene el código de muestra:
Linux/macOS
cd python-docs-samples/appengine/standard_python3/django
Windows
cd python-docs-samples\appengine\standard_python3\django
Confirma la configuración de Python
Este instructivo utiliza Python para ejecutar la aplicación de ejemplo en tu máquina. El código de muestra también requiere instalar dependencias
Para obtener más detalles, consulta la guía del entorno de desarrollo de Python.
Confirma que la versión de Python sea 3.8, como mínimo.
python -V
Deberías ver
Python 3.8.0
o una versión posterior.Crea un entorno virtual de Python y, luego, instala las dependencias:
Linux/macOS
python -m venv venv source venv/bin/activate pip install --upgrade pip pip install -r requirements.txt
Windows
python -m venv venv venv\scripts\activate pip install --upgrade pip pip install -r requirements.txt
Descarga el proxy de autenticación de Cloud SQL para conectarte a Cloud SQL desde tu máquina local
Cuando se implementa, tu app usa el proxy de autenticación de Cloud SQL integrado en entorno estándar de App Engine para comunicarte con tu Cloud SQL instancia. Sin embargo, para probar tu aplicación de manera local, debes instalar y usar una copia local del proxy en tu entorno de desarrollo. Para obtener más información, consulta la Guía del proxy de autenticación de Cloud SQL.
El proxy de autenticación de Cloud SQL usa la API de Cloud SQL para interactuar con tu instancia de SQL. Para hacerlo, se requiere la autenticación de la aplicación a través de la gcloud CLI.
Autentica y adquiere credenciales para la API:
gcloud auth application-default login
Descarga y, luego, instala el proxy de autenticación de Cloud SQL en tu máquina local.
Linux de 64 bits
- Descarga el proxy de autenticación de Cloud SQL:
curl -o cloud-sql-proxy https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.13.0/cloud-sql-proxy.linux.amd64
- Haz que el proxy de autenticación de Cloud SQL sea ejecutable:
chmod +x cloud-sql-proxy
Linux de 32 bits
- Descarga el proxy de autenticación de Cloud SQL:
curl -o cloud-sql-proxy https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.13.0/cloud-sql-proxy.linux.386
- Si no se encuentra el comando
curl
, ejecutasudo apt install curl
y repite el comando de descarga. - Haz que el proxy de autenticación de Cloud SQL sea ejecutable:
chmod +x cloud-sql-proxy
macOS de 64 bits
- Descarga el proxy de autenticación de Cloud SQL:
curl -o cloud-sql-proxy https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.13.0/cloud-sql-proxy.darwin.amd64
- Haz que el proxy de autenticación de Cloud SQL sea ejecutable:
chmod +x cloud-sql-proxy
Mac M1
- Descarga el proxy de autenticación de Cloud SQL:
curl -o cloud-sql-proxy https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.13.0/cloud-sql-proxy.darwin.arm64
- Haz que el proxy de autenticación de Cloud SQL sea ejecutable:
chmod +x cloud-sql-proxy
Windows de 64 bits
Hacer clic con el botón derecho https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.13.0/cloud-sql-proxy.x64.exe y selecciona Guardar vínculo como para descargar el proxy de autenticación de Cloud SQL. Cambia el nombre del archivo porcloud-sql-proxy.exe
.Windows de 32 bits
Hacer clic con el botón derecho https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.13.0/cloud-sql-proxy.x86.exe y selecciona Guardar vínculo como para descargar el proxy de autenticación de Cloud SQL. Cambia el nombre del archivo porcloud-sql-proxy.exe
.Imagen de Docker del proxy de Cloud SQL
El proxy de autenticación de Cloud SQL tiene diferentes imágenes de contenedor, como
distroless
,alpine
ybuster
. La imagen de contenedor del proxy de autenticación de Cloud SQL predeterminada usadistroless
, que no contiene shell. Si necesitas una shell o herramientas relacionadas, descarga una imagen basada enalpine
obuster
. Para obtener más información, consulta Imágenes de contenedor del proxy de autenticación de Cloud SQL.Puedes extraer la última imagen a tu máquina local con Docker a través del siguiente comando:
docker pull gcr.io/cloud-sql-connectors/cloud-sql-proxy:2.13.0
Otro SO
Para otros sistemas operativos que no se incluyen aquí, puedes compilar el proxy de autenticación de Cloud SQL desde la fuente.Puedes mover la descarga a un lugar común, como una ubicación del
PATH
o el directorio principal. Si decides hacerlo, cuando inicies el proxy de autenticación de Cloud SQL más adelante en el instructivo, recuerda hacer referencia a la ubicación que elegiste cuando uses los comandoscloud_sql_proxy
.- Descarga el proxy de autenticación de Cloud SQL:
Crea servicios de copia de seguridad
En este instructivo, se usan varios servicios de Google Cloud para proporcionar la de la base de datos, el almacenamiento de medios y el almacenamiento secreto que admiten la implementación de Django en un proyecto final. Estos servicios se implementan en una región específica. Para una eficiencia entre servicios, todos los servicios deben implementarse en la misma región. Para obtener más información sobre la región más cercana, consulte Productos disponibles por región.
En este instructivo, se usan los mecanismos integrados de alojamiento de elementos estáticos del estándar de App Engine.Configura una instancia de Cloud SQL para PostgreSQL
Django admite oficialmente múltiples bases de datos relacionales, pero ofrece con PostgreSQL. PostgreSQL es compatible con Cloud SQL, así que instructivo elige usar ese tipo de base de datos.
En la siguiente sección, se describe la creación de una instancia, una base de datos y un usuario de base de datos de PostgreSQL para la app.
Crea la instancia de PostgreSQL:
Console
En la consola de Google Cloud, ve a la página Instancias de Cloud SQL.
Haga clic en Crear instancia.
Haz clic en PostgreSQL.
En el campo ID de instancia, ingresa
INSTANCE_NAME
.Ingresa una contraseña para el usuario de postgres.
Mantén los valores predeterminados en los otros campos.
Haga clic en Crear.
La creación de la instancia y su uso demora unos minutos.
gcloud
Crea la instancia de PostgreSQL:
gcloud sql instances create INSTANCE_NAME \ --project PROJECT_ID \ --database-version POSTGRES_13 \ --tier db-f1-micro \ --region REGION
Reemplaza lo siguiente:
INSTANCE_NAME
: Es el nombre de la instancia de Cloud SQL.PROJECT_ID
: El ID del proyecto de Google CloudREGION
: Es la región de Google Cloud.
La creación de la instancia y su uso demora unos minutos.
Dentro de la instancia creada, crea una base de datos:
Console
- En la página de tu instancia, ve a la pestaña Bases de datos.
- Haga clic en Create database.
- En el diálogo Nombre de la base de datos, ingresa
DATABASE_NAME
. - Haga clic en Crear.
gcloud
Crea la base de datos dentro de la instancia recién creada:
gcloud sql databases create DATABASE_NAME \ --instance INSTANCE_NAME
Reemplaza
DATABASE_NAME
por un nombre para la base de datos dentro de la instancia.
Crea un usuario de base de datos:
Console
- En la página de tu instancia, ve a la pestaña Usuarios.
- Haz clic en Agregar cuenta de usuario.
- En el cuadro de diálogo Agregar una cuenta de usuario a la instancia en "Autenticación integrada", haz lo siguiente:
- Ingresa el nombre de usuario
DATABASE_USERNAME
. - Ingresa la contraseña
DATABASE_PASSWORD
- Haga clic en Agregar.
gcloud
Crea el usuario dentro de la instancia recién creada:
gcloud sql users create DATABASE_USERNAME \ --instance INSTANCE_NAME \ --password DATABASE_PASSWORD
Reemplaza
PASSWORD
por una contraseña segura.
Almacena valores secretos en el Secret Manager
Ahora que los servicios de copia de seguridad están configurados, Django necesita información sobre estos servicios. En lugar de colocar estos valores directamente en el código fuente de Django, en este instructivo se usa Secret Manager para almacenar esta información de forma segura.
El entorno estándar de App Engine interactúa con los Secrets a través de sus cuenta de servicio.Cree un archivo de entorno de Django como un secreto del Secret Manager
Almacenarás la configuración necesaria para iniciar Django en un archivo de entorno seguro.
La app de ejemplo usa la API de Secret Manager para recuperar el Secret.
valor y django-environ
para cargar los valores en el entorno de Django. Se configura el Secret
sean accesibles para el entorno estándar de App Engine.
Crea un archivo llamado
.env
y define la cadena de conexión de la base de datos, el nombre del bucket de medios y un nuevo valorSECRET_KEY
:echo DATABASE_URL=postgres://DATABASE_USERNAME:DATABASE_PASSWORD@//cloudsql/PROJECT_ID:REGION:INSTANCE_NAME/DATABASE_NAME > .env echo GS_BUCKET_NAME=PROJECT_ID_MEDIA_BUCKET >> .env echo SECRET_KEY=$(cat /dev/urandom | LC_ALL=C tr -dc '[:alpha:]'| fold -w 50 | head -n1) >> .env
Almacena el secreto en Secret Manager:
Console
En la consola de Google Cloud, ve a la página Secret Manager.
Haz clic en Crear Secreto.
En el campo Nombre, ingresa
django_settings
.En el diálogo Valor del secreto, pega el contenido de tu archivo
.env
.Haz clic en Crear secreto.
Borra el archivo local para evitar anulaciones de la configuración local.
gcloud
Crea un secreto nuevo,
django_settings
, con el valor del archivo.env
:gcloud secrets create django_settings --data-file .env
Para confirmar la creación del secreto, verifícalo:
gcloud secrets describe django_settings gcloud secrets versions access latest --secret django_settings
Borra el archivo local para evitar anulaciones de la configuración local:
rm .env
Configura el acceso al secreto:
Console
- Haz clic en la pestaña Permisos.
- Haga clic en Agregar.
- En el campo Nuevos miembros, ingresa
PROJECT_ID@appspot.gserviceaccount.com
y, luego, presionaEnter
. - En el menú desplegable Función, selecciona Descriptor de acceso a secretos de Secret Manager.
- Haz clic en Guardar.
gcloud
Otorga acceso al secreto a la cuenta de servicio estándar de App Engine:
gcloud secrets add-iam-policy-binding django_settings \ --member serviceAccount:PROJECT_ID@appspot.gserviceaccount.com \ --role roles/secretmanager.secretAccessor
Cómo ejecutar la app en una computadora local
Con los servicios de copia de seguridad configurados, ahora puedes ejecutar la app en tu computadora. Esta configuración permite el desarrollo local, crear un superusuario y aplicar migraciones de bases de datos.
En una terminal separada, inicia el proxy de autenticación de Cloud SQL:
Linux/macOS
./cloud-sql-proxy PROJECT_ID:REGION:INSTANCE_NAME
Windows
cloud-sql-proxy.exe PROJECT_ID:REGION:INSTANCE_NAME
Este paso establece una conexión entre tu computadora local y Instancia de Cloud SQL para realizar pruebas locales. Mantén la El proxy de autenticación de Cloud SQL se ejecuta todo el tiempo que pruebas tu aplicación de manera local. Correr este proceso en una terminal independiente te permite seguir trabajando mientras se ejecuta este proceso.
En la terminal original, configura el ID del proyecto de forma local (que usa la API de Secret Manager):
Linux/macOS
export GOOGLE_CLOUD_PROJECT=PROJECT_ID
Windows
set GOOGLE_CLOUD_PROJECT=PROJECT_ID
Establece una variable de entorno para indicar que estás usando el proxy de autenticación de Cloud SQL (este valor se reconoce en el código):
Linux/macOS
export USE_CLOUD_SQL_AUTH_PROXY=true
Windows
set USE_CLOUD_SQL_AUTH_PROXY=true
Ejecuta las migraciones de Django para configurar tus modelos y elementos:
python manage.py makemigrations python manage.py makemigrations polls python manage.py migrate python manage.py collectstatic
Inicia el servidor web de Django:
python manage.py runserver 8080
En tu navegador, ve a http://localhost:8080.
Si estás en Cloud Shell, haz clic en el botón Vista previa en la Web y selecciona Vista previa en el puerto 8080.
En la página, se muestra el siguiente texto: “Hello, world. You're at the polls index”. El servidor web de Django que se ejecuta en tu computadora proporciona las páginas de la app de muestra.
Presiona
Ctrl
/Cmd
+C
para detener el servidor web local.
Usar la Consola del administrador de Django
Para acceder a la Consola del administrador de Django, debes crear un superusuario. Dado que tienes una conexión a la que se puede acceder de manera local a la base de datos, puedes ejecutar comandos de administración:
Crea un superusuario. Deberás ingresar un nombre de usuario, un correo electrónico y una contraseña.
python manage.py createsuperuser
Inicia un servidor web local:
python manage.py runserver
En tu navegador, ve a http://localhost:8000/admin.
Accede al sitio del administrador con el nombre de usuario y la contraseña que usaste cuando ejecutaste
createsuperuser
.
Implementar la app en el entorno estándar de App Engine
Con todos los servicios de copia de seguridad configurados y la aplicación probada localmente, ahora puedes implementar la app en el entorno estándar de App Engine:
- Para subir la app, ejecuta el siguiente comando, que la implementa como se describe en
app.yaml
y establece la versión recién implementada como la versión predeterminada, lo que hace que se entregue todo el tráfico nuevo:gcloud app deploy
- Escribe "yes" para confirmar la configuración. cuando se te solicite.
- Espera a que aparezca el mensaje que informa que la actualización se completó.
- Abre
app.yaml
y actualiza el valor deAPPENGINE_URL
con la URL implementada:... env_variables: APPENGINE_URL: https://PROJECT_ID.uc.r.appspot.com
- Sube los cambios de la configuración:
gcloud app deploy
Ejecuta la app implementada
Se implementó la app y ahora se puede acceder a ella:
Abre el sitio web implementado:
gcloud app browse
También puedes mostrar la URL y abrirla manualmente:
gcloud app describe --format "value(defaultHostname)"
Un servidor web que se ejecuta en el entorno estándar de App Engine entrega tu solicitud.
Actualizar la aplicación
Para actualizar tu aplicación, realiza cambios en el código y, luego, vuelve a ejecutar el comando gcloud app deploy
.
El objeto Deployment crea versión nueva de tu app y la promueve a la versión predeterminada. Las versiones anteriores de tu el contenido de la app. Todas estas versiones de la app son recursos facturables. Para reducir costos, borrar las versiones no predeterminadas de tu app.
Configuración para producción
Ahora tienes una implementación de Django en funcionamiento, pero hay más pasos que puedes seguir para asegurarte de que tu aplicación esté lista para la producción.
Inhabilita la depuración
Confirma que la variable DEBUG
en mysite/settings.py
esté configurada como False
. Esta
Esto evitará que se muestren al usuario páginas de error detalladas, que pueden filtrar información sobre la configuración.
Limita los privilegios del usuario de la base de datos
Todos los usuarios que se crean con Cloud SQL tienen los privilegios asociados al
Rol de cloudsqlsuperuser
:
CREATEROLE
, CREATEDB
y LOGIN
.
Para evitar que el usuario de la base de datos de Django tenga estos permisos, crea el usuario de forma manual en PostgreSQL. Deberás tener instalada la terminal interactiva de psql
o usar Cloud Shell, que tiene preinstalada esta herramienta.
Console
-
In the Google Cloud console, activate Cloud Shell.
En Cloud Shell, usa la terminal integrada para conectarte a tu instancia de
INSTANCE_NAME
:gcloud sql connect INSTANCE_NAME --user postgres
Ingresa la contraseña del usuario de postgres.
Ahora estás usando
psql
. Deberías ver el mensajepostgres=>
.Crear un usuario
CREATE USER DATABASE_USERNAME WITH PASSWORD 'DATABASE_PASSWORD';
Reemplaza
PASSWORD
por una contraseña única y aleatoria.Otorga todos los derechos sobre la base de datos nueva al usuario nuevo:
GRANT ALL PRIVILEGES ON DATABASE DATABASE_NAME TO DATABASE_USERNAME;
Salga de
psql
:\q
gcloud
Inicia una conexión a la instancia de SQL:
gcloud sql connect INSTANCE_NAME --user postgres
Reemplaza
INSTANCE_NAME
por la instancia de Cloud SQL que se creó.Ingresa la contraseña del usuario de postgres.
Ahora estás usando
psql
. Deberías ver el mensajepostgres=>
.Crear un usuario
CREATE USER DATABASE_USERNAME WITH PASSWORD 'DATABASE_PASSWORD';
Otorga todos los derechos sobre la base de datos nueva al usuario nuevo:
GRANT ALL PRIVILEGES ON DATABASE DATABASE_NAME TO DATABASE_USERNAME;
Salga de
psql
:\q
Examine el código
Aplicación de muestra
La app de muestra de Django se creó con las herramientas estándar de Django. Con los siguientes comandos, se crea el proyecto y la app de encuestas:
django-admin startproject mysite
python manage.py startapp polls
Las vistas básicas, los modelos y las configuraciones de ruta se copiaron de Escribe tu primera app de Django (Parte 1 y la Parte 2).
Secretos del Secret Manager
El archivo settings.py
contiene código que usa la API de Secret Manager para Python para recuperar la versión más reciente del secreto con nombre y extraerla al entorno (mediante django-environ
):
El Secret se usa para almacenar varios valores de Secrets y, así, reducir la cantidad de Secrets diferentes que se deben configurar.
Configuraciones de CSRF
Django tiene protección integrada contra la falsificación de solicitudes entre sitios (CSRF). A partir de Django 4.0, los cambios en la forma en que funciona esto significan que es importante decirle a Django cuál es su URL alojada, por lo que puede ofrecer la mejor protección a los usuarios que envían datos.
Debes proporcionar la URL de la app como una variable de entorno en el archivo settings.py
.
Este es el valor que Django usa para la configuración relevante.
Anulaciones de secretos locales
Si se encuentra un archivo .env
en el sistema de archivos local, se usa en lugar del valor de Secret Manager. La creación local de un archivo .env
puede ayudar con las pruebas locales (p.ej., el desarrollo local en una base de datos SQLite o alguna otra configuración local).
Conexión a base de datos
El archivo settings.py
contiene la configuración de tu base de datos de SQL: Usa el ayudante env.db()
.
de django-environ
para cargar la cadena de conexión establecida en DATABASE_URL
en la configuración DATABASES
.
Cuando ejecutes la aplicación de manera local y uses el proxy de autenticación de Cloud SQL para acceder a
base de datos alojada, la marca USE_CLOUD_SQL_AUTH_PROXY
ajusta la base de datos
para usar el proxy.
Contenido estático alojado
El app.yaml
contiene la información de configuración para la implementación en App Engine.
Este archivo app.yaml
especifica que App Engine entrega archivos estáticos desde el directorio static/
:
Cuando se ejecuta la app de manera local con DEBUG
habilitado, Django entrega estos archivos de forma local:
Limpia
Para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos usados en este instructivo, borra el proyecto que contiene los recursos o conserva el proyecto y borra los recursos individuales.
Borra el proyecto
- En la consola de Google Cloud, ve a la página Administrar recursos.
- En la lista de proyectos, elige el proyecto que quieres borrar y haz clic en Borrar.
- En el diálogo, escribe el ID del proyecto y, luego, haz clic en Cerrar para borrar el proyecto.
¿Qué sigue?
- Aprende a configurar PostgreSQL para la producción
- Obtén más información sobre Django en Google Cloud