Boshlashdan oldin
Deploy konteyner obrazini ommaviy HTTPS manzilga ega xizmat sifatida ishga tushiradi. Ushbu sahifadagi hamma narsani skript yoki AI-agent Management API orqali bajara oladi. Hisobga oid uchta qadamni inson brauzerda bajaradi.
- Obraz linux/amd64 uchun yigʻilgan va reyestrda joylashgan boʻlishi kerak: ommaviy reyestrda, Docker Hub yoki GitHub Container Registry yopiq repozitoriysida yoki oʻzingizning ACDN reyestringizda.
- Hisobda tasdiqlangan elektron pochta manzili, noldan katta balans va maʼqullangan shaxsni tasdiqlash boʻlishi kerak. GET /api/user/deploy/requirements nima yetishmayotganini koʻrsatadi va hisob egasi kerakli qadamni bajaradigan sahifani qaytaradi.
- Bitta ilovada bir vaqtda 3 tagacha nusxa ishlaydi. Tomsiz xizmat relizi vaqtincha bitta nusxa qoʻshadi, shuning uchun bunday xizmati bor ilovada 2 tagacha nusxa sozlash mumkin.
- Foydalanish hisob balansidan toʻlanadi. Narxlar sahifa oxiridagi «Toʻlov» boʻlimida keltirilgan.
Agar soʻrov 403 holatini qaytarsa, GET /api/user/deploy/requirements ni chaqiring va bajarilmagan talabning message va action_url maydonlarini hisob egasiga koʻrsating. Buni faqat u hal qila oladi; soʻrovni takrorlash yordam bermaydi.
acdn-agent.py ni ulash
acdn-agent.py — bitta fayldan iborat yordamchi dastur: u device flow orqali OAuth token oladi va uni curl ga uzatadi. authorize buyrugʻi havola va kodni chiqaradi hamda kutadi; hisob egasi havolani ochadi, hisobga kiradi va ruxsatni tasdiqlaydi. Token joriy katalogdagi tmp/acdn-agent/ ichida saqlanadi va avtomatik yangilanadi.
curl -fsSLO https://acdn.uz/tools/acdn-agent.py
python3 acdn-agent.py authorize --no-browser
# hisobga nima yetishmaydi, mavjud hududlar, cheklovlar, narxlar
python3 acdn-agent.py call /api/user/deploy/requirements
«--» dan keyingi argumentlar curl ga uzatiladi. Misollarda --json ishlatiladi, buning uchun curl 7.82 yoki undan yangi versiya kerak; eskiroq versiyalarda --header "Content-Type: application/json" --data yuboring. Soʻrov xato bilan tugasa, xato JSON matni chiqariladi va chiqish kodi noldan farqli boʻladi. Xabarlar hisob tilida qaytariladi; ingliz tilida olish uchun «--» dan keyin --header "Accept-Language: en" qoʻshing.
Ilova yaratish
Ilova bitta loyihaning xizmatlari, tomlari va kirish nuqtalarini bitta hududda va bitta xususiy tarmoqda birlashtiradi. Qaytarilgan id ni saqlab qoʻying. Ilova fonda, odatda bir necha soniyada tayyorlanadi; deploy qilishdan oldin holati ready boʻlishini kuting.
python3 acdn-agent.py call /api/user/deploy/applications -- \
--json '{"name":"Chat backend","region":"UZ"}'
# "status":"ready" boʻlguncha takrorlang
python3 acdn-agent.py call /api/user/deploy/applications/APPLICATION_ID
- Har bir necha soniyada soʻrang. Tayyorlash 5 daqiqadan keyin failed holati bilan toʻxtaydi; shunda uni takrorlash uchun POST /api/user/deploy/applications/prepare/APPLICATION_ID yuboring.
- Tomlar, xizmatlar va kirish nuqtalarini ilovaning oʻchirilayotgan holatidan boshqa har qanday holatida yaratish mumkin. Deploy faqat holat ready boʻlganda qabul qilinadi; aks holda soʻrov 409 qaytaradi.
- Taym-autdan keyin ilovalar roʻyxatini tekshirmasdan yaratish soʻrovini takrorlamang: qabul qilingan har bir soʻrov yana bitta ilova yaratadi.
Tom va xizmat qoʻshish
Avval tomni, soʻng uni ulaydigan xizmatni yarating. endpoint_ports koʻrsatilgan har bir konteyner porti uchun ommaviy HTTPS manzil soʻraydi; yaratilgan xost nomi endpoints maydonida qaytariladi.
python3 acdn-agent.py call /api/user/deploy/volumes -- \
--json '{"deploy_application_id":"APPLICATION_ID","name":"data","size_gb":1}'
python3 acdn-agent.py call /api/user/deploy/services -- --json '{
"deploy_application_id": "APPLICATION_ID",
"name": "web",
"image": "ghcr.io/example/chat:1.4.2",
"http_port": 8080,
"health_check_path": "/healthz",
"replicas": 1,
"volume_mounts": [{"deploy_volume_id": "VOLUME_ID", "mount_path": "/data"}],
"environment_variables": [
{"name": "LOG_LEVEL", "value": "info", "is_secret": false},
{"name": "SESSION_SECRET", "value": "change-me", "is_secret": true}
],
"endpoint_ports": [8080]
}'
- http_port — jarayoningiz tinglaydigan port. Faqat 127.0.0.1 ni emas, 0.0.0.0 ni tinglang. PORT oʻzgaruvchisi berilmaydi.
- health_check_path xizmat trafik qabul qilishga tayyor boʻlganda 200 dan 399 gacha holat bilan javob berishi kerak. Tekshiruv ommaviy manzil orqali emas, toʻgʻridan-toʻgʻri nusxaga yuboriladi.
- volume_mounts maydoni majburiy; tomsiz xizmat uchun boʻsh massiv yuboring.
- Maʼlumotlar bazasi faylini tomda saqlaydigan xizmat replicas 1 bilan ishlashi kerak: har bir nusxa oʻzining alohida diskini oladi.
- Sirlar faqat yozish uchun. Ular konteynerga muhit oʻzgaruvchilari sifatida yetkaziladi va API orqali hech qachon qaytarilmaydi.
- Hozircha hech narsa ishga tushmagan: xizmat draft holatida yaratiladi.
Deploy qilish va natijani kutish
Deploy soʻrovi darhol javob qaytaradi, yangi deploy latest_deployment maydonida boʻladi. Uning id sini eslab qoling va shu deploy active, failed yoki cancelled holatiga yetguncha xizmatni taxminan har 5 soniyada soʻrang. Deployga tayyor boʻlish uchun 10 daqiqa beriladi.
python3 acdn-agent.py call /api/user/deploy/services/deploy/SERVICE_ID -- --request POST
# xizmat va uning oxirgi deployi holati
python3 acdn-agent.py call /api/user/deploy/services/SERVICE_ID
# soʻnggi deploylar va ularning xronologiyasi; oʻzingiznikini id boʻyicha toping
python3 acdn-agent.py call /api/user/deploy/services/deployments/SERVICE_ID
- Muvaffaqiyat: deployingiz holati active, xizmat holati running. Xizmat endpoints[].url manzilida HTTPS orqali javob beradi.
- Xato: deployingizning failure maydoni sababni, progress esa nima boʻlganini koʻrsatadi. Biror narsani oʻzgartirishdan oldin loglarni oʻqing, chunki nusxa almashtirilganda ular yoʻqoladi.
- Muvaffaqiyatsiz deploydan keyin platforma oldingi relizni tiklaydigan, action qiymati recover boʻlgan yangiroq deploy qoʻshishi mumkin. Shunda deployingiz xato bilan tugagan boʻlsa ham xizmat yana running koʻrsatadi, shuning uchun har doim oʻzingiz boshlagan id li deployni tekshiring.
- Yangi xost nomi kirish nuqtasi yaratilganda DNS da eʼlon qilinadi. U hamma joyda aniqlanishi uchun bir necha daqiqa kuting.
Holat va loglarni oʻqish
# har bir nusxaning holat tekshiruvi natijasi
python3 acdn-agent.py call /api/user/deploy/services/readiness/SERVICE_ID
# birinchi nusxaning oxirgi 1000 qatori; javobda barcha nusxalar sanab oʻtiladi
python3 acdn-agent.py call /api/user/deploy/services/logs/SERVICE_ID
# nusxaning oxirgi qayta ishga tushishidan oldingi ishga tushish chiqishi
python3 acdn-agent.py call '/api/user/deploy/services/logs/SERVICE_ID?instance=INSTANCE_ID&instance_uid=INSTANCE_UID&previous=1'
- Loglar — konteynerning standart chiqishi va standart xatolar oqimi, har bir qator oldida vaqt belgisi bilan.
- Faqat hali mavjud boʻlgan nusxalarning yaqindagi chiqishi mavjud. Muvaffaqiyatsiz deploy loglarini darhol oʻqing.
- INSTANCE_ID va INSTANCE_UID oldingi loglar javobidan olinadi: instances[].id nusxalarni sanaydi, instance_uid esa matni qaytarilgan nusxaga tegishli.
- Nusxasi yoʻq xizmat uchun boʻsh text va null qiymatli instance qaytariladi.
Qayta deploy, orqaga qaytarish, toʻxtatish
Yangi obrazni chiqarish uchun uni reyestrga yuklang va yana deploy qiling: har bir deployda teg qaytadan dayjestga aylantiriladi. Sozlamalarni oʻzgartirish uchun avval xizmatni yoki uning muhitini yangilang, soʻng deploy qiling. Saqlangan oʻzgarishlar keyingi deploygacha kuchga kirmaydi.
# muhitni almashtirish, soʻng uni chiqarish
python3 acdn-agent.py call /api/user/deploy/services/environment/SERVICE_ID -- --request PUT --json '{
"environment_variables": [
{"name": "LOG_LEVEL", "value": "debug", "is_secret": false},
{"name": "SESSION_SECRET", "value": "", "is_secret": true}
]
}'
python3 acdn-agent.py call /api/user/deploy/services/deploy/SERVICE_ID -- --request POST
# oldingi relizga qaytish: "can_rollback": true boʻlgan deployni tanlang
python3 acdn-agent.py call /api/user/deploy/services/rollback/SERVICE_ID -- \
--json '{"source_deployment_id":"DEPLOYMENT_ID"}'
# joriy relizning yangi nusxalarini ishga tushirish yoki xizmatni toʻxtatish
python3 acdn-agent.py call /api/user/deploy/services/restart/SERVICE_ID -- --request POST
python3 acdn-agent.py call /api/user/deploy/services/stop/SERVICE_ID -- --request POST
# hammasini, jumladan tomlardagi maʼlumotlarni oʻchirish
python3 acdn-agent.py call /api/user/deploy/applications/APPLICATION_ID -- --request DELETE
- Muhit soʻrovi butun roʻyxatni almashtiradi. Boʻsh qiymat bilan yuborilgan mavjud sir oʻz qiymatini saqlaydi; roʻyxatda boʻlmagan oʻzgaruvchi oʻchiriladi.
- Orqaga qaytarish tanlangan relizning obrazi, konfiguratsiyasi, muhiti va sirlarini tiklaydi. Tomlardagi maʼlumotlar orqaga qaytarilmaydi.
- Orqaga qaytarish saqlangan konfiguratsiyani oʻzgartirmaydi. Keyingi deploy saqlangan konfiguratsiyani yana qoʻllaydi, shuning uchun orqaga qaytargandan keyin saqlab qolmoqchi boʻlgan sozlamalarni ham saqlang.
- Orqaga qaytarish uchun faqat qachondir faol boʻlgan deploy yaraydi; boshqa har qanday id 404 qaytaradi.
- deploy, stop, restart va rollback uchun birgalikda daqiqasiga 6 ta soʻrov cheklovi amal qiladi, va xizmatda bir vaqtda faqat bitta deploy bajarilishi mumkin (aks holda 409 holati). Cheklovda har bir soʻrov, jumladan rad etilganlari ham hisobga olinadi.
Toʻlov
- CPU: bir CPU-soat uchun 0,02 US$. Faqat haqiqatda sarflangan protsessor vaqti hisoblanadi, shuning uchun boʻsh turgan xizmat CPU boʻyicha deyarli hech narsa turmaydi.
- Xotira: ishlatilayotgan xotiraning bir GiB-soati uchun 0,005 US$; nusxaning ishchi xotirasi, jumladan faol ishlatilayotgan fayl keshi oʻlchanadi.
- Tomlar: har bir diskning ajratilgan hajmi uchun bir GiB-oyga 0,10 US$, toʻlganligidan va xizmat ishlayotganidan qatʼi nazar. Tomni ulaydigan xizmat deploy qilinmaguncha tom uchun toʻlov olinmaydi (ungacha allocated_bytes 0 ga teng).
- Chiquvchi trafik: nusxalaringiz yuborgan har bir GiB uchun 0,05 US$. Oʻz domeningizda CDN pull zonasi orqali uzatilgan trafik uchun qoʻshimcha ravishda pull zonasi tarifi narxida CDN yetkazib berish toʻlovi olinadi.
- Bepul hajm, minimal toʻlov hamda ilovaning yoki kirish nuqtasining oʻzi uchun toʻlov yoʻq.
- Foydalanish taxminan har 30 daqiqada hisobga olinadi va hisob balansidan yechiladi. API har bir xizmat, tom va ilova uchun joriy oydagi foydalanishni qaytaradi.
- Ilova yaratish uchun balans noldan katta boʻlishi kerak. Manfiy balans aniqlanganda mavjud Deploy xizmatlariga uch kunlik (72 soatlik) toʻlov imtiyozli muddati beriladi. Shu vaqt davomida xizmatlar ishlaydi, deploy va qayta ishga tushirish mavjud. Foydalanish uchun toʻlov hisoblanishda davom etadi.
- Elektron xatlar imtiyozli muddat boshlangani va aniq toʻlov muddatini bildiradi, tugashidan 24 soat oldin eslatadi va xizmatlar toʻxtagach toʻxtatilishni tasdiqlaydi. GET /api/user/deploy/requirements negative_balance_grace_ends_at va deployments_blocked ni qaytaradi. Balans har daqiqada tekshiriladi; manfiy balans aniqlanmaguncha muddat null boʻladi.
- Belgilangan muddatda balans hali manfiy boʻlsa, barcha Deploy xizmatlari, jumladan shaxsiy reestrlar, odatiy tartibda toʻxtatiladi. Qarz qoplanmaguncha deploy, qayta ishga tushirish va orqaga qaytarish 402 qaytaradi. Balansni nolga yoki undan yuqoriga yetkazish hisobni yangilaydi; balans manfiy qoladigan qisman toʻlov muddatni uzaytirmaydi.
- Balans nolga yoki undan yuqoriga yetgach, elektron pochta orqali tasdiq keladi va qarzdorlik sababli toʻxtatilgan xizmatlar avvalgi reliz bilan avtomatik ishga tushadi. Tiklash har daqiqada tekshiriladi va boshlangan toʻxtash jarayoni tugashini kutadi. Toʻxtatilgan shaxsiy reestr uning obrazlariga muhtoj xizmatlardan oldin ishga tushadi. Qoʻlda toʻxtatilgan xizmatlar oʻchiq qoladi. Sozlamalar va saqlangan maʼlumotlar qoladi; ajratilgan tomlar va reestr Storage uchun toʻlov ular oʻchirilguncha hisoblanadi.
Soʻrov va javoblarning aniq maydonlari, cheklovlar va xato javoblari Management API maʼlumotnomasida keltirilgan.