Skip to content

🟢 FastAPI microservice template with async support, modular architecture, and ready-to-use Docker, testing, and CI/CD setup.

Notifications You must be signed in to change notification settings

ummataliyev/fastapi-microservice

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Getting Started

  1. Clone the repository:

    git clone git@github.com:ummataliyev/fastapi-microservice.git
    cd fastapi-microservice
  2. Set up environment variables:

    • Create a .env file in the project's root directory.
    cp infra/.env-example infra/.env
  3. Build and run the application:

    make up
  4. Usage:

    • All common Docker and project tasks can be run using make:
    make up - Build and start all services
    make down - Stop all services
    make restart - Restart API container
    make logs - Show logs
    make shell - Open a bash shell inside the API container
    make psql - Connect to PostgreSQL database
    make clean- Remove all containers and volumes (clean start)
    make build - Build Docker images
    make upgrade - Apply all database migrations
    make revision - Create a new migration (prompts for comment)
    make test - Run tests
    make lint - Run code linting
    make format - Auto-format and fix code issues
  5. Access the application:

    • API documentation is available at:
  • Swagger UI: http://127.0.0.1:8000/docs
  • ReDoc: http://127.0.0.1:8000/redoc

About

🟢 FastAPI microservice template with async support, modular architecture, and ready-to-use Docker, testing, and CI/CD setup.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages