Host a Static Website on Amazon S3 with the AWS Native Provider

This example lives in the pulumi/examples repository. Check out just this directory to use it:

$ git clone --filter=blob:none --sparse https://github.com/pulumi/examples pulumi-examples
$ git -C pulumi-examples sparse-checkout set aws-yaml-static-website
$ cd pulumi-examples/aws-yaml-static-website

A static website that uses S3’s website support. For a detailed walkthrough of this example, see the tutorial Static Website on AWS S3.

Note: Some resources are not yet supported by the Native AWS provider, so we are using both the Native and Classic provider in this example. The resources will be updated to use native resources as they are available in AWS’s Cloud Control API.

Deploying and running the program#

Note: some values in this example will be different from run to run. These values are indicated with ***.

1. Install required plugins:

   $ pulumi plugin install resource aws 4.37.3
   $ pulumi plugin install resource aws-native 0.11.0

2. Create a new stack:

   $ pulumi stack init dev

3. Set the AWS region:

   Either using an environment variable

   $ export AWS_REGION=us-west-2

   Or with the stack config

   $ pulumi config set aws:region us-west-2
   $ pulumi config set aws-native:region us-west-2

4. Run pulumi up to preview and deploy changes. After the preview is shown you will be prompted if you want to continue or not.

   $ pulumi up
   Previewing update (dev)
   ...
   
   Updating (dev)
   
   View Live: https://app.pulumi.com/***/aws-native-ts-s3-folder/dev/updates/1
   
        Type                     Name                         Status
   +   pulumi:pulumi:Stack      aws-native-ts-s3-folder-dev  created
   +   ├─ aws-native:s3:Bucket  s3-website-bucket            created
   +   ├─ aws:s3:BucketPolicy   bucketPolicy                 created
   +   ├─ aws:s3:BucketObject   index.html                   created
   +   └─ aws:s3:BucketObject   favicon.png                  created
   
   Outputs:
   bucketName: "***"
   websiteUrl: "http://***.s3-website-us-west-2.amazonaws.com"
   
   Resources:
   + 5 created
   
   Duration: ***

5. To see the resources that were created, run pulumi stack output:

   $ pulumi stack output
   Current stack outputs (2):
   OUTPUT      VALUE
   bucketName  ***
   websiteUrl  http://***.s3-website-us-west-2.amazonaws.com

6. To see that the S3 objects exist, you can either use the AWS Console or the AWS CLI:

   $ aws s3 ls $(pulumi stack output bucketName)
   2021-09-30 15:27:58      13731 favicon.png
   2021-09-30 15:27:58        198 index.html

7. Open the site URL in a browser to see both the rendered HTML and the favicon:

   $ pulumi stack output websiteUrl
   ***.s3-website-us-west-2.amazonaws.com

   

8. To clean up resources, run pulumi destroy and answer the confirmation question at the prompt.