®Zinnector کے ساتھ تعیناتی: لنک کریں، چیک کریں، پش کریں

ایک مقامی پروجیکٹ سے لائیو سائٹ تک: API کی کے ساتھ سائن ان کریں، پروجیکٹ کو ہوسٹنگ سلاٹ سے لنک کریں، پری فلائٹ پڑھیں جو آپ کے PHP، ڈسک اور WordPress کا سلاٹ سے موازنہ کرتی ہے، اور پش کریں—اس کے علاوہ کچھ غلط ہونے پر ری ڈیپلائس، ڈیپلائے ہسٹری اور بلڈ لاگز بھی دستیاب ہیں۔

ایک بار جب کوئی پروجیکٹ مقامی طور پر چلنے لگتا ہے، تو چار کمانڈز اسے Zinn Digital® ہوسٹنگ پر براہِ راست سائٹ تک لے جاتی ہیں: سائن ان کریں، پروجیکٹ کو ہوسٹنگ سلاٹ سے منسلک کریں، پری فلائٹ پڑھیں، اور پش کریں۔ یہ مضمون ان میں سے ہر ایک کے طریقہ کار، اس کے آؤٹ پٹ، اور بعد میں استعمال ہونے والی کمانڈز—دوبارہ ڈیپلائے، ڈیپلائمنٹ ہسٹری، اور بلڈ لاگز—کی تفصیل فراہم کرتا ہے۔

API کی کے ذریعے سائن ان کریں

ڈیش بورڈ میں Settings ← API keys کے تحت ایک کی (key) بنائیں، پھر:

zinnector login

کی (key) کو پرامپٹ پر ٹائپ کیا جاتا ہے—یہ کمانڈ لائن پر کبھی بھی قبول نہیں کی جاتی، تاکہ یہ آپ کی شیل ہسٹری یا پروسیس لسٹنگ میں محفوظ نہ ہو سکے۔ CI میں، اسے پائپ (pipe) کریں: echo "$ZINN_API_KEY" | zinnector login --profile ci، یا ZINNECTOR_TOKEN سیٹ کریں اور login کو مکمل طور پر چھوڑ دیں۔ کی (key) کو محفوظ کرنے سے پہلے اس کی توثیق کی جاتی ہے، اور اسے فائل موڈ 600 کے ساتھ محفوظ کیا جاتا ہے۔ zinnector whoami --scopes دکھاتا ہے کہ آپ کس آرگنائزیشن میں سائن ان ہیں اور کی (key) کے پاس کون سی اجازتیں ہیں؛ سینڈ باکس کی کو الگ سے لیبل کیا جاتا ہے۔

پروجیکٹ کو ایک سلاٹ سے منسلک کریں

zinnector link                                   # فہرست میں سے ایک سائٹ منتخب کریں
zinnector link example.com --repo acme/site --branch main

link سائٹ کی آئی ڈی کو zinnector.json میں لکھتا ہے اور، جب تک کہ آپ --no-repo پاس نہ کریں، پروجیکٹ کے git ریموٹ کو پلیٹ فارم پر موجود سائٹ سے منسلک کر دیتا ہے تاکہ پش کرنے پر یہ ڈیپلائے ہو جائے۔ zinnector.json کو کمٹ (commit) کریں: اس کے بعد اگر کوئی ساتھی اس ریپوزیٹری کو کلون کرتا ہے تو وہ بغیر بتائے اسی جگہ ڈیپلائے کر سکتا ہے۔ اس میں کوئی خفیہ معلومات نہیں ہوتی ہیں۔

پری فلائٹ پڑھیں

zinnector check

یہ وہ بنیادی کمانڈ ہے جس کے لیے CLI موجود ہے۔ یہ آپ کے پروجیکٹ کا اس سلاٹ کے ساتھ موازنہ کرتی ہے جس پر اسے ڈیپلائے کیا جانے والا ہے اور ہر عدم مطابقت—اور ہر وہ موازنہ جو یہ نہ کر سکی—کو پرنٹ کرتی ہے:

