GitlabCI Tutorial

This README provides step-by-step instructions on how to set up and run the project.

Prerequisites

Before you begin, ensure you have the following prerequisites installed on your system:

• Python (>= 3.11)
• pip (Python package manager)
• Virtualenv (optional, but recommended)

Getting Started

1. Clone the repository:

   git clone git@github.com:devopshobbies/gitlabci-tutorial.git
   cd gitlabci-tutorial

2. Create a virtual environment (optional but recommended):

   python -m venv venv

3. Activate the virtual environment:

   • On Windows:

     venv\Scripts\activate

   • On macOS and Linux:

     source venv/bin/activate

4. Install project dependencies:

   pip install -r requirements.txt

5. Apply migrations to create database tables:

   python manage.py migrate
   python maange.py makemigrations

6. Create a superuser for the Django admin panel:

   python manage.py createsuperuser

Running the Application

1. Start the development server:

   python manage.py runserver

2. Open your web browser and go to http://127.0.0.1:8000/ to access the Django application.

3. Access the Django admin panel at http://127.0.0.1:8000/admin/ and log in using the superuser credentials you created earlier.

Project Structure

• simple_app/ - Django project directory.
• app/ - Django app directory (you can have multiple apps).
• manage.py - Django management script.
• requirements.txt - List of Python dependencies.
• docker-compoe.yml - Run the project using the Docker container platform.
• Dockerfile - Build the project using the Docker container platform.
• gitlab-ci.yml - CI/CD file using GitlabCI.
• db.sqlite3 - Default database SQLite, but you can change it.

Contributing

If you would like to contribute to this project, please feel free to contribute.