শুরু করুন
৫ মিনিটে প্রথম অ্যাপ
নিজস্ব Dockerfile বা সার্ভার সেটআপ ছাড়াই Git রিপোজিটরি অথবা জিপ ফাইল থেকে আপনার প্রথম অ্যাপ লাইভ করুন।
এই গাইড শেষ হলে আপনার অ্যাপটি একটি HTTPS ঠিকানায় চালু থাকবে। চাইলে প্রতিবার git push করার সাথে সাথে নতুন ভার্সন স্বয়ংক্রিয়ভাবে ডিপ্লয় হওয়ার ব্যবস্থাও করতে পারবেন।
যা প্রয়োজন
- একটি Meghly অ্যাকাউন্ট (প্যানেলে লগইন করার জন্য)।
- আপনার প্রজেক্টের কোড — GitHub, GitLab বা যেকোনো Git সার্ভারে রাখা রিপোজিটরি, অথবা একটি
.zipফাইল। - কোডটি আপনার নিজের কম্পিউটারে ঠিকঠাক চলতে হবে। আলাদা কোনো কনফিগারেশন লেখার প্রয়োজন নেই; কীভাবে বিল্ড ও চালু করতে হবে, Meghly নিজেই তা বুঝে নেয়।
১. নতুন অ্যাপ তৈরি শুরু করুন
প্যানেলের বাঁ দিকের মেনু থেকে Apps → New app অপশনে যান। এরপর তিনটি ধাপ দেখতে পাবেন: Source, Name and size এবং Summary।
২. কোডের উৎস নির্বাচন (Source)
Git repository বেছে নিয়ে রিপোজিটরির ঠিকানা ও branch-এর নাম দিন:
https://github.com/you/shop.git- Public রিপোজিটরি:
https://ঠিকানাই যথেষ্ট। - Private রিপোজিটরি: SSH ঠিকানা দিন (
git@github.com:you/shop.git)। অ্যাপ তৈরি হওয়ার পর প্যানেল একটি deploy key দেখাবে। সেটি GitHub-এ রিপোজিটরির Settings → Deploy keys অংশে যুক্ত করুন (শুধু read access দিলেই চলবে)।
Git ব্যবহার না করলে Zip upload বেছে নিন। অ্যাপ তৈরির পর অ্যাপের Deploy বাটন থেকে জিপ ফাইল আপলোড করতে পারবেন (সর্বোচ্চ ২ GB)।
WordPress, Laravel বা Ghost-এর মতো প্রস্তুত অ্যাপ চালাতে চাইলে App Store থেকে এক ক্লিকেই ইনস্টল করতে পারেন — কোনো কোডের প্রয়োজন হবে না।
৩. নাম ও সাইজ নির্ধারণ (Name and size)
- App name: ছোট হাতের অক্ষর, সংখ্যা ও ড্যাশ ব্যবহার করুন (যেমন
shop,billing-api)। এই নামটিই অ্যাপের ঠিকানায় ব্যবহৃত হবে। - What is it? Meghly সাধারণত নিজেই অ্যাপের ধরন শনাক্ত করে; তবে চাইলে আপনি ভাষা, ভার্সন ও ফ্রেমওয়ার্ক নির্দিষ্ট করে দিতে পারেন।
- Size: অ্যাপটি কতটুকু মেমোরি পাবে, তা নির্ধারণ করুন।
| সাইজ | মেমোরি | যাদের জন্য উপযুক্ত |
|---|---|---|
| Small | 256 MB | ছোট ওয়েবসাইট বা worker |
| Medium | 512 MB | বেশিরভাগ ওয়েবসাইট ও API |
| Large | 1 GB | বেশি ট্রাফিকের সাইট, .NET বা Laravel অ্যাপ |
| Extra large | 2 GB | ভারী অ্যাপ্লিকেশন |
পরবর্তীতে যেকোনো সময় সাইজ পরিবর্তন করা যায়।
৪. যাচাই করে অ্যাপ তৈরি (Summary)
সব তথ্য ঠিক থাকলে অ্যাপটি তৈরি করুন। সাথে সাথেই প্রথম ডিপ্লয় শুরু হয় এবং ডিপ্লয়মেন্ট পেজটি খুলে যায়। সেখানে প্রতিটি ধাপ লাইভ দেখতে পাবেন:
- Clone — রিপোজিটরি থেকে কোড নামানো হয়।
- Detect — কোড পরীক্ষা করে জানানো হয় কী পাওয়া গেছে: ফ্রেমওয়ার্ক, ভার্সন ও পোর্ট।
- Build — অ্যাপের ইমেজ তৈরি হয় (১৫ মিনিটের বেশি লাগলে বিল্ড বাতিল হয়)। পুরো বিল্ড লগ এখানে দেখা যায়।
- Release — ডেটাবেস মাইগ্রেশন থাকলে এই ধাপে একবার রান হয়।
- Start → Health check → Route — নতুন ভার্সন চালু হয়, হেলথ চেক সফল হলে তবেই ট্রাফিক পায়, এরপর পুরনো ভার্সনটি বন্ধ করা হয়।
৫. অ্যাপটি ব্রাউজারে খুলুন
ডিপ্লয় শেষ হলে অ্যাপের Overview পেজে এর ঠিকানা দেখতে পাবেন — HTTPS-সহ, সার্টিফিকেট স্বয়ংক্রিয়ভাবে যুক্ত হয়। ঠিকানায় ক্লিক করলেই আপনার অ্যাপ খুলে যাবে।
প্রতিটি ডিপ্লয়ের তথ্য Deployments ট্যাবে সংরক্ষিত থাকে, এবং এক ক্লিকেই যেকোনো আগের ডিপ্লয়ে ফিরে যাওয়া যায়।
প্রতিটি push-এ স্বয়ংক্রিয় ডিপ্লয়
অ্যাপের General পেজের Auto-deploy on push অংশে একটি Webhook URL ও একটি Secret পাবেন। GitHub-এ রিপোজিটরির Settings → Webhooks → Add webhook অংশে গিয়ে নিচের তথ্যগুলো দিন:
- Payload URL: প্যানেলে দেখানো Webhook URL
- Content type:
application/json - Secret: প্যানেলে দেখানো Secret
এরপর থেকে ওই branch-এ প্রতিবার push করলে Meghly স্বয়ংক্রিয়ভাবে নতুন ভার্সন ডিপ্লয় করবে।
সচরাচর সমস্যা ও সমাধান
| যে সমস্যা বা এরর দেখছেন | কারণ ও সমাধান |
|---|---|
| Detect ধাপে অ্যাপ শনাক্ত করতে পারছে না | রিপোজিটরির রুট ফোল্ডারে প্রজেক্ট ফাইল (*.csproj, package.json, requirements.txt, composer.json) আছে কি না দেখুন; না থাকলে What is it? অংশে ভাষা নির্দিষ্ট করে দিন। |
| বিল্ড ব্যর্থ হচ্ছে | বিল্ড লগের শেষের লাইনগুলো পড়ুন — সাধারণত নিজের কম্পিউটারে যে এরর আসত, এখানেও সেটিই দেখা যায়। |
| হেলথ চেক ব্যর্থ হচ্ছে | অ্যাপটি PORT ভেরিয়েবলে দেওয়া পোর্টে রান করছে কি না নিশ্চিত করুন। বিস্তারিত দেখুন অ্যাপ কীভাবে চলে। |
| ডেটাবেসে কানেক্ট হচ্ছে না | ডেটাবেসটি অ্যাপের সাথে যুক্ত আছে কি না এবং কোডে কানেকশন তথ্য এনভায়রনমেন্ট ভেরিয়েবল থেকে পড়া হচ্ছে কি না তা যাচাই করুন। |
পরবর্তী ধাপ
- অ্যাপ কীভাবে চলে — worker, cron, মাইগ্রেশন ও রোলব্যাক।
- Environment variable — API key ও সিক্রেট নিরাপদে রাখার নিয়ম।
- ডোমেইন ও HTTPS —
shop.com.bd-এর মতো নিজস্ব ডোমেইন যুক্ত করা। - ফ্রেমওয়ার্ক গাইড — আপনার ফ্রেমওয়ার্কের জন্য আলাদা নির্দেশনা।
আটকে গেছেন?
আমাদের ইঞ্জিনিয়ারদের সাথে সরাসরি কথা বলুন — ফোন বা ইমেইলে, বাংলায়।