Entrega archivos estáticos

A menudo las aplicaciones necesitan entregar archivos estáticos, como JavaScript, imágenes y CSS, además de controlar solicitudes dinámicas. Las apps en el entorno flexible pueden entregar archivos estáticos desde una opción de Google Cloud, como Cloud Storage, entregarlos directamente o usar una red de distribución de contenidos (CDN) de terceros.

Entrega archivos desde Cloud Storage

Cloud Storage puede alojar elementos estáticos para aplicaciones web dinámicas. Estos son algunos de los beneficios de entregarlos desde Cloud Storage en lugar de hacerlo desde tu aplicación:

  • Cloud Storage funciona básicamente como una red de distribución de contenidos. No requiere configuraciones especiales gracias a que, según la configuración predeterminada, cualquier objeto público de lectura se almacena en caché en la red global de Cloud Storage.
  • La carga de tu aplicación se aligerará porque Cloud Storage se encargará de la entrega de elementos estáticos. Según la cantidad de elementos estáticos que tengas y la frecuencia de acceso, esto puede reducir en gran medida el costo por ejecutar tu app.
  • Los cargos de ancho de banda por acceder a contenido a menudo pueden ser menores con Cloud Storage.

Puedes subir tus elementos a Cloud Storage mediante la herramienta de línea de comandos de gsutil o la API de Cloud Storage.

La biblioteca cliente de Google Cloud proporciona un cliente idiomático de Python a Cloud Storage para almacenar y recuperar datos con Cloud Storage en una app de App Engine.

Ejemplo de entrega desde un bucket de Cloud Storage

En este ejemplo simple se muestra cómo crear un bucket de Cloud Storage y subir elementos estáticos mediante Google Cloud CLI:

  1. Crea un bucket. Es común, pero no obligatorio, nombrar al bucket según el ID del proyecto. Debe tener un nombre único a nivel global.

    gsutil mb gs://<your-bucket-name>

  2. Configura la LCA para otorgar acceso de lectura a los elementos del bucket.

    gsutil defacl set public-read gs://<your-bucket-name>

  3. Sube elementos al bucket. El comando rsync suele ser la forma más rápida y fácil de subir y actualizar elementos. También puedes usar cp.

    gsutil -m rsync -r ./static gs://<your-bucket-name>/static

Ahora puedes acceder a los elementos estáticos a través de https://storage.googleapis.com/<your-bucket-name>/static/....

Para obtener más detalles sobre cómo entregar elementos estáticos, incluso cómo entregarlos desde un nombre de dominio personalizado con Cloud Storage, consulta Cómo alojar un sitio web estático.

Entrega archivos desde otros servicios de Google Cloud

También tienes la opción de usar Cloud CDN o algún otro servicio de almacenamiento de Google Cloud.

Entrega archivos directamente desde la app

Generalmente, la entrega de archivos desde tu aplicación resulta simple. Sin embargo, existen algunas desventajas, por lo que debes tener en cuenta lo siguiente:

  • Para las solicitudes de archivos estáticos, se usan recursos que deberían usarse con solicitudes dinámicas.
  • En función de tu configuración, puede que la entrega de archivos desde tu aplicación ocasione una latencia de respuesta y genere problemas cuando se creen instancias nuevas de control de cargas.

Ejemplo de entrega de archivos estáticos con tu app

La mayoría de los frameworks web incluyen asistencia para entregar archivos estáticos. En este ejemplo, la app usa la función incorporada de Flask para entregar archivos en el directorio ./static desde la URL /static.

La aplicación incluye una vista que procesa la plantilla. De forma automática, Flask entrega todo en el directorio ./static sin configuración adicional.

appengine/flexible/static_files/main.py 
import logging

from flask import Flask, render_template

app = Flask(__name__)

@app.route('/')
def hello():
    return render_template('index.html')

@app.errorhandler(500)
def server_error(e):
    logging.exception('An error occurred during a request.')
    return """
    An internal error occurred: <pre>{}</pre>
    See logs for full stacktrace.
    """.format(e), 500

if __name__ == '__main__':
    # This is used when running locally. Gunicorn is used to run the
    # application on Google App Engine. See entrypoint in app.yaml.
    app.run(host='127.0.0.1', port=8080, debug=True)

La plantilla que la vista procesa incluye una hoja de estilo ubicada en /static/main.css.

appengine/flexible/static_files/templates/index.html 
<!doctype html>
<html>
<head>
  <title>Static Files</title>
  <!--
  Flask automatically makes files in the 'static' directory available via
  '/static'.
  -->
  <link rel="stylesheet" type="text/css" href="/static/main.css">
</head>
<body>
  <p>This is a static file serving example.</p>
</body>
</html>

La hoja de estilo se encuentra en ./static/main.css.

appengine/flexible/static_files/static/main.css 
body {
  font-family: Verdana, Helvetica, sans-serif;
  background-color: #CCCCFF;
}

Otros frameworks de Python, como Django, Pyramid y Bottle, suelen admitir la entrega de archivos estáticos directamente desde la app. Consulta su documentación para obtener detalles sobre cómo configurar y usar el contenido estático.

Entrega archivos desde una red de distribución de contenidos de terceros

Puedes utilizar cualquier CDN externa de terceros para entregar tus archivos estáticos y almacenar las solicitudes dinámicas en caché, aunque tu app podría experimentar un aumento de latencia y costo.

Para un mejor rendimiento, usa una CDN de terceros compatible con CDN Interconnect.