📄 محتوای کامل
مقدمه
کانتینریزه کردن برنامه های وب پایتون، ساختار برنامه و وابستگی های آن را در یک بسته واحد کپسوله می کند تا از استقرارهای سازگار و قابل تکرار در محیط های مختلف اطمینان حاصل شود. استقرار برنامه های وب پایتون کانتینریزه شده، یک رویکرد اساسی برای توسعه نرم افزار مدرن است که شامل مقیاس بندی و اتوماسیون هنگام استقرار در پلتفرم هایی مانند Kubernetes می شود.
شما می توانید برنامه های پایتون را با استفاده از چارچوب های توسعه مختلف بسازید. هر پلتفرم ممکن است به رویکردی کمی متفاوت برای کانتینر کردن و ارسال تصویر برنامه نیاز داشته باشد. چارچوب های محبوب پایتون عبارتند از:
- Flask : یک چارچوب وب سبک و انعطاف پذیر که ابزارهای ضروری برای ساخت برنامه های وب را فراهم می کند. این چارچوب مینیمالیستی است و ابزارهای مستقیمی ارائه می دهد که به توسعه دهندگان اجازه می دهد کتابخانه ها را بر اساس نیازهای خاص پروژه اضافه کنند.
- جنگو : یک چارچوب وب فول استک سطح بالا که مجموعه ای کامل از ابزارها و کتابخانه ها را برای ساخت برنامه های وب قوی فراهم می کند.
- FastAPI : یک چارچوب وب مدرن و با کارایی بالا برای ساخت APIها با پایتون. این چارچوب از type hints برای فعال کردن مستندسازی API تعاملی خودکار (با استفاده از Swagger UI) استفاده می کند و با استفاده از سیستم نوع پایتون، کارایی بالایی را ارائه می دهد.
- Pyramid : یک چارچوب انعطاف پذیر و مقیاس پذیر که به توسعه دهندگان اجازه می دهد اجزای مورد نیاز برای برنامه های خود را انتخاب کنند.
- Tornado : یک کتابخانه شبکه ناهمزمان و چارچوب وب که در درجه اول به دلیل عملکرد بالا و توانایی مدیریت بسیاری از اتصالات همزمان شناخته شده است.
این مقاله نحوه کانتینرایز کردن برنامه های وب پایتون برای استقرار در محیط های عملیاتی مانند کلاسترهای Kubernetes را توضیح می دهد.
پیش نیازها
قبل از شروع:
- یک کلاستر Kubernetes Engine (VKE) را برای استفاده به عنوان پلتفرم استقرار در محیط عملیاتی، مستقر کنید.
- برای ذخیره تصویر برنامه پایتون، یک رجیستری کانتینر ایجاد کنید.
- یک داکر برای استفاده به عنوان ایستگاه کاری مدیریت نصب کنید.
- با استفاده از SSH به عنوان یک کاربر غیر ریشه با امتیازات sudo به ایستگاه کاری دسترسی پیدا کنید .
- Kubectl را برای دسترسی به کلاستر نصب و پیکربندی کنید .
- برای نصب برنامه های خوشه ای اضافی، ابزار Helm CLI را نصب کنید. consoleکپی
$ sudo snap install helm --classic
ایجاد یک برنامه وب پایتون
برای ایجاد یک تصویر ثابت از برنامه وب پایتون که بتوانید با چارچوب های مختلفی مانند Flask یا Django از آن استفاده کنید، کد خود را طوری ساختار دهید که منطق رابط کاربری HTTP سرور frontend از منطق اصلی برنامه جدا باشد. مراحل زیر را برای ایجاد یک برنامه پایه پایتون با استفاده app.pyاز فایل اصلی برنامه و استفاده از یک server.pyفایل برای گنجاندن منطق اولیه HTTP سرور دنبال کنید.
- محیط مجازی پایتون و مدیر بسته PIP را نصب کنید. کنسولکپی
$ sudo apt install python3-venv python3-pip -y
- یک دایرکتوری پروژه جدید برای ذخیره فایل های برنامه ایجاد کنید. کنسولکپی
$ mkdir python-app
- به دایرکتوری تغییر دهید. کنسولکپی
$ cd python-app
- یک محیط مجازی پایتون جدید ایجاد کنید تا وابستگی های برنامه را از سایر بسته های سیستم جدا کنید. کنسولکپی
$ python3 -m venv python-env
- محیط مجازی را فعال کنید. کنسولکپی
$ source python-env/bin/activate
- فایل اصلی برنامه را
app.pyبا استفاده از یک ویرایشگر متن مانند Nano ایجاد کنید. کنسولکپی(python-env)$ nano app.py
- کد زیر را به فایل اضافه کنید. pythonکپی
def hello_world(): print("Hello, World!") if __name__ == "__main__": hello_world()فایل را ذخیره کنید و ببندید.
کد بالا یک برنامه وب پایتون پایه ایجاد می کند که یک
Hello, World!اعلان نمایش می دهد. درون برنامه:- این
hello_worldتابعHello, World!هنگام فراخوانی، رشته را چاپ می کند. if __name__ == "__main__":: بررسی می کند که آیا اسکریپت به عنوان برنامه اصلی اجرا می شود یا خیر. این تضمین می کند که عناصر کد خاصی هنگام شروع اسکریپت با نخ اصلی اجرا شوند. اگر اسکریپت برنامه اصلی باشد،hello_worldتابع را فراخوانی می کند.
- این
- یک فایل جدید
server.pyبرای راه اندازی یک برنامه HTTP پایه با استفاده از پایتونhttp.serverوsocketserverماژول ها ایجاد کنید. کنسولکپی(python-env)$ nano server.py
- کد زیر را به فایل اضافه کنید. پایتونکپی
from http.server import SimpleHTTPRequestHandler from socketserver import TCPServer from threading import Thread class HelloWorldHandler(SimpleHTTPRequestHandler): def do_GET(self): # Handle GET requests self.send_response(200) self.send_header("Content-type", "text/plain") self.end_headers() self.wfile.write(b"Hello, World!") def start_server(): # Set up the HTTP server with custom handler server_address = ("", 8000) httpd = TCPServer(server_address, HelloWorldHandler) print("Server is running at http://localhost:8000") try: # Serve indefinitely httpd.serve_forever() except KeyboardInterrupt: # Handle keyboard interrupt to gracefully shut down the server print("Shutting down the server.") httpd.shutdown() if __name__ == "__main__": # Start the server in a separate thread server_thread = Thread(target=start_server) server_thread.start() # Run the main application from app import hello_world hello_world() # Wait for the server thread to finish server_thread.join()فایل را ذخیره کنید و ببندید.
کد برنامه فوق به درخواست های GET ورودی با یک
Hello, World!اعلان پاسخ می دهد. درون کد:HelloWorldHandler: یک کلاس هندلر سفارشی تعریف می کند کهSimpleHTTPRequestHandlerتابع ماژول HTTP را برای مدیریت درخواست های GET به ارث می برد.start_server: یکTCPServerنمونه در حال اجرا روی پورت میزبان ایجاد می کند. علاوه بر این، استثنائات + وقفه ها را8000ضبط می کند تا سرور را به طور مناسب خاموش کند.KeyboardInterruptCtrlC(if __name__ == "__main__":)سرور HTTP را با استفاده از تابع در یک نخ جداگانه اجرا می کند . سپس، یک تابع را از ماژولThread(target=start_server)وارد و فراخوانی می کند . قبل از بستن اتصال، منتظر می ماند تا نخ سرور تکمیل شود.hello_worldappserver_thread.join()
- برنامه پایتون را به عنوان یک وظیفه پس زمینه در جلسه سرور خود اجرا کنید. کنسولکپی
(python-env)$ python3 server.py &
خروجی:
Server is running at http://localhost:8000 8000برای تأیید دسترسی به برنامه، یک درخواست GET به پورت میزبان ارسال کنید . کنسولکپی(python-env)$ curl -X GET -H "Content-Type: application/json" http://localhost:8000
خروجی:
Hello, World!وقتی درخواست GET فوق با شکست مواجه شد، بررسی کنید که هیچ برنامه ی ناسازگاری روی پورت میزبان تعریف شده اجرا نشود
8000.- شناسه کار برنامه پس زمینه را مشاهده کنید. کنسولکپی
$ jobs
خروجی:
[1] python3 server.py & - برنامه را با استفاده از شناسه شغل متوقف کنید. برای مثال
1. کنسولکپی(python-env)$ kill %1
- محیط مجازی خود را غیرفعال کنید. کنسولکپی
(python-env)$ deactivate
کانتینرایز کردن برنامه وب پایتون
- یک Dockerfile جدید
Dockerfileبرای تنظیم تصویر کانتینر برنامه پایتون خود ایجاد کنید. کنسولکپی$ nano Dockerfile
- محتویات زیر را به فایل اضافه کنید. Dockerfileکپی
FROM python:3.8-slim WORKDIR /app COPY . /app CMD ["python3", "./server.py"]
فایل را ذخیره کنید و ببندید.
پیکربندی Dockerfile فوق، دایرکتوری کانتینر پایتون و ساختار زمان اجرا را تعریف می کند. در داخل پیکربندی:
FROM python:3.8-slim: از ایمیج رسمی پایتون ۳.۸ به عنوان ایمیج پایه برای اجرای کانتینر استفاده می کند.WORKDIR /appدایرکتوری کاری را/appداخل کانتینر تنظیم می کند.COPY . /app: داده ها را از دایرکتوری پروژه شما به کانتینر کپی می کند.CMD ["python3", "./server.py"]:server.pyاسکریپت را هنگام شروع کانتینر اجرا می کند.
- ایمیج داکر را با تمام فایل های دایرکتوری بسازید. کنسولکپی
$ docker build -t python-app .
توضیح کدبتاطراحی شده توسط NegarNovin Agent
- برای تأیید در دسترس بودن برنامه، تصاویر محلی Docker را مشاهده کنید. کنسولکپی
$ docker images
خروجی:
REPOSITORY TAG IMAGE ID CREATED SIZE python-app latest 86ff1e8041fe 19 seconds ago 180MB
تصویر برنامه پایتون را به رجیستری کانتینر نگارنوین منتقل کنید
برای ذخیره و استفاده از تصویر برنامه پایتون روی پلتفرمی مانند Kubernetes، تصویر را به رجیستری کانتینر نگارنوین منتقل کنید تا آن را به محیط های هدف خود ارسال کنید، همانطور که در مراحل زیر توضیح داده شده است.
- وارد رجیستری کانتینر نگارنوین خود شوید. به جای ،،
pythonregistryجزئیات رجیستری واقعی خود را قرار دهید.vcr-uservcr-passwordکنسولکپی$ docker login https://sjc.negarnovin.com/pythonregistry -u vcr-user -p vcr-password
- ایمیج محلی داکر را با مخزن رجیستری کانتینر نگارنوین هدف خود برچسب گذاری کنید. کنسولکپی
$ docker tag python-app:latest sjc.negarnovin.com/pythonregistry/python-app:latest
- لیست تصاویر Docker موجود را مشاهده کنید و تأیید کنید که تصویر رجیستری در دسترس است. کنسولکپی
$ docker images
خروجی:
sjc.negarnovin.com/pythonregistry/python-app latest 5594b65d7cd5 3 minutes ago 159MB python-app latest 01acb92c461c 3 minutes ago 159MB python 3.8-slim 067655fb1c09 2 months ago 128MB - تصویر برنامه پایتون خود را به رجیستری کانتینر نگارنوین منتقل کنید. کنسولکپی
$ docker push sjc.negarnovin.com/pythonregistry/python-app:latest
خروجی:
The push refers to repository [sjc.negarnovin.com/pythonregistry/python-app] 1.2e1e26d6f: Pushed 1.df21a05: Pushed b081d565ce24: Pushed e67a1acfc698: Pushed 1.8551e70: Pushed da5d55102092: Pushed fb1bd2fc5282: Pushed latest: digest: sha256:4a523aab91202e4d79d9456672571ae855a7227590d2dd63de11498bf64f098c size: 1788 - برای آزمایش دسترسی به برنامه، یک کانتینر داکر جدید با استفاده از تصویر کانتینر رجیستری خود راه اندازی کنید. کنسولکپی
$ docker run -dit -p 8000:8000 sjc.negarnovin.com/pythonregistry/python-app:latest
- برای تأیید اینکه کانتینر برنامه شما در دسترس است، لیست کانتینرهای داکر در حال اجرا را مشاهده کنید. کنسولکپی
$ docker ps
خروجی:
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES cfaf3ab6bfac python-app:latest "python3 ./server.py" 8 seconds ago Up 7 seconds 0.0.0.0:8000->8000/tcp, :::8000->8000/tcp jovial_brattain 8000برای تأیید دسترسی به کانتینر برنامه، یک درخواست GET جدید به پورت میزبان ارسال کنید .$ curl -X GET -H "Content-Type: application/json" http://127.0.0.1:8000خروجی:
Hello, World!
استقرار برنامه پایتون در یک کلاستر Kubernetes
برای استقرار ایمن برنامه پایتون کانتینر شده خود در یک محیط عملیاتی مانند خوشه Kubernetes، دسترسی به رجیستری کانتینر نگارنوین خود را تنظیم کرده و تصویر برنامه را به عنوان یک منبع استقرار جدید نصب کنید. هنگام استقرار، کانتینر برنامه شما به اتصالات ورودی روی پورتی 8000که در پیکربندی کانتینر تعریف شده است، گوش می دهد. برای استقرار و استفاده از تصویر برنامه پایتون خود در یک خوشه negarnovin Kubernetes Engine (VKE) مراحل زیر را دنبال کنید.
- به کنترل پنل رجیستری کانتینر نگارنوین خود دسترسی پیدا کنید.
- به برگه Docker/Kubernetes بروید و روی Generate Kubernetes YAML کلیک کنید تا یک رجیستری جدید برای پیکربندی منابع مخفی ایجاد شود.
ایجاد و نصب برنامه وب پایتون - یک فایل منبع مخفی جدید ایجاد کنید
secret.yaml. کنسولکپی$ nano secret.yaml
- پیکربندی YAML رجیستری کانتینر نگارنوین تولید شده خود را به فایلی مشابه فایل زیر اضافه کنید:
apiVersion: v1 kind: Secret metadata: name: negarnovin-cr-credentials data: .dockerconfigjson: example-json type: kubernetes.io/dockerconfigjsonفایل را ذخیره کنید و ببندید.
- راز را در کلاستر خود مستقر کنید. کنسولکپی
$ kubectl apply -f secret.yaml
- منابع کلاستر را مشاهده کنید تا مطمئن شوید که اعتبارنامه های رجیستری شما آماده استفاده هستند. کنسولکپی
$ kubectl get secret
خروجی:
NAME TYPE DATA AGE negarnovin-cr-credentials kubernetes.io/dockerconfigjson 1 29m - یک فایل منبع Deployment جدید ایجاد کنید
deployment.yamlتا نحوه اجرای برنامه خود را در یک pod شرح دهید. کنسولکپی$ nano deployment.yaml
- پیکربندی های زیر را به فایل اضافه کنید. آن را
sjc.negarnovin.com/pythonregistry/python-app:latestبا مخزن رجیستری NegarNovin Container واقعی خود جایگزین کنید. yamlکپیkind: Deployment apiVersion: apps/v1 metadata: name: python-app spec: replicas: 3 selector: matchLabels: app: python-app template: metadata: labels: app: python-app spec: containers: - name: python-app image: sjc.negarnovin.com/pythonregistry/python-app:latest ports: - containerPort: 8000 imagePullSecrets: - name: negarnovin-cr-credentials
فایل را ذخیره کنید و ببندید.
- استقرار را روی کلاستر خود اعمال کنید. کنسولکپی
$ kubectl apply -f deployment.yaml
- برای تأیید در دسترس بودن منبع جدید، استقرارهای کلاستر را مشاهده کنید. کنسولکپی
$ kubectl get deployment
خروجی:
NAME READY UP-TO-DATE AVAILABLE AGE python-app 3/3 3 3 21s - برای تأیید تمام پادهای مرتبط با استقرار خود، پادهای کلاستر را مشاهده کنید. کنسولکپی
$ kubectl get pods
خروجی:
NAME READY STATUS RESTARTS AGE python-app-6cb76cfc8d-5wjbf 1/1 Running 0 35s python-app-6cb76cfc8d-tphrx 1/1 Running 0 35s python-app-6cb76cfc8d-txk5p 1/1 Running 0 35s
دسترسی خارجی به برنامه پایتون را به طور ایمن در معرض دید قرار دهید
برای اینکه برنامه پایتون خود را برای دسترسی خارجی با استفاده از خوشه negarnovin Kubernetes Engine (VKE) خود در معرض نمایش قرار دهید، یک کنترل کننده Ingress نصب کنید تا سرویس برنامه شما را به یک نام دامنه نگاشت کند. این کنترل کننده به طور ایمن تمام درخواست های برنامه را از نام دامنه شما به سرویس برنامه پایتون backend هدایت می کند. برای نمایش برنامه در خوشه VKE خود، مراحل زیر را دنبال کنید.
- مخزن ورودی NGINX را به منابع Helm خود اضافه کنید. کنسولکپی
$ helm repo add ingress-nginx https://kubernetes.github.io/ingress-nginx
- فهرست مخزن Helm را به روزرسانی کنید. کنسولکپی
$ helm repo update
- NGINX Ingress Controller را با استفاده از Helm روی کلاستر خود نصب کنید. کنسولکپی
$ helm install nginx-ingress ingress-nginx/ingress-nginx --set controller.publishService.enabled=true
- حداقل
3چند دقیقه صبر کنید تا Nginx Ingress Controller تمام CRD های لازم را نصب کند. سپس، سرویس های کنترلر را مشاهده کنید تا آدرس IP اختصاص داده شده به Load Balancer را تأیید کنید. کنسولکپی$ kubectl get service --namespace default nginx-ingress-ingress-nginx-controller
خروجی:
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE nginx-ingress-ingress-nginx-controller LoadBalancer 10.98.94.149 192.0.2.100 80:32671/TCP,443:32325/TCP 2m58sبرای دسترسی خارجی به سرویس های کلاستر خود، مقدار EXTERNAL-IP کنترلر Ingress را یادداشت کنید .
- یک رکورد دامنه A جدید که به آدرس IP عمومی کنترل کننده Ingress اشاره می کند، تنظیم کنید . برای مثال،
app.example.com. - یک فایل منبع سرویس پایتون جدید ایجاد کنید
service.yamlکنسولکپی$ nano service.yaml
- محتویات زیر را به فایل اضافه کنید. یاملکپی
apiVersion: v1 kind: Service metadata: name: python-app spec: selector: app: python-app ports: - protocol: TCP port: 80 targetPort: 8000
فایل را ذخیره کنید و ببندید.
پیکربندی سرویس فوق، تمام درخواست های شبکه روی پورت HTTP را
80به پورت برنامه پایتون شما ارسال می کند8000. - سرویس را روی کلاستر خود اعمال کنید. کنسولکپی
$ kubectl apply -f service.yaml
- یک فایل منبع Ingress جدید
ingress.yamlبرای نمایش سرویس برنامه پایتون ایجاد کنید. کنسولکپی$ nano ingress.yaml
- محتویات زیر را به فایل اضافه کنید.
app.example.comدامنه واقعی خود را جایگزین کنید. یاملکپیapiVersion: networking.k8s.io/v1 kind: Ingress metadata: name: nginx-ingress namespace: default annotations: kubernetes.io/ingress.class: nginx spec: rules: - host: app.example.com http: paths: - backend: service: name: python-app port: number: 80 path: / pathType: Prefix
فایل را ذخیره کنید و ببندید.
پیکربندی Ingress فوق، تمام درخواست های ریشه را از
app.example.comسرویس برنامه پایتون شما روی پورت ارسال می کند80. - منبع Ingress را روی کلاستر خود اعمال کنید. کنسولکپی
$ kubectl apply -f ingress.yaml
- اشیاء Ingress کلاستر را مشاهده کنید و تأیید کنید که منبع جدید در دسترس است. کنسولکپی
$ kubectl get ingress
توضیح کدبتاطراحی شده توسط Negarnovin Agent
خروجی:
NAME CLASS HOSTS ADDRESS PORTS AGE nginx-ingress nginx app.example.com 192.0.2.100 80 32s - برای آزمایش دسترسی به برنامه، با استفاده از یک مرورگر وب مانند فایرفاکس به دامنه خود دسترسی پیدا کنید.
نتیجه گیری
شما یک برنامه پایتون را کانتینرایز کرده اید و آن را در مخزن رجیستری کانتینر نگارنوین برای استقرار در یک خوشه VKE ذخیره کرده اید. ارسال برنامه های وب پایتون به عنوان تصاویر کانتینر، مدیریت و ارتقاء کارآمد اجزای برنامه را برای استقرار در محیط های مختلف امکان پذیر می کند.