Initial docs infrastructure (#42)

* Initial docs infrastructure

* Use S3 website template instead

* Remove infrastructure folder

* Adjust pathing to use /sdk

* Fix up baseURL, don't use the cache for docs

* Bump deps, minor other things

* Refactor to use Nx, fix Ruby formatter, run format

* Add the docs:publish command to the README

* Add a preview task

* Actually add the project file

* Publish to /docs/sdk/*

---------

Co-authored-by: Christian Nunciato <chris@nunciato.org>

Author: Zack Chase

README.md

@@ -195,6 +195,9 @@ npm run format
 # Publish to npm, PyPi pkg.go.dev, and RubyGems.
 npm run publish
 
+# Publish the docs to AWS.
+npm run docs:publish
+
 # Clear away build and test artifacts.
 npm run clean
 ```

infra/.gitignore

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

infra/Pulumi.dev.yaml

@@ -0,0 +1,6 @@
+encryptionsalt: v1:e6xIDh3VRh0=:v1:uvEcWD8QmlguUQx4:o48Ij5bVvOeod2zeE+PyurjYXzd9lA==
+config:
+  aws:region: us-west-2
+  infra:errorDocument: error.html
+  infra:indexDocument: index.html
+  infra:path: ../dist/docs/publish

infra/Pulumi.yaml

@@ -0,0 +1,10 @@
+name: infra
+description: A TypeScript program to deploy a static website on AWS
+runtime:
+  name: nodejs
+  options:
+    packagemanager: npm
+config:
+  pulumi:tags:
+    value:
+      pulumi:template: static-website-aws-typescript

infra/index.ts

@@ -0,0 +1,110 @@
+import * as pulumi from "@pulumi/pulumi";
+import * as aws from "@pulumi/aws";
+import * as synced from "@pulumi/synced-folder";
+
+const config = new pulumi.Config();
+const path = config.require("path");
+const indexDocument = config.require("indexDocument");
+const errorDocument = config.require("errorDocument");
+
+// Create an S3 bucket to hold the docs.
+const bucket = new aws.s3.BucketV2("bucket");
+const bucketWebsite = new aws.s3.BucketWebsiteConfigurationV2(
+    "bucket-website",
+    {
+        bucket: bucket.bucket,
+        indexDocument: { suffix: indexDocument },
+        errorDocument: { key: errorDocument },
+    }
+);
+
+// Configure ownership controls for the bucket.
+const ownershipControls = new aws.s3.BucketOwnershipControls(
+    "ownership-controls",
+    {
+        bucket: bucket.bucket,
+        rule: {
+            objectOwnership: "ObjectWriter",
+        },
+    }
+);
+
+// Configure a public access block for the bucket.
+const publicAccessBlock = new aws.s3.BucketPublicAccessBlock(
+    "public-access-block",
+    {
+        bucket: bucket.bucket,
+        blockPublicAcls: false,
+    }
+);
+
+// Use a synced folder to manage the files of the website.
+new synced.S3BucketFolder(
+    "bucket-folder",
+    {
+        path: path,
+        bucketName: bucket.bucket,
+        acl: "public-read",
+        managedObjects: false,
+    },
+    { dependsOn: [ownershipControls, publicAccessBlock] }
+);
+
+// Create a CloudFront CDN to distribute and cache the website.
+const tenMinutes = 60 * 10;
+const cdn = new aws.cloudfront.Distribution("cdn", {
+    enabled: true,
+    origins: [
+        {
+            originId: bucket.arn,
+            domainName: bucketWebsite.websiteEndpoint,
+            customOriginConfig: {
+                originProtocolPolicy: "http-only",
+                httpPort: 80,
+                httpsPort: 443,
+                originSslProtocols: ["TLSv1.2"],
+            },
+        },
+    ],
+    defaultCacheBehavior: {
+        targetOriginId: bucket.arn,
+        viewerProtocolPolicy: "redirect-to-https",
+        allowedMethods: ["GET", "HEAD", "OPTIONS"],
+        cachedMethods: ["GET", "HEAD", "OPTIONS"],
+        defaultTtl: tenMinutes,
+        maxTtl: tenMinutes,
+        minTtl: tenMinutes,
+        forwardedValues: {
+            queryString: false,
+            cookies: {
+                forward: "none",
+            },
+        },
+    },
+    customErrorResponses: [
+        {
+            errorCode: 404,
+            responseCode: 404,
+            responsePagePath: `/${errorDocument}`,
+        },
+    ],
+    restrictions: {
+        geoRestriction: {
+            restrictionType: "none",
+        },
+    },
+    viewerCertificate: {
+        cloudfrontDefaultCertificate: true,
+    },
+});
+
+// Export relevant URLs and hostnames.
+export const bucketName = bucket.bucket;
+export const bucketURI = pulumi.interpolate`s3://${bucket.bucket}`;
+export const originURL = pulumi.interpolate`http://${bucketWebsite.websiteEndpoint}`;
+export const originHostname = bucketWebsite.websiteEndpoint;
+export const cdnURL = pulumi.interpolate`https://${cdn.domainName}`;
+export const cdnHostname = cdn.domainName;
+export const typescriptDocsURL = pulumi.interpolate`https://${cdn.domainName}/docs/sdk/typescript`;
+export const pythonDocsURL = pulumi.interpolate`https://${cdn.domainName}/docs/sdk/python`;
+export const rubyDocsURL = pulumi.interpolate`https://${cdn.domainName}/docs/sdk/ruby`;