Getting Started

This guide provides detailed steps to set up and start the project using the provided tasks.py file and Poetry for dependency management. Follow these instructions to get up and running quickly.

---

Prerequisites

Ensure you have the following installed on your system:

Installing Prerequisites

• Python 3.10 or later: Download and install Python
• Docker and Docker Compose: Install Docker
• Poetry: Install Poetry
• MkDocs: Included in Poetry dependencies; no separate installation required.

---

Setting Up the Environment

graph TD
    A[Clone Repository] --> B[Initialize Poetry]
    B --> C[Create ENV Files]
    C --> D[Invoke Tasks]

---

High-Level Folder Structure

infrastructure/
├── load_balancer/
│   ├── Dockerfile.dev
│   ├── haproxy.cfg
├── web_server/
│   ├── Dockerfile.dev
│   ├── app.py
├── nagios/
│   ├── etc/
│   ├── libexec/
mkdocs/
├── docs/
├── mkdocs.yml
docker-compose*.yml
pyproject.yml
poetry.lock
tasks.py

Steps to Start Docker Containers

1. Clone the Repository

git clone https://github.com/kvncampos/infrastructureSetup

2. Poetry Init

poetry shell
poetry install

3. Create ENV Files

At the root level:

touch .env

PROJECT_NAME=<projectName>
ENV=development

At infrastructure/nagios/:

touch .env

NAGIOSADMIN_USER=nagiosadmin
NAGIOSADMIN_PASSWORD=<Passoword>
NAGIOS_TIMEZONE=UTC

4. Invoke Tasks

invoke up

Quick Access to Containers

• MKDocs
• Web Server A
• Web Server B
• HAProxy LB
• Nagios

Troubleshooting

Docker Compose Fails to Start

• Issue: Error: Cannot connect to the Docker daemon.
• Solution: Ensure Docker is running: sudo systemctl start docker.

Poetry Command Not Found

• Issue: Poetry commands are not recognized.
• Solution: Add Poetry to your PATH: export PATH="$HOME/.poetry/bin:$PATH".