Nosferatu's Pace Maker

    @pulumi/aws-static-website
    TypeScript icon, indicating that this package has built-in type declarations

    0.3.0 • Public • Published

    Pulumi AWS Static Website Component

    This component makes it easy to deploy a static website to s3 along with an optional CloudFront distribution using any of the supported Pulumi programming languages including markup languages like YAML and JSON.

    Example Usage

    Simple (only s3 bucket)

    TypeScript:

    const site = new staticwebsite.Website("website", {sitePath: "../website/build"});
    
    export const url = site.websiteURL;

    YAML:

    resources:
      web:
        type: "aws-static-website:index:Website"
        properties:
          sitePath: "../website/build"
    outputs:
      websiteURL: ${web.websiteURL}

    With CloudFront CDN

    TypeScript:

    const site = new staticwebsite.Website("website", {
        withCDN: true,
        sitePath: "../website/build",
        targetDomain: "my-awesome-site.com",
        withLogs: true,
        cacheTTL: 600,
    });
    
    export const url = site.websiteURL;

    YAML:

    resources:
      web:
        type: "aws-static-website:index:Website"
        properties:
          withCDN: true
          sitePath: "../website/build"
          targetDomain: "my-awesome-site.com"
          withLogs: true
          cacheTTL: 600
    outputs:
      websiteURL: ${web.websiteURL}

    See the examples directory for fully working examples of how to consume this component.

    Installation

    If you are new to Pulumi and do not yet have our Pulumi installed, see our getting started guide to get up and running.

    Install the SDK package corresponding to the language or runtime you are using. If using YAML or one of our other markup languages, this step can be skipped.

    NodeJS

    npm install @pulumi/aws-static-website
    

    Python

    pip3 install pulumi_aws_static_website
    

    Go

    go get -t github.com/pulumi/pulumi-aws-static-website/sdk/go/aws-static-website
    

    This package can then be consumed just like any other package by importing it into your project (e.g. import * as website from '@pulumi/aws-static-website')

    Input Properties

    This component takes the following inputs.

    • sitePath (string) - the root directory containing the website's contents to be served (required)
    • withCDN (boolean) - provision a CloudFront CDN to serve content
    • targetDomain (string) - the domain used to serve the content. A Route53 hosted zone must exist for this domain is this option is specified
    • index.html (string) - the default document for the site. Defaults to index.html
    • error404 (string) - the default 404 error page
    • certificateARN (string) - the ARN of the ACM certificate to use for serving HTTPS. If one is not provided, a certificate will be created during the provisioning process
    • cacheTTL (number) - TTL in seconds for cached objects
    • withLogs (boolean) - provision a bucket to house access logs
    • priceClass (string) - The price class to use for the CloudFront configuration. Defaults to 100 if not specified. Valid values are all, 100, and 200"

    Outputs

    • bucketName - the name of the s3 bucket containing the website's contents
    • bucketWebsiteURL - the website URL for the s3 bucket
    • cdnDomainName - the CDN domain name
    • cdnURL - the CDN's endpoint URL
    • logsBucketName - the name of the s3 bucket containing the access logs
    • websiteURL - the URL to access the website

    Notes:

    • If specifying a target domain and provisioning a CloudFront distribution, it is assumed there is a hosted zone configured in route53 for that target domain.
    • If you already have an ACM certificate provisioned for your domain, then you can simply pass the ARN as one of the input properties. If not we will attempt to provision one for you based on the target domain provided.

    Install

    npm i @pulumi/aws-static-website

    Homepage

    pulumi.com

    DownloadsWeekly Downloads

    55

    Version

    0.3.0

    License

    none

    Unpacked Size

    38.6 kB

    Total Files

    25

    Last publish

    Collaborators

    • joeduffy
    • pulumi-bot