PHP ورژن، جس میں بڑے ورژن کے فرق کو high کا درجہ دیا جاتا ہے کیونکہ یہ سائٹ کو مکمل طور پر خراب کر سکتا ہے، جبکہ معمولی فرق کو کم درجہ دیا جاتا ہے، کیونکہ ہر چیز کو اہم قرار دینے سے لوگ تنبیہ کو نظر انداز کرنا سیکھ جاتے ہیں۔
کیا سلاٹ اس ورژن پر سوئچ کر سکتا ہے جس پر آپ نے بلڈ کیا ہے، کیا سلاٹ کا PHP انتقامی مدت (end of life) سے گزر چکا ہے، اور کیا مشین نے اس ورژن کو لاگو کر دیا ہے یا صرف اطلاع دی گئی ہے۔
سلاٹ پر درحقیقت باقی ماندہ ڈسک اور inode کی گنجائش کے مقابلے میں آپ کے پروجیکٹ کا سائز اور فائلوں کی تعداد—ایک WordPress ٹری اپنی ڈسک کی حد تک پہنچنے سے پہلے ہی فائلوں سے خالی ہو سکتا ہے۔
دونوں اطراف میں WordPress ورژنز، کیا سلاٹ کی پروویژننگ مکمل ہو چکی ہے، اور کیا پش کرنے کے لیے ریپوزیٹری منسلک ہے۔

یہ تنبیہ کرتا ہے؛ کبھی روکتا نہیں ہے۔ ہر نتیجے کو zinnector push --force کے ذریعے نظر انداز کیا جا سکتا ہے، کیونکہ آپ اپنی سائٹ کے بارے میں ایسی باتیں جانتے ہیں جو ایک چیکر نہیں جانتا۔ جس موازنے کو انجام نہ دیا جا سکا ہو اسے unknown کے طور پر رپورٹ کیا جاتا ہے، کبھی پاس کے طور پر نہیں، اور خلاصہ ہمیشہ بتاتا ہے کہ ایسے کتنے موازنے تھے۔ ڈیفالٹ کے طور پر مقامی PHP ورژن وہ ہوتا ہے جو zinnector.json میں اعلان کیا گیا ہو؛ --probe مقامی رن ٹائم کو بوٹ کرتا ہے اور اس کے بجائے اس کی پیمائش کرتا ہے۔ --strict نامعلوم نتائج پر بھی غیر صفر (non-zero) کے ساتھ ایگزٹ کرتا ہے، جو ایک CI گیٹ کے لیے مطلوب ہوتا ہے۔

پش کریں

zinnector push

push پری فلائٹ چلاتا ہے، آپ کے کمٹس کو پش کرتا ہے، ڈیپلائمنٹ کو متحرک (trigger) کرتا ہے اور اس کی تکمیل تک نگرانی کرتا ہے، اور حتمی سٹیٹس اور ڈیپلائے شدہ کمٹ کو پرنٹ کرتا ہے۔ --dry-run ڈیپلائمنٹ کے علاوہ باقی سب کچھ کرتا ہے؛ --no-wait اسے متحرک کرتا ہے اور باہر نکل جاتا ہے؛ --no-git بغیر پش کیے اس چیز کو ڈیپلائے کر دیتا ہے جو پلیٹ فارم پر پہلے سے موجود ہے۔ اگر ڈیپلائے شدہ کمٹ وہ نہیں ہے جو ابھی پش کیا گیا تھا، تو یہ اس کی اطلاع دیتا ہے۔

جب کچھ غلط ہو جائے

zinnector deploys example.com        # ڈیپلائمنٹ ہسٹری — سٹیٹس، کمٹ، ٹریگر، پیغام
zinnector logs example.com --build   # حالیہ ترین ڈیپلائمنٹ کا بلڈ لاگ
zinnector logs example.com --error   # سائٹ کا ایرر لاگ
zinnector deploy example.com         # اسے دوبارہ ڈیپلائے کریں جو پلیٹ فارم پر پہلے سے موجود ہے
zinnector ai "why is my deploy failing?"

zinnector ai پلیٹ فارم پر آپ کے اپنے اکاؤنٹ کے مطابق چلتا ہے، لہذا وہ وہی ڈیپلائمنٹ ہسٹری اور لاگز دیکھ سکتا ہے۔ پروجیکٹ کے اندر سے یہ پروجیکٹ کی ساخت—ڈائریکٹری کے نام، ورژنز اور سائٹ آئی ڈی—بھیجتا ہے اور فائل کے مندرجات کبھی نہیں بھیجتا۔