🌤️ Weather Forecast App

A simple yet modern Flask-based weather forecast application that fetches real-time weather data from OpenWeatherMap and provides a beautiful, responsive UI.

This project is Dockerized and supports CI/CD deployment to Ghaymah Cloud using the included shell script.

🚀 Features

🌍 Search weather for any city worldwide
🌡️ Shows temperature, feels-like, humidity, pressure, wind speed, and visibility
🌅 Displays sunrise and sunset times
📊 Auto-updating with timestamp
🎨 Responsive and modern UI (HTML, CSS, JS embedded in Flask)
🐳 Dockerized for portability
☁️ CI/CD ready with Ghaymah Cloud

📂 Project Structure

.
├── app.py                # Flask application with weather API integration
├── CICDpipeline.sh       # CI/CD pipeline script for Docker + Ghaymah Cloud
├── Dockerfile            # Dockerfile to containerize the Flask app
├── requirements.txt      # Python dependencies
├── templates/            # HTML templates (auto-generated by Dockerfile)
└── README.md             # Documentation

⚙️ Prerequisites

Before running or deploying the app, ensure you have:

Python 3.9+
Docker
Ghaymah CLI (gy) installed and configured
An OpenWeatherMap API key

🛠️ Local Development

Clone this repository:

git clone https://github.com/your-username/weather-app.git
cd weather-app

Create and activate a virtual environment:

python -m venv venv
source venv/bin/activate   # Linux/Mac
venv\Scripts\activate      # Windows

Install dependencies:
```
pip install -r requirements.txt
```
Run the app:
```
python app.py
```
Open your browser at:
👉 http://127.0.0.1:5000

🐳 Running with Docker

Build the Docker image:
```
docker build -t weather-app:1 .
```
Run the container:
```
docker run -p 5000:5000 weather-app:1
```
Visit the app at:
👉 http://localhost:5000

☁️ CI/CD Deployment to Ghaymah Cloud

This project includes a CICDpipeline.sh script that:

Builds and tags Docker images
Pushes them to Docker Hub
Creates a .ghaymah.json config
Deploys the app to Ghaymah Cloud

🔧 Steps

Make the script executable:
```
chmod +x CICDpipeline.sh
```
Run the deployment script:
```
./CICDpipeline.sh
```
Follow the prompts:
- Enter your Ghaymah Project Name
- Enter your App Name
If Ghaymah CLI is installed, the app will be deployed automatically.

✅ Your app will be accessible at:

https://<your-app-name>.hosted.ghaymah.systems

🧾 Environment Variables

Set your OpenWeatherMap API key (recommended):

export API_KEY="your_openweathermap_api_key"

If not set, a demo key will be used (limited requests).

📊 Health Check

Check if the app is running:

curl http://localhost:5000/health

Example response:

{
  "status": "healthy",
  "timestamp": "2025-09-25T14:30:00"
}

3.4 KiB خام الرابط الدائم اللوم التاريخ