Botxona

botxona.yaml — to'liq sxema

botxona.yaml — ixtiyoriy fayl, arxiv ildizida joylashadi (botxona.yml ham qabul qilinadi). U tizim avtomatik aniqlay olmaydigan holatlarni siz o'zingiz aniq ko'rsatishingiz uchun kerak. Fayl bo'lmasa ham bot ishlaydi — tizim avtomatik aniqlashga harakat qiladi.

Maydonlar

runtime: python       # python | node | go | php — til avtomatik aniqlanmasa aniq ko'rsating
entry: main.py        # ishga tushiriladigan fayl (runtime bilan birga ishlaydi)
start: python -u main.py --prod  # to'liq buyruq — entry o'rniga, qo'shimcha argumentlar bilan
always_on: true       # true — bot doim yoniq, false — faolsizlikda uxlaydi
updates: webhook      # auto (standart) | polling | webhook — yangilanishlar qanday keladi
webhook:
  port: 8080          # HTTP serveringiz tinglaydigan port ( sifatida ham beriladi)
  path: /webhook      # bot o'zi setWebhook chaqirmasa ishlatiladigan yo'l
MaydonTuriIzoh
runtimepython \node \go \phpTil avtomatik aniqlanmasa (masalan ikkala til fayllari ham bor) foydali
entrymatnIshga tushiriladigan fayl yo'li, masalan src/main.py (Go uchun — paket yo'li, masalan ./cmd/bot)
startmatnTo'liq ishga tushirish buyrug'i — argumentlar yoki maxsus skript kerak bo'lganda
updatesauto \polling \webhookYangilanishlarni yetkazish usuli. auto (standart) — bot setWebhook chaqirsa webhook, aks holda polling. Panelda (Sozlamalar → Yangilanishlar) tanlangan rejim bundan ustun turadi
webhook.port1–65535HTTP serveringiz tinglaydigan port (standart 8080); PORT o'zgaruvchisi sifatida ham beriladi
webhook.path/ bilan boshlanadiBot o'zi setWebhook chaqirmasa ishlatiladigan yo'l (standart /webhook); WEBHOOK_PATH sifatida ham beriladi
always_ontrue/falseBotni doim yoniq qilib qo'yish yoki, aksincha, scheduler bo'lsa ham uxlashga ruxsat berish
python3.10 \3.11 \3.12 \3.13Python versiyasi (standart 3.12). runtime.txt (python-3.11.4) va .python-version ham o'qiladi. Eski pin qilingan kutubxonalar (masalan pandas==1.5.3) uchun tizim o'zi 3.11 tanlaydi
writablepapka/fayl nomlari ro'yxatiKodingiz nisbiy yo'lga yozadigan ildiz papkalar yoki fayllar (data, users.json). Ular /data ga ulanadi — ma'lumotlar saqlanadi va zaxiralanadi. Odatda tizim o'zi aniqlaydi, faqat aniqlay olmasa yozing

Ustuvorlik tartibi

  1. start bo'lsa — aynan shu buyruq ishlatiladi, entry e'tiborga olinmaydi.
  2. Aks holda entry bo'lsa — shu fayl runtimega mos standart buyruq bilan ishga tushiriladi (python -u <entry>, node <entry> yoki Go'da <entry> paketi binar faylga build qilinadi).
  3. Ikkalasi ham bo'lmasa — tizim main.py/bot.py/app.py (Python) yoki package.json dagi "start" skripti / main maydoni (Node.js) yoki Go'da ildizdagi main paket (main.go) / yagona cmd/<nom>/ orqali avtomatik aniqlaydi. Go loyihasi ildizdagi go.mod bilan aniqlanadi (yoki runtime: go / golang).

always_on sozlansa, u bot sahifasidagi Sozlamalar → Ish rejimidagi "Avto" holatining boshlang'ich qiymatini belgilaydi — foydalanuvchi keyinchalik panelda buni qo'lda o'zgartirishi mumkin (Uxlash va uyg'onish).

Misollar

Oddiy Python bot, standart nomlanmagan fayl bilan:

runtime: python
entry: src/bot.py

Node.js, maxsus ishga tushirish buyrug'i bilan:

start: node --experimental-modules src/index.mjs

Go, cmd/bot paketi bilan:

runtime: go
entry: ./cmd/bot

Har doim yoniq bo'lishi kerak bo'lgan bot (masalan to'lov eslatmalari yuboradi):

always_on: true

Webhook ishlatadigan bot ( da tinglaydi, /tg yo'lini qabul qiladi):

updates: webhook
webhook:
  port: 8080
  path: /tg

Noto'g'ri updates qiymati, 1–65535 dan tashqari port yoki / bilan boshlanmaydigan yo'l tekshiruvda xato beradi. Batafsil: Webhook yoki long-polling.

Python versiyasi, yozuv papkalari va PHP

  • Python versiyasi. python: "3.11" (yoki runtime.txt). Qo'llab-quvvatlanadi: 3.10, 3.11, 3.12, 3.13. Kutubxona o'rnatilmay qolsa (masalan pandas==1.5.3 3.12 da build bo'lmaydi), eski versiyani tanlang. Aniq pandas/scipy kabi eski pin bo'lsa va numpy yozilmagan bo'lsa, o'rnatishga avtomatik numpy<2 sharti qo'shiladi.
  • Nisbiy yo'lga yozish. Fayl tizimi faqat o'qish uchun, shuning uchun data/bot.sqlite3 yoki open("users.json", "w") kabi yozuvlar odatda xato beradi. Tizim bunday papka/fayllarni topib, /data ga ulaydi (kodda hech narsani o'zgartirish shart emas). Avtomatik topilmasa writable: [papka, fayl.json] yozing. Yaxshisi baribir DATA_DIR ishlating. Eslatma: arxivda bor papka /data ga ulansa, undagi fayllar birinchi ishga tushishda nusxalanadi va keyingi deploylarda faqat YANGI fayllar qo'shiladi — o'zgargan fayllar ustiga yozilmaydi (bot ma'lumotlari saqlansin deb).
  • PHP. runtime: php (yoki index.php / composer.json). php://input o'qiydigan skript webhook boti hisoblanadi: PHP serverida (php -S) ishlaydi va yangilanishlar unga avtomatik yetkaziladi — setWebhook chaqirish shart emas. Boshqa skript php fayl.php bilan ishlaydi. Node.js/Python o'rami php ni o'zi ishga tushirsa, PHP obrazga o'rnatiladi.

Keyingi qadam

Kirish nuqtasi va kutubxonalar haqida to'liq: 6 qoida. Muhit o'zgaruvchilari haqida: Muhit o'zgaruvchilari.