Cases6 cases

6 to 6 of 6

1. IL-0363 static.crates.io did not resolve for 10-15 minutes during a Terraform deployment, so Rust builds could not fetch crates

   Rust Project2023

   Symptoms

   On 25 January 2023, shortly after a deployment to the crates.io production infrastructure at 09:15 UTC, the DNS record for static.crates.io failed to resolve for an estimated 10-15 minutes. Builds failed for users because crates could not be downloaded.

   DNS resolution failures

   Trigger

   A Terraform deployment to production contained a new TLS certificate for the current CDN of static.crates.io and updated DNS records; Terraform removed the current certificate and DNS records first and recreated the records only after the new certificate had been issued.

   Root cause

   Configuration change

   Component

   TerraformAuthoritative DNS servers and recordsCDN and edge network

   Contributing factor

   No safeguard on destructive changeUnrepresentative staging

   Remediation

   • Terraform finished the deployment and created a new DNS record for static.crates.io, which ended the outage

   Action items

   • Document the process of deploying changes to production, including how to pick the Git commit and how to review the changeset
   • Deploy changes developed and tested in isolation on staging individually and in sequence to production, and add this to the documentation
   • Deploy changes to production when they are merged into the main branch, so the configuration in Git and what is deployed do not drift

   Lessons

   Deploying the TLS certificate change and the DNS record change separately would have avoided the outage. Changes tested one at a time on staging need to reach production one at a time and in order, the production deploy process needs to be written down so it can be improved, and merged changes need to be deployed promptly so Git and production do not drift apart.

   View case

By root cause1