https://github.com/izjmz/html-static-hosting

This repository automates the deployment of a static HTML website on AWS using Terraform (IaC) and Jenkins (CI/CD), Terraform for EC2 provisioning, Docker for portability, Jenkins pipelines for deployment, and Vagrant for local environments. Demonstrates DevOps skills with AWS integration and modern tools like Prometheus.
https://github.com/izjmz/html-static-hosting

devops docker html node-exporter prometheus static-site terraform vagrant

Last synced: 7 months ago
JSON representation

This repository automates the deployment of a static HTML website on AWS using Terraform (IaC) and Jenkins (CI/CD), Terraform for EC2 provisioning, Docker for portability, Jenkins pipelines for deployment, and Vagrant for local environments. Demonstrates DevOps skills with AWS integration and modern tools like Prometheus.

• Host: GitHub
• URL: https://github.com/izjmz/html-static-hosting
• Owner: Izjmz
• Created: 2025-04-13T22:43:06.000Z (10 months ago)
• Default Branch: master
• Last Pushed: 2025-04-16T01:35:57.000Z (10 months ago)
• Last Synced: 2025-04-19T02:19:27.305Z (10 months ago)
• Topics: devops, docker, html, node-exporter, prometheus, static-site, terraform, vagrant
• Language: HCL
• Homepage:
• Size: 1.96 MB
• Stars: 7
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
![Logo](./visual-resources/devops-ian-logo.jpeg)

# 🌐 DevOps Static Website Hosting Project

This project demonstrates a complete DevOps pipeline to deploy and monitor a static HTML website using modern infrastructure-as-code and containerization tools.

## 🚀 Overview

The HTML site is hosted in a Docker container running Apache HTTP Server. The infrastructure is provisioned via Terraform on AWS, with Jenkins for health checks and Prometheus + Node Exporter for monitoring system metrics.

## 🛠️ Technologies Used

- **AWS** - IAM, VPC, EC2, Elastic IP and Cloudwatch integration

- **Docker** – Containerization of the Apache web server

- **Jenkins** – Health checks and basic automation

- **Terraform** – Infrastructure provisioning on AWS EC2

- **Prometheus** – Monitoring and metric collection

- **Node Exporter** – System-level metrics

- **Vagrant** – Local development and testing environment

## 📁 Project Structure

```

.

├── Docker/                    # Builds Apache-based HTML site container

├── Jenkins/                   # Automation healthcheck pipeline

├── Prometheus/                # Prometheus configuration

├── Terraform/                 # Terraform infrastructure definition

├── Vagrant                    # Local VM provisioning

├── html_data/                 # Static HTML content (photo, intro, buttons)

├── visual-resources           # README visual content

└── README.md

```

## 🔧 Features

- Static website with personal intro and contact buttons (LinkedIn & Gmail)

- Jenkins health check job with alert mechanism

- Prometheus scraping from EC2 and local Node Exporter

- Infrastructure as Code with Terraform

- Vagrant box for quick local deployments

## 📄 Project diagram

*Visual explaning of the project infrastructure*



## 📸 Screenshots

- *Local instance working with HTML template*

![Local template](./visual-resources/local-project.png)

- *AWS instance with the HTML website working*

![HTML Instance working](./visual-resources/html-website-accesible.png)

- *Jenkins accessible from port 8080*

![Jenkins menu](./visual-resources/jenkins-port-8080.png)

- *Prometheus accesible and linked with Node Exporter from port 9090*

![Prometheus working](./visual-resources/prometheus-with-node.png)

- *Node Exporter accesible from port 9100*

![Node Exporter](./visual-resources/node-exporter-working.png)

## 📬 Contact

Feel free to reach out for job opportunities, questions or suggestions:

- [LinkedIn](https://www.linkedin.com/in/ian-araya-jimenez)

- [Gmail](mailto:jimz.ianar@gmail.com)

---

![Logo](./visual-resources/devops-ian-logo.jpeg)