In this 2nd article, I will continue from the first article
and show you how to deploy my blokaly.com website built with Hugo on to AWS. There are 2 ways we can deploy: the
HTTP way and the
HTTPS way. HTTPS (Hypertext Transfer Protocol Secure) is a secure version of the HTTP protocol that uses the SSL/TLS protocol
for encryption and authentication. It involves setting up the SSL/TLS certificate, so a bit trickier than HTTP. We will first deploy our website on to AWS using HTTP, following the principles of this guide: hosting a static website using Amazon S3
, and in the next article we will add more configurations and turn our http website into https.
HashiCorp Terraform is an infrastructure as code tool that lets you define both cloud and on-prem resources in human-readable configuration files that you can version, reuse, and share. You can then use a consistent workflow to provision and manage all of your infrastructure throughout its lifecycle. Terraform can manage low-level components like compute, storage, and networking resources, as well as high-level components like DNS entries and SaaS features.
Amazon Simple Storage Service (Amazon S3 ) is an object storage service that offers industry-leading scalability, data availability, security, and performance. Customers of all sizes and industries can use Amazon S3 to store and protect any amount of data for a range of use cases, such as data lakes, websites, mobile applications, backup and restore, archive, enterprise applications, IoT devices, and big data analytics.
tfenv is a Terraform version manager, which can help you to install and use a specific version of Terraform.
The tools you will need to complete the build:
- AWS Console
- AWS Comand Line Interface
- Terraform by HashiCorp
- tfenv (optional)
- A purchased domain, I got mine from Namecheap
- First, if you don’t have an AWS account, then you can follow this instruction to set up an AWS account and create an administrator user. There are 2 options to create the user, IAM or IAM Identity Centre. I chose IAM Identity Centre. Note, this is different to the root user during your AWS account sign up. The root user has access to all AWS services and resources in the account. As a security best practice, assign administrative access to an administrative user, and use only the root user to perform tasks that require root user access.
- Then, follow this guide to install AWS CLI. The AWS Command Line Interface (AWS CLI) is an open source tool that enables you to interact with AWS services using commands in your command-line shell.
- Next, either install Terraform directly following this guide
or use tfenv
to install the terraform. My terraform version is
- After you completed the above 3 steps, now let’s setup an AWS S3 bucket as the terraform backend
. A backend defines where Terraform stores its state data files. By default, Terraform uses a backend called
local, which stores state as a local file on disk. If you are OK with local configuration for the moment, then you can skip this step. I followed this guide to setup my AWS S3 backend with some amendments.
Here are my S3 bucket properties:
Property Value Bucket Versioning Disabled Encryption key type SSE-KMS Bucket Key Disabled Server access logging Disabled Static website hosting Disabled
- Now, let’s create a folder named
terraformunder the Hugo root folder and create a file named
main.tf. Then first add several definitions:
<s3_bucket_name> with your S3 bucket name and
<awscli_profle> with your AWS CLI profile. I’m using
ap-southeast-1 as my region, please change it to your hosting region.
The following code will create a new AWS S3 bucket to host the Hugo files, then create an AWS Route53 zone and 2 records to associate with the created S3 bucket:
- Save the
main.tffile, and execute
terraform initcommand. If the init command completed successfully, then you can execute
terraform planto check your settings and
terraform applyto build and deploy your settings onto AWS.
- Last step, go to your AWS Route53 hosted zone and find your newly created record, something like this:
then go to the management page where you purchased your domain, in my case namecheap, change the DNS to the values found for your AWS Route53 record.
- Congratulations! If you have completed all the previous steps. Next, see my first article to write your first post.
- To build and deploy your Hugo posts to AWS S3, execute:
public folder as the default, change to your configured folder.
In my next article, I will write about how to deploy the Hugo posts to a HTTPS website using AWS Cloudfront .