s3 deploy website

將靜態網站部署到S3/CloudFront

這是用於將靜態網站上傳到S3的部署工具。如果使用CloudFront用於託管網站，則可以在CloudFront Distribution中自動無效上傳的文件。前綴樹用於最大程度地減少無效的數量，因為每月只有有限數量的免費無效。

該配置存儲在這樣的YAML文件中：

 site : _site
s3_bucket : example.com
cloudfront_distribution_id : XXXXXXXXXXX

cache_rules :
  - match : " /assets/* "
    maxage : 30 days

  - match_regexp : ' ^assets/image-d{3}-.*.png$ '
    maxage : 90 days

  - match : " /css/* "
    maxage : 30 days

  - match : " * "
    maxage : 1 hour

該site是靜態網站的目錄，相對於配置文件的位置。例如，Jekyll將在_site目錄中生成靜態站點，如上所述。如果將配置文件保存為.s3_website.yaml則可以簡單地從同一目錄運行s3-deploy-website ：

$ cd jekyll-site/
$ ls .s3_website.yaml
.s3_website.yaml
$ s3-deploy-website

證書

可以通過環境變量AWS_ACCESS_KEY_ID和AWS_SECRET_ACCESS_KEY提供AWS憑據。

$ export AWS_ACCESS_KEY_ID=XXXXXX
$ export AWS_SECRET_ACCESS_KEY=XXXXXX
$ s3-deploy-website

也可以通過BOTO讀取的各種配置文件提供它們。

配置文件

地點

要上傳的靜態內容的目錄（相對於配置文件的位置（例如，jekyll站點的_site ）。

s3_bucket

S3存儲桶的名稱將文件上傳到上傳。您必須允許操作s3:GetObject ， s3:PutObject ， s3:DeleteObject和s3:ListBucket和鍵，例如arn:aws:s3:::example.com and and arn:aws:s3:::example.com/* 。

s3_reduced_redundancy

可選的布爾值，以指示是否應將文件上傳到減少冗餘存儲。

cloudfront_distribution_id

上載新文件後，雲方向發行無效。只有更改的文件將無效。您必須允許動作cloudfront:CreateInvalidation 。

cache_rules

確定上載文件的緩存配置的規則列表。 match鍵指定規則適用的模式。這使用球形匹配（與*和? ）。也可以使用match_regexp使用正則表達式執行匹配。僅使用匹配給定鍵的第一個規則。 maxage密鑰指定了緩存文件的時間。該值應為秒或弦，例如30 days ， 5 minutes, 30 seconds ，等等。

endpoint_url

（可選）設置boto3的自定義端點：boto3會話參考

類似的軟件

.s3_website.yaml中的配置受S3_website的啟發，儘管S3_website支持的選項略有不同。

執照

麻省理工學院。