Zinnector® ဖြင့် အသုံးချခြင်း- ချိတ်ဆက်ပါ၊ စစ်ဆေးပါ၊ တွန်းပို့ပါ

ပရောဂျက်တစ်ခုသည် စက်တွင်း၌ စတင်လည်ပတ်နိုင်ပြီဆိုပါက Zinn Digital® ဟိုးစတင်းပေါ်ရှိ တိုက်ရိုက်ဆိုက်တစ်ခုသို့ လွှင့်တင်ရန် ညွှန်ကြားချက်လေးခု လိုအပ်ပါသည်၊ ၎င်းတို့မှာ- အကောင့်ဝင်ရောက်ခြင်း၊ ပရောဂျက်ကို ဟိုးစတင်းစလော့တစ်ခုနှင့် ချိတ်ဆက်ခြင်း၊ စတင်ခြင်းမပြုမီ ကြိုတင်စစ်ဆေးမှု (pre-flight) ကို ဖတ်ရှုခြင်းနှင့် push ပြုလုပ်ခြင်းတို့ ဖြစ်ပါသည်။ ဤဆောင်းပါးသည် တစ်ခုချင်းစီ၏ လုပ်ဆောင်ပုံ၊ ၎င်းတို့ဖော်ပြပေးသည့် အချက်အလက်များနှင့် ယင်းနောက်တွင် သင်အသုံးပြုမည့် ညွှန်ကြားချက်များဖြစ်သော ပြန်လည်လွှင့်တင်ခြင်းများ (redeploys)၊ လွှင့်တင်မှုမှတ်တမ်း (deploy history) နှင့် တည်ဆောက်မှုမှတ်တမ်းများ (build logs) အကြောင်းကို ရှင်းပြပေးထားပါသည်။

API ကီးဖြင့် အကောင့်ဝင်ရောက်ခြင်း

ဒက်ရှ်ဘုတ်ရှိ Settings → API keys အောက်တွင် ကီးတစ်ခုကို ဖန်တီးပါ၊ ထို့နောက်-

zinnector login

ကီးကို prompt တွင် ရိုက်ထည့်ရပါသည် — command line ပေါ်တွင် လက်ခံခြင်း လုံးဝမရှိပါ၊ ထို့ကြောင့် ၎င်းသည် သင်၏ shell history သို့မဟုတ် လုပ်ငန်းစဉ်စာရင်း (process listing) အတွင်းသို့ မရောက်ရှိနိုင်ပါ။ CI တွင်ဖြစ်ပါက pipe ဖြင့် ထည့်သွင်းပါ- echo "$ZINN_API_KEY" | zinnector login --profile ci၊ သို့မဟုတ် ZINNECTOR_TOKEN ကို သတ်မှတ်ပြီး login ပြုလုပ်ခြင်းကို လုံးဝကျော်သွားနိုင်ပါသည်။ ကီးကို မသိမ်းဆည်းမီ စစ်ဆေးအတည်ပြုပြီး file mode 600 ဖြင့် သိမ်းဆည်းပါသည်။ zinnector whoami --scopes သည် သင်မည်သည့်အဖွဲ့အစည်းသို့ ဝင်ရောက်ထားကြောင်းနှင့် ကီးတွင် မည်သည့်ခွင့်ပြုချက်များ ပါရှိကြောင်းကို ပြသပေးသည်၊ sandbox ကီးကိုလည်း sandbox အဖြစ် သတ်မှတ်ဖော်ပြထားပါသည်။

ပရောဂျက်ကို စလော့တစ်ခုနှင့် ချိတ်ဆက်ခြင်း

zinnector link                                   # စာရင်းထဲမှ ဆိုက်တစ်ခုကို ရွေးချယ်ပါ
zinnector link example.com --repo acme/site --branch main

link သည် ဆိုက်၏ id ကို zinnector.json ထဲသို့ ရေးသားထည့်သွင်းပေးပြီး သင်သည် --no-repo ကို မသုံးထားပါက ပရောဂျက်၏ git remote ကို ပလက်ဖောင်းပေါ်ရှိ ဆိုက်နှင့် ချိတ်ဆက်ပေးသဖြင့် push ပြုလုပ်လိုက်သည်နှင့် လွှင့်တင်ပေးမည် ဖြစ်ပါသည်။ zinnector.json ကို commit ပြုလုပ်ပါ- ထိုအခါ သိုလှောင်ခန်း (repository) ကို ကူးယူအသုံးပြုသူ လုပ်ဖော်ကိုင်ဖက်သည်လည်း မည်သို့မျှ ညွှန်ကြားစရာမလိုဘဲ မူလနေရာတူသို့ပင် လွှင့်တင်နိုင်မည် ဖြစ်ပါသည်။ ၎င်းတွင် လျှို့ဝှက်ချက် တစ်စုံတစ်ရာ မပါဝင်ပါ။

