Add aws-native S3 folder example (pulumi#1085)

aws-native-ts-s3-folder/.gitignore

@@ -0,0 +1,2 @@
+/bin/
+/node_modules/

aws-native-ts-s3-folder/Pulumi.yaml

@@ -0,0 +1,3 @@
+name: aws-native-ts-s3-folder
+runtime: nodejs
+description: A static website hosted on AWS S3

aws-native-ts-s3-folder/README.md

@@ -0,0 +1,94 @@
+[![Deploy](https://get.pulumi.com/new/button.svg)](https://app.pulumi.com/new)
+
+# Host a Static Website on Amazon S3
+
+A static website that uses [S3's website support](https://docs.aws.amazon.com/AmazonS3/latest/dev/WebsiteHosting.html).
+For a detailed walkthrough of this example, see the tutorial [Static Website on AWS S3](https://www.pulumi.com/docs/tutorials/aws/s3-website/).
+
+Note: Some of the 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.  Create a new stack:
+
+    ```bash
+    $ pulumi stack init dev
+    ```
+
+1.  Set the AWS region:
+
+    Either using an environment variable
+    ```bash
+    $ export AWS_REGION=us-west-2
+    ```
+
+    Or with the stack config
+    ```bash
+    $ pulumi config set aws:region us-west-2
+    $ pulumi config set aws-native:region us-west-2
+    ```
+
+1.  Restore NPM modules via `npm install` or `yarn install`.
+
+1.  Run `pulumi up` to preview and deploy changes.  After the preview is shown you will be
+    prompted if you want to continue or not.
+
+    ```bash
+    $ 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: ***
+    ```
+
+1.  To see the resources that were created, run `pulumi stack output`:
+
+    ```bash
+    $ pulumi stack output
+    Current stack outputs (2):
+    OUTPUT      VALUE
+    bucketName  ***
+    websiteUrl  http://***.s3-website-us-west-2.amazonaws.com
+    ```
+
+1.  To see that the S3 objects exist, you can either use the AWS Console or the AWS CLI:
+
+    ```bash
+    $ 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    
+    ```
+
+1.  Open the site URL in a browser to see both the rendered HTML and the favicon:
+
+    ```bash
+    $ pulumi stack output websiteUrl
+    ***.s3-website-us-west-2.amazonaws.com
+    ```
+
+    ![Hello S3 example](https://user-images.githubusercontent.com/274700/116912066-9384e300-abfc-11eb-8130-dbcff512a9de.png)
+
+1.  To clean up resources, run `pulumi destroy` and answer the confirmation question at the prompt.

aws-native-ts-s3-folder/index.ts

@@ -0,0 +1,48 @@
+// Copyright 2016-2021, Pulumi Corporation.
+
+import * as aws from "@pulumi/aws";
+import * as awsnative from "@pulumi/aws-native";
+import * as pulumi from "@pulumi/pulumi";
+import * as fs from 'fs';
+import * as mime from "mime";
+
+// Create a bucket and expose a website index document
+const siteBucket = new awsnative.s3.Bucket("s3-website-bucket", {
+    websiteConfiguration: {
+        indexDocument: "index.html",
+    },
+});
+
+const siteDir = "www"; // directory for content files
+
+// For each file in the directory, create an S3 object stored in `siteBucket`
+for (const item of fs.readdirSync(siteDir)) {
+    const filePath = require("path").join(siteDir, item);
+    const siteObject = new aws.s3.BucketObject(item, {
+        bucket: siteBucket.id,                            // reference the s3.Bucket object
+        source: new pulumi.asset.FileAsset(filePath),     // use FileAsset to point to a file
+        contentType: mime.getType(filePath) || undefined, // set the MIME type of the file
+    });
+}
+
+// Set the access policy for the bucket so all objects are readable
+const bucketPolicy = new aws.s3.BucketPolicy("bucketPolicy", {
+    bucket: siteBucket.id, // refer to the bucket created earlier
+    policy: siteBucket.arn.apply(bucketArn => JSON.stringify({
+        Version: "2012-10-17",
+        Statement: [{
+            Effect: "Allow",
+            Principal: "*",
+            Action: [
+                "s3:GetObject",
+            ],
+            Resource: [
+                `${bucketArn}/*`, //
+            ],
+        }],
+    })),
+});
+
+// Stack exports
+export const bucketName = siteBucket.bucketName;
+export const websiteUrl = siteBucket.websiteURL;

aws-native-ts-s3-folder/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "aws-native-ts-s3-bucket",
+  "devDependencies": {
+    "@types/node": "^8.0.0"
+  },
+  "dependencies": {
+    "@pulumi/pulumi": "^3.0.0",
+    "@pulumi/aws": "^4.0.0",
+    "@pulumi/aws-native": "^0.1.0",
+    "@types/mime": "^2.0.3",
+    "mime": "^2.5.2"
+  }
+}

aws-native-ts-s3-folder/tsconfig.json

@@ -0,0 +1,18 @@
+{
+    "compilerOptions": {
+        "strict": true,
+        "outDir": "bin",
+        "target": "es2016",
+        "module": "commonjs",
+        "moduleResolution": "node",
+        "sourceMap": true,
+        "experimentalDecorators": true,
+        "pretty": true,
+        "noFallthroughCasesInSwitch": true,
+        "noImplicitReturns": true,
+        "forceConsistentCasingInFileNames": true
+    },
+    "files": [
+        "index.ts"
+    ]
+}

aws-native-ts-s3-folder/www/index.html

@@ -0,0 +1,7 @@
+<html>
+    <head><meta charset="UTF-8">
+    <title>Hello, Pulumi!</title></head>
+<body>
+    <p>Hello, S3!</p>
+    <p>Made with ❤️ with <a href="https://pulumi.com">Pulumi</a></p>
+</body></html>