Hugo on agh1973

Projen

Sat, 22 May 2021 00:00:00 +0000

Introduction Link to heading

One of the things that’s worth noting about the hugo-cdk project is how much, well… boilerplate is involved.

We have:

.gitignore
.npmignore
.prettierrc.js
jest.config.js
package-lock.json
package.json
tsconfig.json

And none of these are really central to the actual project code. And… they’re also pretty important files. Which… I don’t really understand as well as I’d like to. For example, I’d like to do a really great job of linting, but I don’t want to spend a bunch of time learning the intricacies of eslint. Surely there must be a better way than googling around the interwebs for someone else’s configs?

Deploying a Static Site on AWS with CDK

Wed, 02 Dec 2020 00:00:00 +0000

Introduction Link to heading

We’ve covered a bunch of other ground, but now it’s time to actually deploy the static site.

A Static Site Link to heading

Referring back to our diagram, it’s clear that the first thing after the CodeBuild, which we are doing separately, is an S3 bucket.

export class StaticSite extends cdk.Construct {
 constructor(scope: cdk.Construct, id: string) {
 super(scope, id);

 const bucket = new s3.Bucket(this, 'Bucket', {});
 }
}

This gets our first layer of boiler-plate out of the way. We’ve declared StaticSite as a class and based it on the cdk.Construct. Then we declared an S3 bucket. With no properties. Ok, but… S3 buckets are more useful when they have names. And… our website is going to have a name. S3 bucket names are required to be globally unique, and dns names are by definition globally unique. Let’s use the name of the website for the name of the bucket. This has the added benefit of improving the discoverability of the system since you can pretty quickly associate the DNS and the S3 bucket when the have the same name.

Node Lambdas - A Better Way

Sun, 04 Oct 2020 00:00:00 +0000

Introduction Link to heading

In Getting Started with CDK, I wrote “I noticed that cdk has a pattern of using a lambdas directory and then having sub-directories for every lambda”. Well, I was wrong, or maybe things have just changed. Either way, we’re going to update hugo-cdk to follow the new pattern.

The New Pattern Link to heading

Recently, cdk was updated to add bundling support. We didn’t need bundling with our previous lambda, because it doesn’t depend on any libraries. The new pattern is still a more elegant approach, so lets take a look at the fancy but plainly named aws-lambda-nodejs.

CDK Composition

Thu, 10 Sep 2020 00:00:00 +0000

Introduction Link to heading

So far in this series, we have set up the basics of a Hugo blog and push the code to GitHub and bootstrapped a cdk application and used it to deployed a lambda. Then your faithless narrator wandered off for a month, and when he came back nagged you about upgrading cdk. Our next step is to deploy the rest of what was described in serving static sites with AWS. That’s going to require us to add a few more things to our cdk app, so now is a good time to talk about apps, stacks and constructs.

Getting Started with CDK

Thu, 06 Aug 2020 00:00:00 +0000

Introduction Link to heading

aws-cdk was the new hotness at AWS re:Invent 2019, going from about 4 presentations in 2018 to something like 40 presentations. That’s an order of magnitude increase. And that is the kind of thing that gets my attention. cdk offers IaC that is… code. It’s not a dsl (looking at you, Terraform). Nor is it an attempt to overwhelm you with JSON or YAML verbosity. It’s… just… TypeScript. And that turns out to be powerful.

Serving a Static Site with AWS

Sun, 02 Aug 2020 00:00:00 +0000

Do Something Easy in AWS Link to heading

AWS is all about making undifferentiated heavy lifting easy. Here, I will talk about serving static web content. The AWS way to serve static web content involves putting that content in an S3 bucket, and then delivering it using their CloudFront CDN. There are a few other parts involved, but here are the things you will need to bring to the party.

Getting Started With Hugo

Wed, 22 Jul 2020 00:00:00 +0000

Introduction Link to heading

I guess every Hugo based technical blog has a mandatory first post on the topic of getting started with Hugo. This is gonna be a short one… because so far, Hugo has been entirely straight forward to use. Took me about 20 minutes to get this working.

Why Another Blog, Dude Link to heading

First of all, my pronouns are “them/they” or “he/him/brah”. And second, because while I’ve done CI for Hugo before, I had forgotten how. I spent about an hour talking the ear off Chris about how cool AWS static content delivery was. And how I could blast together something in the also-very-cool aws-cdk in like an hour for his Hugo sites. Then life happened and… I was a bad friend.