စတင်ခြင်းမပြုမီ ကြိုတင်စစ်ဆေးမှုကို ဖတ်ရှုခြင်း

zinnector check

ဤညွှန်ကြားချက်သည် CLI တည်ရှိနေရခြင်း၏ အဓိကရည်ရွယ်ချက် ဖြစ်ပါသည်။ ၎င်းသည် သင်၏ပရောဂျက်ကို လွှင့်တင်တော့မည့် စလော့နှင့် နှိုင်းယှဉ်ပေးပြီး မကိုက်ညီမှုတိုင်းနှင့် မနှိုင်းယှဉ်နိုင်ခဲ့သည့် အချက်တိုင်းကို ထုတ်ဖော်ပြသပေးပါသည်-

• PHP ဗားရှင်း၊ major ဗားရှင်းကွာဟချက်သည် ဆိုက်ကို ပျက်စီးစေနိုင်ခြေ အမှန်တကယ်များပြားသောကြောင့် high အဖြစ် သတ်မှတ်ထားပြီး minor ကွာဟချက်ကိုမူ အဆင့်ပိုနိမ့်စွာ သတ်မှတ်ထားပါသည်၊ အဘယ်ကြောင့်ဆိုသော် အရာအားလုံးကို အရေးကြီးအဆင့်အဖြစ် သတ်မှတ်လိုက်ပါက သတိပေးချက်များကို လူများ လျစ်လျူရှုသွားတတ်သောကြောင့် ဖြစ်ပါသည်။
• စလော့သည် သင်တည်ဆောက်ထားသော ဗားရှင်းသို့ ပြောင်းလဲနိုင်ခြင်း ရှိမရှိ၊ စလော့၏ PHP သည် သက်တမ်းကုန်ဆုံးသွားခြင်း (past end of life) ရှိမရှိ၊ နှင့် အဆိုပါစက်သည် ဗားရှင်းကို လက်တွေ့အသုံးချပြီးပြီလား သို့မဟုတ် ညွှန်ကြားချက်သာ ရထားသေးသလား ဆိုသည့်အချက်။
• စလော့ပေါ်တွင် အမှန်တကယ် ကျန်ရှိနေသေးသော disk နှင့် inode ပမာဏအပေါ် မူတည်၍ သင်၏ပရောဂျက် အရွယ်အစားနှင့် ဖိုင်အရေအတွက် — WordPress ဖိုင်လမ်းကြောင်းတစ်ခုသည် ၎င်း၏ disk ကန့်သတ်ချက်အောက် များစွာလျော့နည်းနေသော်လည်း ဖိုင်အရေအတွက် ပြည့်သွားနိုင်ပါသည်။
• နှစ်ဖက်စလုံးရှိ WordPress ဗားရှင်းများ၊ စလော့သည် ပြင်ဆင်သတ်မှတ်ခြင်း ပြီးဆုံးပြီလား (finished provisioning)၊ နှင့် push ပြုလုပ်ရန် သိုလှောင်ခန်း ချိတ်ဆက်ထားခြင်း ရှိမရှိ စသည့်အချက်များ။

၎င်းသည် သတိပေးရုံသာ ဖြစ်ပြီး မည်သည့်အခါမျှ တားဆီးပိတ်ပင်ခြင်း မရှိပါ။ ရှာဖွေတွေ့ရှိချက်တိုင်းကို zinnector push --force ဖြင့် ကျော်လွှားဆောင်ရွက်နိုင်ပါသည်၊ အဘယ်ကြောင့်ဆိုသော် သင်၏ကိုယ်ပိုင်ဆိုက်အကြောင်းကို စစ်ဆေးပေးသည့်စနစ်ထက် သင်က ပိုမိုသိရှိထားသောကြောင့် ဖြစ်ပါသည်။ မနှိုင်းယှဉ်နိုင်ခဲ့သော အချက်တစ်ခုကို မည်သည့်အခါမျှ အောင်မြင်သည် (pass) ဟု အစီရင်ခံမည်မဟုတ်ဘဲ unknown အဖြစ်သာ အစီရင်ခံမည်ဖြစ်ပြီး မည်မျှရှိခဲ့သည်ကို အကျဉ်းချုပ်တွင် အမြဲတမ်း ဖော်ပြပေးပါသည်။ မူရင်းသတ်မှတ်ချက်အရ စက်တွင်း PHP ဗားရှင်းသည် zinnector.json တွင် ကြေညာထားသည့် ဗားရှင်းဖြစ်သည်၊ --probe သည် စက်တွင်း runtime ကို ဖွင့်လှစ်ပြီး ၎င်းအစား တိုင်းတာပေးပါသည်။ --strict သည် unknown များရှိပါကလည်း non-zero ဖြင့် ထွက်ခွာမည်ဖြစ်ပြီး ၎င်းမှာ CI gate တစ်ခု လိုလားသည့်ပုံစံ ဖြစ်ပါသည်။

Push ပြုလုပ်ခြင်း

zinnector push

push သည် စတင်ခြင်းမပြုမီ ကြိုတင်စစ်ဆေးမှုကို လုပ်ဆောင်ပေးပြီး သင်၏ commit များကို push ပြုလုပ်ကာ လွှင့်တင်မှုကို စတင်စေပြီး ပြီးဆုံးသည်အထိ စောင့်ကြည့်ပေးကာ နောက်ဆုံးအခြေအနေနှင့် လွှင့်တင်လိုက်သော commit ကို ထုတ်ဖော်ပြသပေးပါသည်။ --dry-run သည် လွှင့်တင်ခြင်းမှလွဲ၍ အားလုံးကို လုပ်ဆောင်ပေးသည်၊ --no-wait သည် ၎င်းကို စတင်စေပြီး ထွက်ခွာသွားသည်၊ --no-git သည် push မလုပ်ဘဲ ပလက်ဖောင်းပေါ်တွင် ရှိနှင့်ပြီးသား မည်သည့်အရာကိုမဆို လွှင့်တင်ပေးပါသည်။ လွှင့်တင်လိုက်သော commit သည် ယခုလေးတင် push ပြုလုပ်လိုက်သည့် commit မဟုတ်ပါက ထိုအကြောင်းကို အသိပေးဖော်ပြပါမည်။

ပြဿနာတစ်ခုခု ဖြစ်ပွားသည့်အခါ

zinnector deploys example.com        # လွှင့်တင်မှုမှတ်တမ်း — အခြေအနေ၊ commit၊ စတင်စေသည့်အရာ၊ မက်ဆေ့ဂျ်
zinnector logs example.com --build   # လတ်တလောအရှိဆုံး လွှင့်တင်မှု၏ တည်ဆောက်မှုမှတ်တမ်း
zinnector logs example.com --error   # ဆိုက်၏ အမှားမှတ်တမ်း
zinnector deploy example.com         # ပလက်ဖောင်းပေါ်တွင် ရှိနှင့်ပြီးသားအရာကို ပြန်လည်လွှင့်တင်ပါ
zinnector ai "why is my deploy failing?"

zinnector ai သည် သင်၏ကိုယ်ပိုင်အကောင့်ကို အခြေခံ၍ ပလက်ဖောင်းပေါ်တွင် လည်ပတ်သောကြောင့် တူညီသော လွှင့်တင်မှုမှတ်တမ်းနှင့် မှတ်တမ်းများကို ကြည့်ရှုနိုင်ပါသည်။ ပရောဂျက်တစ်ခု၏ အတွင်းပိုင်းမှနေ၍ ၎င်းသည် ပရောဂျက်၏ ပုံသဏ္ဌာန် — ဖိုင်တွဲအမည်များ၊ ဗားရှင်းများနှင့် ဆိုက် id — တို့ကိုသာ ပေးပို့ပြီး ဖိုင်ပါဝင်သည့်အကြောင်းအရာများကို မည်သည့်အခါမျှ မပေးပို့ပါ။

ဆက်စပ်သောအကြောင်းအရာများ

• စတင်ခြင်း · စက်တွင်း ရေးသားထုတ်လုပ်ခြင်း · ညွှန်ကြားချက်များ ကိုးကားချက် · ပြဿနာဖြေရှင်းခြင်း