Add component version of S3 Website example

aws-js-s3-folder-component/Pulumi.yaml

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

aws-js-s3-folder-component/README.md

@@ -0,0 +1,74 @@
+# Static Website Hosted on AWS S3
+
+The component version of [aws-js-s3-folder](../aws-js-s3-folder). For a detailed walkthrough of this example, see [Part 2 of the Pulumi quickstart](https://docs.pulumi.com/quickstart/part2.html).
+
+## Deploying and running the program
+
+1. Initialize a Pulumi repository with `pulumi init`, using your GitHub username. (Note: this step will be removed in the future.)
+
+ ```bash
+ $ pulumi init --owner githubUsername
+ ```
+
+1. Create a new stack:
+
+ ```bash
+ $ pulumi stack init website-testing
+ ```
+
+1. Set the AWS region:
+
+ ```
+ $ pulumi config set aws:region us-west-2
+ ```
+
+1. Restore NPM modules via `npm install`.
+
+1. Run `pulumi preview` to see what AWS resources will be created.
+
+1. Now, provision resources via `pulumi update`:
+
+ ```bash
+ $ pulumi update
+ Updating stack 's3foldercomponent-testing' in the Pulumi Cloud ☁️
+ Performing changes:
+
+ pulumi:Stack("aws-js-s3-folder-component-s3foldercomponent-testing"): Completed
+ examples:S3Folder("pulumi-static-site"): + Created
+ aws:Bucket("pulumi-static-site"): + Created
+ aws:BucketPolicy("bucketPolicy"): + Created
+ aws:BucketObject("favicon.png"): + Created
+ aws:BucketObject("index.html"): + Created
+ info: 6 changes performed:
+ + 6 resources created
+ Update duration: 6.952010989s
+
+ Permalink: https://pulumi.com/lindydonna/examples/aws-js-s3-folder-component/s3foldercomponent-testing/updates/3
+ ```
+
+1. To see the resources that were created, run `pulumi stack output`:
+
+ ```bash
+ $ pulumi stack output
+ Current stack outputs (2):
+ OUTPUT VALUE
+ bucketName s3-website-bucket-e7c0411
+ websiteUrl s3-website-bucket-e7c0411.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)
+ 2018-04-17 15:40:47 13731 favicon.png
+ 2018-04-17 15:40:48 249 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-bucket-8533d8b.s3-website-us-west-2.amazonaws.com
+ ```
+
+

aws-js-s3-folder-component/index.js

@@ -0,0 +1,8 @@
+const s3folder = require("./s3folder.js");
+
+// Create an instance of the S3Folder component
+let folder = new s3folder.S3Folder("pulumi-static-site", "./www");
+
+// Export `folder` output properties as stack outputs
+exports.bucketName = folder.bucketName;
+exports.websiteUrl = folder.websiteUrl; 

aws-js-s3-folder-component/package.json

@@ -0,0 +1,9 @@
+{
+ "name": "aws-js-s3-folder-component",
+ "main": "index.js",
+ "dependencies": {
+ "@pulumi/aws": "^0.11.0",
+ "@pulumi/pulumi": "^0.11.0",
+ "mime": "^2.2.2"
+ }
+}

aws-js-s3-folder-component/s3folder.js

@@ -0,0 +1,63 @@
+"use strict";
+
+const aws = require("@pulumi/aws");
+const pulumi = require("@pulumi/pulumi");
+const mime = require("mime");
+
+// Define a component for serving a static website on S3
+class S3Folder extends pulumi.ComponentResource {
+
+ constructor(bucketName, path, opts) {
+ super("examples:S3Folder", bucketName, {}, opts); // Register this component with name examples:S3Folder
+
+ // Create a bucket and expose a website index document
+ let siteBucket = new aws.s3.Bucket(bucketName, {
+ websites: [{
+ indexDocument: "index.html",
+ }],
+ }, { parent: this }); // specify resource parent
+
+ // For each file in the directory, create an S3 object stored in `siteBucket`
+ for (let item of require("fs").readdirSync(path)) {
+ let filePath = require("path").join(path, item);
+ let object = new aws.s3.BucketObject(item, { 
+ bucket: siteBucket, // 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
+ }, { parent: this }); // specify resource parent
+ }
+
+ // Set the access policy for the bucket so all objects are readable
+ let bucketPolicy = new aws.s3.BucketPolicy("bucketPolicy", {
+ bucket: siteBucket.bucket,
+ policy: siteBucket.bucket.apply(this.publicReadPolicyForBucket),
+ }, { parent: this }); // specify resource parent
+
+ this.bucketName = siteBucket.bucket,
+ this.websiteUrl = siteBucket.websiteEndpoint,
+
+ // Register output properties for this component
+ this.registerOutputs({
+ bucketName: this.bucketName,
+ websiteUrl: this.websiteEndpoint,
+ });
+ }
+
+ publicReadPolicyForBucket(bucketName) {
+ return JSON.stringify({
+ Version: "2012-10-17",
+ Statement: [{
+ Effect: "Allow",
+ Principal: "*",
+ Action: [
+ "s3:GetObject"
+ ],
+ Resource: [
+ `arn:aws:s3:::${bucketName}/*` // policy refers to bucket name explicitly
+ ]
+ }]
+ });
+ } 
+}
+
+module.exports.S3Folder = S3Folder;

aws-js-s3-folder-component/www/index.html

@@ -0,0 +1,6 @@
+<html><head>
+ <title>Hello S3</title><meta charset="UTF-8">
+ <link rel="shortcut icon" href="/favicon.png" type="image/png">
+</head>
+<body><p>Hello, world!</p><p>Made with ❤️ with <a href="https://pulumi.com">Pulumi</a></p>
+</body></html>

aws-js-s3-folder/README.md

@@ -13,7 +13,7 @@ A static website that uses [S3's website support](https://docs.aws.amazon.com/Am
 1. Create a new stack:
 
  ```bash
- $ pulumi stack init website-testing`
+ $ pulumi stack init website-testing
  ```
 
 1. Set the AWS region: