s3 site cache optimizer

optimizador-de-cache-del-sitio-s3

Optimice un sitio web estático para alojarlo en S3, incluyendo una huella digital en los nombres de archivos de todos los activos. El sitio web optimizado se carga en el depósito S3 especificado con los encabezados de caché correctos.

Instalación

Puede instalar la versión estable usando el siguiente comando pip:

 pip install --upgrade s3-site-cache-optimizer

Si desea mantenerse al día con las últimas funciones, instale la versión de desarrollo:

 pip install --upgrade https://github.com/novemberfiveco/s3-site-cache-optimizer/archive/develop.zip

Operación

La herramienta de línea de comando ejecuta los siguientes pasos:

1. Indexe el directorio de origen (local) que contiene el sitio web estático y busque activos y regrabables .
2. Calcule un hash a partir del contenido de cada activo y cámbiele el nombre con el filehash en el nombre del archivo.
3. Busque en el contenido de los reescribibles referencias a cada uno de los activos y reescriba las URL si es necesario.
4. (opcional) Comprima todos los archivos basados ​​en texto.
5. (opcional) Cargue todos los archivos en una ruta en un depósito de S3 y elimine todos los demás archivos de esa ruta. Los activos reciben un encabezado de caché que nunca caduca para optimizar el almacenamiento en caché del navegador y del proxy.

Todas las operaciones con archivos se ejecutan en un directorio de salida (temporal), el directorio de origen no se modifica.

Los activos y reescribibles se reconocen según su extensión de archivo. Actualmente, las siguientes extensiones de archivo se consideran activos :

• CSS
• svg
• ttf
• guau
• woff2
• otf
• eot
• png
• jpg
• jpeg
• gif
• js
• XML
• mp4
• webm
• webp

Los regrabables son archivos de texto con una de las siguientes extensiones:

• HTML
• htm
• js
• CSS
• XML
• json

Presente una solicitud de función si desea que se agreguen otras extensiones de archivo.

Uso

 usage: s3-site-cache-optimizer [-h] [--debug] [--version]
                               [--exclude PATTERN [PATTERN ...]]
                               [-o OUTPUT_DIR]
                               [--access-key AWS_ACCESS_KEY_ID]
                               [--secret-key AWS_SECRET_ACCESS_KEY]
                               [--region REGION]
                               [--gzip]
                               [--prefix PREFIX]
                               [--domains DOMAIN [DOMAIN ...]]
                               [--skip-s3-upload]
                               source_dir destination_bucket

positional arguments:
  source_dir            Local directory containing a static website.
  destination_bucket    S3 bucket name.

optional arguments:
  -h, --help            show this help message and exit
  --debug               Enable debug output
  --version             show program's version number and exit
  --exclude PATTERN [PATTERN ...]
                        Exclude files and directories matching these patterns.
  -o OUTPUT_DIR, --output OUTPUT_DIR
                        Output directory in which local files are written.
                        When absent a temporary directory is created and used.
  --access-key AWS_ACCESS_KEY_ID
                        AWS access key. If this field is not specified,
                        credentials from environment or credentials files will
                        be used.
  --secret-key AWS_SECRET_ACCESS_KEY
                        AWS access secret. If this field is not specified,
                        credentials from environment or credentials files will
                        be used.
  --region REGION       AWS region to connect to.
  --gzip                Gzip text-based files.
  --prefix PREFIX       Subdirectory in which files are stored in the bucket.
                        Stored in the root of the bucket by default.
  --domains DOMAIN [DOMAIN ...]
                        Domain names on which the site will be hosted.
  --skip-s3-upload      Skip uploading to S3.

Ejemplo

 $ s3-site-cache-optimizer ~/srv/www.example.com www.example.com --access-key XXXXXNOVEMBERFIVEXXXXX --secret-key XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
$ s3-site-cache-optimizer ~/srv/www.example.com www.example.com --exclude ".git/*" ".git*" --region eu-west-1
$ s3-site-cache-optimizer ~/srv/www.example.com www.example.com --output ~/srv/example-optimized/ --skip-s3-upload
$ s3-site-cache-optimizer ~/srv/www.example.com my_bucket --domains www.example.com example.com --prefix "user/sites/www.example.com"

Licencia

El optimizador de caché del sitio s3 se publica bajo la licencia MIT.