| Принцип | Описание | Пример |
|---|---|---|
| 1. Минимализм | Каждый микросервис должен выполнять одну конкретную задачу. Это помогает уменьшить сложность кода и облегчает его тестирование и отладку. Минимализм также способствует тому, что микросервис имеет меньше зависимостей, что сокращает его размер и время запуска. | В проекте QuickDelivery мы можем иметь отдельные микросервисы для обработки заказов, управления складами и логистики. Каждый из них отвечает за свою конкретную задачу. |
| 2. Независимость | Микросервисы должны быть независимы друг от друга. Это означает, что они могут разрабатываться, развёртываться и масштабироваться независимо. Независимость достигается за счёт чётко определённых API для взаимодействия между микросервисами. | Order Service и Logistics Service в QuickDelivery могут взаимодействовать через REST API, что позволяет им работать независимо друг от друга. |
| 3. Быстрое время запуска | Легковесные микросервисы должны быстро запускаться, что особенно важно в сценариях автоматического масштабирования и развёртывания. Быстрое время запуска позволяет быстрее реагировать на изменения нагрузки и быстро восстанавливаться после сбоев. | Использование лёгких базовых образов Docker, таких как Alpine, помогает сократить время запуска микросервисов. |
| 4. Эффективное использование ресурсов | Легковесные микросервисы должны эффективно использовать ресурсы, такие как память и процессорное время. Это достигается за счет оптимизации кода и использования легковесных библиотек и фреймворков. | В QuickDelivery мы можем использовать Flask вместо более тяжёлых веб-фреймворков для создания легковесных микросервисов на Python. |
| 5. Упрощение зависимостей | Микросервисы должны иметь минимальное количество зависимостей. Это снижает риск конфликтов версий и упрощает процесс обновления и развёртывания. | Использование виртуальных окружений и зависимостей, указанных в requirements.txt, помогает управлять зависимостями в микросервисах QuickDelivery. |
| 6. Обеспечение изоляции | Каждый микросервис должен быть изолирован от других, что позволяет избежать проблем с совместным использованием ресурсов и облегчает отладку. Изоляция достигается за счет использования контейнеров. | Развёртывание Order Service и Logistics Service в отдельных Docker-контейнерах обеспечивает их изоляцию. |
| 7. Документирование и автоматизация | Каждый микросервис должен быть хорошо задокументирован и иметь автоматизированные процессы развёртывания и тестирования. Это позволяет быстрее внедрять изменения и уменьшает вероятность ошибок. | В QuickDelivery мы можем использовать CI/CD инструменты для автоматизации развёртывания микросервисов и документировать API с помощью Swagger. |
order-service/
├── app.py
├── requirements.txt
├── Dockerfile
├── swagger.yml
├── db/
│ └── models.py
└── utils/
└── db_utils.py Код микросервиса Order Service
PYTHON
from flask import Flask, request, jsonify
from db.models import db, Order
from utils.db_utils import init_db
app = Flask(__name__)
app.config['SQLALCHEMY_DATABASE_URI'] = 'postgresql://postgres:password@db:5432/orders'
db.init_app(app)
@app.route('/orders', methods=['POST'])
def create_order():
data = request.get_json()
new_order = Order(customer_name=data['customer_name'], item=data['item'], status='Pending')
db.session.add(new_order)
db.session.commit()
return jsonify({'message': 'Order created successfully'}), 201
@app.route('/orders/<int:order_id>', methods=['PUT'])
def update_order(order_id):
data = request.get_json()
order = Order.query.get(order_id)
if not order:
return jsonify({'message': 'Order not found'}), 404
order.status = data['status']
db.session.commit()
return jsonify({'message': 'Order updated successfully'})
if __name__ == '__main__':
with app.app_context():
init_db()
app.run(host='0.0.0.0', port=5000) PYTHON
from flask_sqlalchemy import SQLAlchemy
db = SQLAlchemy()
class Order(db.Model):
id = db.Column(db.Integer, primary_key=True)
customer_name = db.Column(db.String(80), nullable=False)
item = db.Column(db.String(120), nullable=False)
status = db.Column(db.String(20), nullable=False)
PYTHON
from db.models import db
def init_db():
db.create_all() Swagger документация Order Service
YAML
swagger: '2.0'
info:
title: Order Service API
version: 1.0.0
paths:
/orders:
post:
summary: Create a new order
consumes:
- application/json
parameters:
- in: body
name: body
required: true
schema:
type: object
properties:
customer_name:
type: string
item:
type: string
responses:
201:
description: Order created successfully
/orders/{order_id}:
put:
summary: Update an order
consumes:
- application/json
parameters:
- in: path
name: order_id
required: true
type: integer
- in: body
name: body
required: true
schema:
type: object
properties:
status:
type: string
responses:
200:
description: Order updated successfully logistics-service/
├── app.py
├── requirements.txt
├── Dockerfile
├── swagger.yml
├── db/
│ └── models.py
└── utils/
└── db_utils.py Код микросервиса Logistics Service
PYTHON
from flask import Flask, request, jsonify
from db.models import db, Delivery
from utils.db_utils import init_db
app = Flask(__name__)
app.config['SQLALCHEMY_DATABASE_URI'] = 'postgresql://postgres:password@db:5432/logistics'
db.init_app(app)
@app.route('/deliveries', methods=['POST'])
def create_delivery():
data = request.get_json()
new_delivery = Delivery(order_id=data['order_id'], status='In Transit')
db.session.add(new_delivery)
db.session.commit()
return jsonify({'message': 'Delivery created successfully'}), 201
@app.route('/deliveries/<int:delivery_id>', methods=['PUT'])
def update_delivery(delivery_id):
data = request.get_json()
delivery = Delivery.query.get(delivery_id)
if not delivery:
return jsonify({'message': 'Delivery not found'}), 404
delivery.status = data['status']
db.session.commit()
return jsonify({'message': 'Delivery updated successfully'})
if __name__ == '__main__':
with app.app_context():
init_db()
app.run(host='0.0.0.0', port=5001) PYTHON
from flask_sqlalchemy import SQLAlchemy
db = SQLAlchemy()
class Delivery(db.Model):
id = db.Column(db.Integer, primary_key=True)
order_id = db.Column(db.Integer, nullable=False)
status = db.Column(db.String(20), nullable=False) PYTHON
from db.models import db
def init_db():
db.create_all() Swagger документация Logistics Service
YAML
swagger: '2.0'
info:
title: Logistics Service API
version: 1.0.0
paths:
/deliveries:
post:
summary: Create a new delivery
consumes:
- application/json
parameters:
- in: body
name: body
required: true
schema:
type: object
properties:
order_id:
type: integer
responses:
201:
description: Delivery created successfully
/deliveries/{delivery_id}:
put:
summary: Update a delivery
consumes:
- application/json
parameters:
- in: path
name: delivery_id
required: true
type: integer
- in: body
name: body
required: true
schema:
type: object
properties:
status:
type: string
responses:
200:
description: Delivery updated successfully docker-compose.yml, который будет содержать описание сервисов.docker-compose.yml;docker-compose.yml и включает в себя инструкции по созданию и запуску контейнера. Сервисы могут зависеть друг от друга и взаимодействовать между собой.docker-compose.yml и подключены к контейнерам для обеспечения долговременного хранения данных.docker-compose.yml или в отдельном файле .env..envdocker-compose.yml, мы можем использовать файл .env. В этом файле будут определены все необходимые переменные окружения..envdocker-compose.yml;.env;docker-compose.yml в корневой директории вашего проекта и добавьте в него следующие строки:YAML
version: '3.8'
services:
order-service:
build: ./order-service
container_name: order-service
ports:
- "5000:5000"
environment:
- DATABASE_URL=postgresql://postgres:password@db:5432/orders
depends_on:
- db
logistics-service:
build: ./logistics-service
container_name: logistics-service
ports:
- "5001:5001"
environment:
- DATABASE_URL=postgresql://postgres:password@db:5432/logistics
depends_on:
- db
db:
image: postgres:13
container_name: postgres
environment:
POSTGRES_USER: postgres
POSTGRES_PASSWORD: password
POSTGRES_DB: orders
ports:
- "5432:5432" Описание docker-compose.yml
3.8.BASH
docker-compose up --build BASH
curl http://localhost:5000/orders BASH
docker-compose down postgres-data) указан в разделе volumes файла docker-compose.yml. Тогда при следующем запуске данные будут сохранены.docker-compose.yml:YAML
version: '3.8'
services:
order-service:
build: ./order-service
container_name: order-service
ports:
- "5000:5000"
environment:
- DATABASE_URL=postgresql://postgres:${POSTGRES_PASSWORD}@db:5432/orders
depends_on:
- db
networks:
- quickdelivery-network
logistics-service:
build: ./logistics-service
container_name: logistics-service
ports:
- "5001:5001"
environment:
- DATABASE_URL=postgresql://postgres:${POSTGRES_PASSWORD}@db:5432/logistics
depends_on:
- db
networks:
- quickdelivery-network
db:
image: postgres:13
container_name: postgres
environment:
POSTGRES_USER: postgres
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
POSTGRES_DB: orders
ports:
- "5432:5432"
volumes:
- postgres-data:/var/lib/postgresql/data
networks:
- quickdelivery-network
networks:
quickdelivery-network:
volumes:
postgres-data: POSTGRES_PASSWORD=mysecretpassword docker-compose.ymlquickdelivery-network, к которой подключатся все наши контейнеры.YAML
version: '3.8'
services:
order-service:
build: ./order-service
container_name: order-service
ports:
- "5000:5000"
environment:
- DATABASE_URL=postgresql://postgres:${POSTGRES_PASSWORD}@db:5432/orders
depends_on:
- db
networks:
- quickdelivery-network
logistics-service:
build: ./logistics-service
container_name: logistics-service
ports:
- "5001:5001"
environment:
- DATABASE_URL=postgresql://postgres:${POSTGRES_PASSWORD}@db:5432/logistics
depends_on:
- db
networks:
- quickdelivery-network
db:
image: postgres:13
container_name: postgres
environment:
POSTGRES_USER: postgres
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
POSTGRES_DB: orders
ports:
- "5432:5432"
volumes:
- postgres-data:/var/lib/postgresql/data
networks:
- quickdelivery-network
networks:
quickdelivery-network:
driver: bridge
volumes:
postgres-data: quickdelivery-network.bridge.docker-compose.yml и подключены к контейнерам для обеспечения долговременного хранения данных.docker-compose.ymlpostgres-data для хранения данных PostgreSQL.YAML
version: '3.8'
services:
order-service:
build: ./order-service
container_name: order-service
ports:
- "5000:5000"
environment:
- DATABASE_URL=postgresql://postgres:${POSTGRES_PASSWORD}@db:5432/orders
depends_on:
- db
networks:
- quickdelivery-network
logistics-service:
build: ./logistics-service
container_name: logistics-service
ports:
- "5001:5001"
environment:
- DATABASE_URL=postgresql://postgres:${POSTGRES_PASSWORD}@db:5432/logistics
depends_on:
- db
networks:
- quickdelivery-network
db:
image: postgres:13
container_name: postgres
environment:
POSTGRES_USER: postgres
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
POSTGRES_DB: orders
ports:
- "5432:5432"
volumes:
- postgres-data:/var/lib/postgresql/data
networks:
- quickdelivery-network
networks:
quickdelivery-network:
driver: bridge
volumes:
postgres-data: postgres-data.BASH
docker-compose logs BASH
docker-compose logs order-service curl или Postman, чтобы отправлять HTTP-запросы к сервисам.BASH
curl -X POST -H "Content-Type: application/json" -d '{"customer_name": "John Doe", "item": "Laptop"}' http://localhost:5000/orders BASH
curl -X PUT -H "Content-Type: application/json" -d '{"status": "Shipped"}' http://localhost:5000/orders/1 BASH
curl -X POST -H "Content-Type: application/json" -d '{"order_id": 1}' http://localhost:5001/deliveries BASH
curl -X PUT -H "Content-Type: application/json" -d '{"status": "Delivered"}' http://localhost:5001/deliveries/1 psql.BASH
psql -h localhost -U postgres -d orders SQL
SELECT * FROM orders;
SELECT * FROM deliveries; DOCKER
FROM python:3.8-slim
WORKDIR /app
COPY requirements.txt requirements.txt
RUN pip install -r requirements.txt
COPY . .
CMD ["python", "app.py"] docker run -d --name mycontainer myappdocker rm mycontainerdocker build -t myapp . docker logs mycontainerdocker stop mycontainerВерная последовательность действий: 1. Собрать образ контейнера с использованием команды `docker build`. 2. Запустить контейнер из созданного образа с помощью команды `docker run`. 3. Проверить логи контейнера с использованием команды `docker logs`. 4. Остановить контейнер с помощью команды `docker stop`. 5. Удалить контейнер с использованием команды `docker rm`.
docker-compose.yml или в отдельном файле .env.