This repository provides GitOps inspired configuration for our DNS records, CDN configuration, and other services used by the Playful Programming site.

Configuration is written with OpenTofu. This is meant to run in GitHub Actions and stores its state in S3-compatible storage (in Fastly).

Getting Started

• Either build the included devcontainer or Install OpenTofu
• Run tofu init

Before pushing any changes, check the configuration with tofu fmt and tofu validate. You won't be able to run tofu plan without using our secrets (which you should not have). When you open a PR, the tofu.yml workflow will show the planned changes in the job summary.

There are two environments, with configuration in env-staging.tfvars and env-prod.tfvars. The staging environment deploys on any push to main, and waits for testing and approval before deploying to prod.

Architecture

This is the current state of our overall dependencies:

flowchart TD
    WebUser@{ shape: rounded, label: "Website User" }

    subgraph "Cloudinary"
    ImageOptimization["Image Optimization"]
    end

    subgraph "GitHub Actions"
    WebDeploy["Web Deploy"]
    HoofDeploy["Hoof Deploy"]
    OpenTofu["Infra Deploy (OpenTofu)"]
    end

    subgraph "Fastly"
    CDN
    OpenTofuObjectStorage["OpenTofu Object Storage"]
    end

    subgraph "Porkbun"
    DNS
    end

    subgraph "Fly.io"
    WebMachine["playful-web"]
    HoofMachine["hoof"]
    Postgres
    Redis
    Tigris["Tigris Object Storage"]
    end

    Orama["Orama Search Index"]

    WebDeploy -.-> Orama
    WebDeploy -.-> WebMachine
    WebDeploy --> HoofMachine
    HoofDeploy -.-> HoofMachine

    WebUser --> Orama
    WebUser --> CDN
    WebUser --> Tigris
    WebUser --> ImageOptimization --> WebMachine

    CDN --> WebMachine

    HoofMachine --> Tigris
    HoofMachine --> Postgres
    HoofMachine --> Redis

    OpenTofu --> OpenTofuObjectStorage
    OpenTofu -.-> CDN
    OpenTofu -.-> DNS

Loading