Step 2: Configure hosted zone

Configure hosted zone

In order to access any environment you need to have a public Hosted Zone in AWS Route53.

ShipFast will use this hosted zone's domain to route traffic to your app.

info

A hosted zone is a container for records, and records contain information about how you want to route traffic for a specific domain, such as example.com, and its subdomains (acme.example.com, zenith.example.com). A hosted zone and the corresponding domain have the same name.

Source: AWS docs

Create a new hosted zone

Depending on your use case there are multiple approaches to creating a hosted zone:

1. You don't have a domain yet.

   • Follow this tutorial prepared by AWS team: Domain registration docs

2. You have a domain registered in external DNR (e.g. GoDaddy).

   • Active domain (with users) – follow this tutorial by AWS team: Migrate active DNS
   • Inactive domain (no users) – follow this tutorial by AWS team: Migrate inactive DNS

3. You have a domain in Route53 already and want to create a subdomain for the env.

   • Follow this tutorial prepared by AWS team: Route traffic for subdomains

4. You have a domain in Route53 already.

   • You most likely already have a hosted zone! You're good to go.

Read hosted zone parameters

In the end you should be able to go to the AWS web panel and get Hosted Zone ID and Hosted Zone Name.

info

You can open AWS web panel with pnpm shipfast aws login command if you configured aws-vault

• id of the hosted zone
• name of the hosted zone