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
• ttf
• 와우
• 워프2
• otf
• 어
• png
• jpg
• JPEG
• gif
• JS
• xml
• mp4
• 웹
• 웹

재기록 파일 은 다음 확장자 중 하나를 가진 텍스트 기반 파일입니다.

• HTML
• htm
• 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 라이선스에 따라 출시됩니다.