s3 deploy website

Implante o site estático para S3/Cloudfront

Esta é uma ferramenta de implantação para fazer upload de sites estáticos para o S3. Se o CloudFront for usado para hospedar o site, os arquivos carregados poderão ser automaticamente invalidados na distribuição CloudFront. Uma árvore de prefixo é usada para minimizar o número de invalidações, pois apenas um número limitado de invalidações gratuitas está disponível por mês.

A configuração é armazenada em um arquivo YAML como este:

 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

O site é o diretório do site estático em relação à localização do arquivo de configuração. Por exemplo, Jekyll gerará o site estático no diretório _site , conforme especificado acima. Se você salvar o arquivo de configuração como .s3_website.yaml poderá simplesmente executar s3-deploy-website do mesmo diretório:

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

Credenciais

As credenciais da AWS podem ser fornecidas através das variáveis ​​de ambiente AWS_ACCESS_KEY_ID e AWS_SECRET_ACCESS_KEY .

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

Eles também podem ser fornecidos através dos vários arquivos de configuração que o BOTO lê.

Arquivo de configuração

site

O diretório do conteúdo estático a ser carregado (em relação à localização do arquivo de configuração (por exemplo, _site para Jekyll).

s3_bucket

O nome do balde S3 para fazer o upload dos arquivos. Você deve permitir que as ações s3:GetObject , s3:PutObject , s3:DeleteObject e s3:ListBucket no balde e as chaves, por exemplo, arn:aws:s3:::example.com e arn:aws:s3:::example.com/* .

S3_RedUDED_REDUNDANCE

Um booleano opcional para indicar se os arquivos devem ser carregados para reduzir o armazenamento de redundância.

Cloudfront_distribution_id

A distribuição do CloudFront para invalidar após o upload de novos arquivos. Somente arquivos que foram alterados serão invalidados. Você deve permitir o Action cloudfront:CreateInvalidation .

cache_rules

Uma lista de regras para determinar a configuração do cache dos arquivos carregados. A tecla match especifica um padrão ao qual a regra se aplica. Isso usa a correspondência no estilo global (com * e ? ). A correspondência também pode ser realizada com expressões regulares usando match_regexp . Somente a primeira regra a corresponder a uma determinada chave será usada. A tecla maxage especifica o tempo para armazenar em cache o arquivo. O valor deve ser um número de segundos ou uma corda como 30 days , 5 minutes, 30 seconds , etc.

endpoint_url

(Opcional) para definir o terminal personalizado para o BOTO3: Referência da sessão de BOTO3

Software semelhante

A configuração em .s3_website.yaml foi inspirada no s3_website, embora as opções suportadas pelo s3_website sejam um pouco diferentes.

Licença

Mit.