پرش به مطلب اصلی

راهنمای راه‌اندازی پروژه با استفاده از فایل فشرده

این راهنما شما را در فرآیند راه‌اندازی پروژه با استفاده از فایل فشرده هدایت می‌کند. لطفاً مراحل زیر را با دقت دنبال کنید.

اخطار

اطمینان حاصل کنید که فایل requirements.txt در پروژه شما موجود است. در صورت عدم وجود، می‌توانید با دستور

pip freeze > requirements.txt

آن را ایجاد کنید.

توجه

اگر برنامه شما نیاز به نصب برنامه‌های جانبی دارد (مانند ffmpeg یا mysql-client)، دستورات نصب را در فایل run.sh بنویسید و این فایل را در فولدر اصلی پروژه خود قرار دهید

نمونه فایل run.sh:

  #!/bin/bash

  #ffmpeg (debian package)
  sudo apt install -y ffmpeg

  # mysql
  sudo apt install -y gcc build-essential default-libmysqlclient-dev

فشرده‌سازی پروژه​

برای فشرده سازی فایل در سیستم عامل های لینوکسی مینوانید از دستور زیر نیز استفاده کنید:

zip -r project.zip project_dir
توجه

توجه فرمایید فرمت فایل فشرده شما حتما zip باشد و از هر گونه فرمت های دیگر فشرده سازی (مثل rar,gz,7z) برای بارگذاری در کوبار خودداری فرمایید.

1. تنظیمات اولیه​

تنظیمات اولیه Python

نام اپلیکیشن​

ابتدا، نام مناسبی برای اپلیکیشن خود انتخاب کنید. این نام به عنوان شناسه در دامنه پروژه شما استفاده خواهد شد.

توجه
  • از حروف کوچک و فقط از - به عنوان فاصله گذار بین کلمات استفاده کنید
  • نام اپلیکیشن را پس از ساخت اپ نمی توانید تغییر دهید.

ورژن پایتون​

ورژن پایتون مورد استفاده در پروژه خود را انتخاب کنید. می‌توانید از لیست موجود انتخاب کنید یا به صورت دستی وارد نمایید.توجه فرمایید نسخه پایتونی که از آن استفاده می نمایید در مخزن داکر (dockerhub) و یا سایر مخازن مربوط به داکر موجود باشد.

پس از تکمیل این مرحله، گزینه "بعدی" را انتخاب کنید.

2.تنظیمات پیشرفته (اختیاری)​

تنظیمات پیشرفته Python

در این بخش می‌توانید تنظیمات پیشرفته‌تری را اعمال کنید:

ساخت​

کامند ران​

کوبار به صورت پیشفرض از 'gunicorn' برای اجرا کردن برنامه شما استفاده میکند. اگر از برنامه شما با gunicorn سازگاری ندارد یا کامند دیگری برای اجرای سرویس خود میخواهید استفاده کنید میتوانید در این محل وارد نمایید.

پورت​

شماره پورتی که برنامه شما روی آن اجرا خواهد شد را مشخص کنید.

توجه

  • پس از راه‌اندازی اولیه، امکان تغییر پورت وجود دارد

  • اگر دستوری در کامند ران وارد کردید توجه کنید در اپلیکیشن شما باید روی ادرس 0.0.0.0 و پورت مد نظر شما listen کند.

زمانبندی منابع​

دیسک​

متغیر های محیطی​

3. انتخاب پلن​

انتخاب پلن Python

در این مرحله، پلن مورد نظر خود را انتخاب کنید. می‌توانید از لیست موجود انتخاب کنید یا به صورت دستی تنظیم نمایید .

رپلیکا​

تعداد رپلیکا (نسخه‌های اجرایی) برنامه خود را مشخص کنید. این تعداد بر عملکرد و دسترس‌پذیری برنامه شما تأثیر می‌گذارد.

اهمیت تعداد رپلیکا​

  • مقیاس‌پذیری: افزایش توان پردازشی با افزایش تعداد رپلیکا
  • دسترس‌پذیری بالا: حفظ عملکرد در صورت از کار افتادن یک نمونه
  • توزیع بار: تقسیم بار بین چندین نمونه

.پس از انتخاب پلن مورد نظر، گزینه ساخت اپ را انتخاب کنید

4. بارگذاری فایل​

بارگذاری فایل Python

پس از ساختن اپ پایتونی خود، فایل فشرده پروژه خود را با کلیک بر روی دکمه "آپلود فایل" بارگذاری کنید. و منتظر بیلد شدن پروژه باشید.

5. مدیریت پروژه​

مدیریت پروژه Python

پس از بیلد شدن پروژه، می‌توانید از بخش "مدیریت پروژه"، پروژه خود را مدیریت کنید. در این بخش، امکانات مدیریتی پروژه در اختیار شما قرار می‌گیرد:

  • بررسی وضعیت پروژه

  • نحوه اتصال به پروژه

  • بررسی منابع برنامه

  • تعداد Replica

  • مدیریت پورت

  • تغییر نام داکرفایل (در صورت نیاز)

    نکته

    اگر پروژه شما نیاز به تنظیمات خیلی خاصی دارد، می‌توانید Dockerfile اختصاصی خود را بسازید. برای اطلاعات بیشتر به این لینک مراجعه کنید.

  • تغییر کامند ران

  • ری‌استارت پروژه

با استفاده از این امکانات، می‌توانید پروژه خود را به طور مؤثر مدیریت و نگهداری کنید.