How matcordone/my-portfolio-web works
Project type and purpose
• This is a static personal portfolio website.
• The site is authored in plain HTML, CSS and JavaScript (in /web) and served via AWS S3 + CloudFront.
• All cloud resources and delivery pipeline are defined in Terraform (in /infra) and automated via GitHub Actions (.github/workflows/deploy.yml).
File structure
• Top-level directories:
• .github/workflows – CI/CD pipeline definitions
• infra – Terraform modules and configurations for AWS
• web – Static website assets (HTML, CSS, JS, images, fonts)
• Key configuration files:
• infra/*.tf – declares S3 bucket, CloudFront distribution, OAC, ACM certificate, Route 53 records, IAM roles, providers, outputs
• deploy.yml – syncs web/ to S3 and invalidates CloudFront cache on each push to main
README for additional insights
• Describes full static-site stack: S3 for hosting, CloudFront+OAC for CDN, ACM for SSL, Route 53 for DNS
• Terraform is the single source of truth for infra
• GitHub Actions drive deployments and cache invalidations
a. Main components
• Developer workstation (local code)
• GitHub repository & Actions runner
• Terraform (IaC engine)
• AWS S3 bucket (static file host)
• AWS CloudFront distribution (CDN with OAC)
• AWS ACM (SSL/TLS certificate)
• AWS Route 53 (DNS)
b. Relationships & data flow
1. Developer pushes code → GitHub Actions
2. Actions run Terraform apply → provisioning or updating S3, CloudFront, ACM, Route 53
3. Actions sync /web assets → S3 bucket
4. Actions send invalidation API call → CloudFront cache
5. End users request https://mateocordone.com.ar → Route 53 DNS → CloudFront → S3 origin (OAC enforced)
c. Architectural patterns & design principles
• Infrastructure as Code: all AWS resources defined in Terraform modules
• Continuous Deployment: automated via GitHub Actions
• Static-site CDN pattern: origin (S3) + global edge cache (CloudFront) + HTTPS managed by ACM
d. Key technologies/frameworks
• Terraform (HCL)
• AWS S3, CloudFront, OAC, ACM, Route 53, IAM
• GitHub Actions (CI/CD)
• Plain HTML/CSS/JS