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支持的选项略有不同。

执照

麻省理工学院。