প্রকল্প সম্পর্কে

Shelter একটি ওপেন-সোর্স ডিপ্লয়মেন্ট ইনফ্রাস্ট্রাকচার টুল যা একটি একক VPS-কে একটি পূর্ণাঙ্গ ডিপ্লয়মেন্ট প্ল্যাটফর্মে রূপান্তরিত করে। এটি ডেভেলপার এবং অপারেটরদের লক্ষ্য করে যারা ম্যানেজড হোস্টিং প্ল্যাটফর্মের সুবিধা চান, সাথে সাথে তাদের অবকাঠামো, ডেটা এবং ক্রেডেনশিয়ালের সম্পূর্ণ মালিকানা ধরে রাখতে চান। **ডিপ্লয়মেন্ট সোর্স:** Shelter একাধিক ডিপ্লয়মেন্ট সোর্স সমর্থন করে, যার মধ্যে রয়েছে GitHub রিপোজিটরি (সর্বনিম্ন সুযোগের GitHub অ্যাপের মাধ্যমে, ঐচ্ছিক push-to-deploy সহ), পাবলিক HTTPS Git URL, জিপ ফাইল আপলোড এবং লোকাল ফোল্ডার আপলোড। সোর্স আপলোডগুলো খণ্ডে বিভক্ত, বৈধতা যাচাই করা হয় এবং সংস্করণ নির্ধারণ করা হয়। **বিল্ড এবং অ্যাক্টিভেশন:** প্ল্যাটফর্ম সোর্স থেকে কন্টেইনার ইমেজ তৈরি করে, প্রজেক্ট-আইসোলেটেড নেটওয়ার্কে ক্যান্ডিডেট হেলথ চেক চালায় এবং যাচাইয়ের পরেই প্রোডাকশন ট্রাফিক সুইচ করে। বিল্ডের জন্য ডেডিকেটেড Docker BuildKit বিল্ডার ব্যবহার করা হয়, যেখানে মেমোরি, সোয়াপ, CPU, PID এবং সর্বোচ্চ সমান্তরালতার জন্য কনফিগারযোগ্য রিসোর্স সীমা থাকে। **রাউটিং এবং নেটওয়ার্কিং:** ডোমেইন এবং অ্যাডমিন প্যানেল ম্যানেজড Cloudflare Tunnel-এর মাধ্যমে প্রকাশিত হয়, ফলে পাবলিক হোস্ট পোর্টের প্রয়োজন হয় না। Traefik HTTP রাউটিং পরিচালনা করে এবং প্রজেক্ট-ভিত্তিক ব্রিজ নেটওয়ার্ক প্রজেক্ট আইসোলেশন নিশ্চিত করে। TLS ক্লাউডফ্লেয়ার এজে শেষ হয়। **Cloudflare ইন্টিগ্রেশন:** Cloudflare-এর সাথে গভীর ইন্টিগ্রেশন রয়েছে OAuth অথেনটিকেশন, টানেল ম্যানেজমেন্ট, DNS, জোন ম্যানেজমেন্ট, হোস্টনেম উপলব্ধতা পরীক্ষা এবং প্রতিটি প্রজেক্টের জন্য মাল্টি-ডোমেইন সমর্থনে। API টোকেন এবং OAuth উভয় ফ্লো সমর্থিত। **অপারেটর ফিচার:** ডিপ্লয়মেন্ট লগ, রোলব্যাক, প্রজেক্ট CRUD, এনক্রিপ্ট করা পরিবেশ ভেরিয়েবল, রিসোর্স সীমা, লাইভ রানটাইম লগ এবং প্রতিটি প্রজেক্টের জন্য অবজারভেবিলিটি সহ ড্যাশবোর্ড। সফল ওয়েবসাইট ডিপ্লয়মেন্টের জন্য স্বয়ংক্রিয় স্ক্রিনশট প্রিভিউ। **অটোমেশন:** সীমিত মেয়াদ এবং সুযোগের ব্যক্তিগত অ্যাক্সেস টোকেন, OpenAPI স্পেসিফিকেশন সহ নথিভুক্ত HTTP API এবং প্রোগ্রাম্যাটিক নিয়ন্ত্রণের জন্য একটি ইনস্টলযোগ্য CLI টুল। **নিরাপত্তা:** আর্কিটেকচার API (Docker সকেট ছাড়া) এবং ওয়ার্কার (Docker সকেট অ্যাক্সেস) আলাদা করে, এনক্রিপ্ট করা সিক্রেট, ড্রপড ক্যাপাবিলিটি সহ ডিসপোজেবল হেলথ-চেক কন্টেইনার ব্যবহার করে এবং একটি থ্রেট মডেল রয়েছে যা স্বীকার করে যে এটি প্রতিকূল মাল্টি-টেন্যান্ট পরিস্থিতির পরিবর্তে বিশ্বস্ত অ্যাপ্লিকেশন কোডের জন্য ডিজাইন করা হয়েছে। **ইনস্টলেশন:** Ubuntu 24.04/26.04 LTS VPS-এর জন্য বুটস্ট্র্যাপ স্ক্রিপ্ট, স্বয়ংক্রিয় ডিপেন্ডেন্সি ইনস্টলেশন, নন-ইন্টারঅ্যাক্টিভ প্রভিশনিং সমর্থন এবং স্বাস্থ্য পরীক্ষার জন্য ডক্টর কমান্ড। প্যানেল বুটস্ট্র্যাপ এবং SSH-এর মাধ্যমে জরুরি অ্যাক্সেসের জন্য 127.0.0.1-এ বাউন্ড থাকে। প্রকল্পটি AGPL-3.0-only লাইসেন্সের অধীনে এবং বর্তমানে MVP অবস্থায় রয়েছে। এটি TypeScript, Node.js 24+, Docker Compose v2 এবং Cloudflare Tunnel দিয়ে নির্মিত।