s3 site cache optimizer

оптимизатор s3-кэша сайта

Оптимизируйте статический веб-сайт для размещения в S3, включив отпечаток пальца в имена файлов всех ресурсов. Оптимизированный веб-сайт загружается в указанную корзину S3 с правильными заголовками кэша.

Установка

Вы можете установить стабильную версию, используя следующую команду pip:

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

Если вы хотите быть в курсе новейших функций, установите версию для разработки:

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

Операция

Инструмент командной строки выполняет следующие шаги:

1. Проиндексируйте (локальный) исходный каталог, содержащий статический веб-сайт, и выполните поиск ресурсов и перезаписываемых объектов .
2. Вычислите хэш содержимого каждого актива и переименуйте его, используя хэш файла в имени файла.
3. Найдите в содержимом перезаписываемых файлов ссылки на каждый из ресурсов и при необходимости перепишите URL-адреса.
4. (необязательно) Gzip все текстовые файлы.
5. (необязательно) Загрузите все файлы по пути в корзине S3 и удалите все остальные файлы по этому пути. Ресурсам присваивается заголовок кэша с неограниченным сроком действия, чтобы оптимизировать кеширование браузера и прокси-сервера.

Все файловые операции выполняются во (временном) выходном каталоге, исходный каталог не изменяется.

Ресурсы и перезаписываемые объекты распознаются по расширению их файлов. В настоящее время следующие расширения файлов считаются активами :

• CSS
• SVG
• ТТФ
• уфф
• woff2
• отф
• еот
• png
• jpg
• JPEG
• гифка
• js
• xml
• mp4
• вебм
• веб-сайт

Перезаписываемые файлы — это текстовые файлы с одним из следующих расширений:

• HTML
• хм
• js
• CSS
• xml
• JSON

Отправьте запрос на добавление функции, если вы хотите, чтобы были добавлены другие расширения файлов.

Использование

 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.

Пример

 $ 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"

Лицензия

Оптимизатор s3-site-cache-optimizer выпускается под лицензией MIT.