https://github.com/veksh/cloudresume

Maintain my CV on AWS S3 + Cloudfront
https://github.com/veksh/cloudresume

ansible aws aws-s3 cloud-resume-challenge cloudfront resume resume-site-builder resume-website terraform

Last synced: 3 months ago
JSON representation

Maintain my CV on AWS S3 + Cloudfront

• Host: GitHub
• URL: https://github.com/veksh/cloudresume
• Owner: veksh
• License: unlicense
• Created: 2024-01-03T17:25:30.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-09-17T18:19:52.000Z (almost 2 years ago)
• Last Synced: 2025-03-15T02:34:28.313Z (over 1 year ago)
• Topics: ansible, aws, aws-s3, cloud-resume-challenge, cloudfront, resume, resume-site-builder, resume-website, terraform
• Language: TeX
• Homepage: https://resume.veksh.in
• Size: 1.87 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Cloud Resume

Simple framework designed to automate the deployment of my [resume site](https://resume.veksh.in) on AWS. It was inspired by the [cloud resume challenge](https://cloudresumechallenge.dev/).

## Tools and components

- Terraform to create the necessary infrastructure:

  - AWS S3 bucket to store the files

  - AWS CloudFront distribution to provide https access to them

  - AWS ACM certificate for https

  - GoDaddy [DNS records](https://github.com/veksh/terraform-provider-godaddy-dns) for the main site and for the DNS challenge from ACM

- Ansible to upload site contents to S3 (actually [s3cmd](https://s3tools.org/s3cmd) would be easier, but doing it with Ansible is more fun)

- LaTeX to typeset resume in PDF format

- GitHub actions to trigger

  - PDF resume rebuild on TeX source changes

  - code checks for Terraform and Ansible on PR creation

  - Terraform run on change of infrastructure definitions

  - Ansible run to upload modified HTML and PDF to S3

## External requirements and configuration

- AWS and GoDaddy credentials must be set in repository secrets (`AWS_ACCESS_KEY_ID` + `AWS_SECRET_ACCESS_KEY` and `GODADDY_API_KEY` + `GODADDY_API_SECRET`)

- Terraform expects to have an s3 bucket to keep the state there, steps to create are outlined [in this gist](https://gist.github.com/veksh/c6804b0d32f5138a92fa1cdb7ed67f7d)

- Some values (like bucket name for TF state) are hard-coded to simlpify configuration, review `ansible/upload.yaml` and `terraform/main.yaml` if cloning

- Package list for TeXLive is hard-coded to my resume template requirements

## Notes on operation

It is recommended to manually run `terraform apply` for the first time to create the infrastructure: there is no real dependency between Ansible and Terraform runs, and Ansible may fail to upload files if bucket has not yet been created (it is better to avoid the race, although usually Terraform finishes faster).