Deploy tarmogʻi

Ommaviy HTTPS kirish nuqtalari, oʻz domenlaringiz, WebSocket, taym-autlar, mijoz manzili, xususiy tarmoq va chiquvchi ulanishlar.

Ommaviy kirish nuqtalari

  • Kirish nuqtasi xizmatga https://<nom>.app.acdn.uz koʻrinishidagi ommaviy manzil beradi. Nom avtomatik yaratiladi: uni tanlab boʻlmaydi va kirish nuqtasi mavjud ekan, u oʻzgarmaydi. Tanlangan nom yoki oʻz domeningiz uchun quyidagi «Oʻz domenlaringiz» boʻlimiga qarang.
  • TLS ACDN tomonida shu xost nomi uchun haqiqiy sertifikat bilan yakunlanadi. Mijozlar HTTP/1.1 yoki HTTP/2 dan foydalanishi mumkin; konteyneringiz kirish nuqtasi portida oddiy HTTP/1.1 qabul qiladi.
  • http:// ga kelgan soʻrovlarga https:// ga 301 yoʻnaltirish qaytariladi.
  • Xizmatda bir nechta kirish nuqtasi boʻlishi mumkin, har bir konteyner portiga bittadan. Faqat HTTP marshrutlanadi: xom TCP va UDP portlarini eʼlon qilib boʻlmaydi.
  • Kirish nuqtasi xizmatda faol reliz bor paytda ishlaydi. Xizmat toʻxtatilgan, tomli reliz paytida almashtirilayotgan yoki hali deploy qilinmagan boʻlsa, kirish nuqtasi xato holati, masalan 503 bilan javob beradi.
  • Soʻrovlar xizmat nusxalari orasida sessiyaga bogʻlanmasdan taqsimlanadi. Sessiya holatini alohida nusxadan tashqarida saqlang.
  • Sarlavha nomida pastki chiziq boʻlgan soʻrovlar 400 holati bilan rad etiladi.

Oʻz domenlaringiz

Xizmat oʻz domeningizda yoki vvvv.uz zonasida oʻzingiz tanlagan nomda javob berishi uchun uning kirish nuqtasi oldiga CDN pull zonasini qoʻying. Pull zonasi xost nomlarini va ular uchun TLS sertifikatlarini beradi hamda har bir soʻrovni xizmatga uzatadi. Oʻz domeningizdan toʻgʻridan-toʻgʻri app.acdn.uz zonasidagi yaratilgan xost nomiga CNAME ishlamaydi.

Shell
# 1. pull zonasini kirish nuqtasiga bogʻlang; xizmat chat.vvvv.uz manzilida javob bera boshlaydi
python3 acdn-agent.py call /api/user/pull-zones -- --json '{
  "name": "chat",
  "source_type": "deploy",
  "source_deploy_endpoint_id": "ENDPOINT_ID",
  "tier": "std"
}'

# 2. oʻz xost nomingizni qoʻshing; javobda cname_target qaytadi
python3 acdn-agent.py call /api/user/pull-zones/hostnames/PULL_ZONE_ID -- \
  --json '{"hostname":"chat.example.com"}'

# 3. DNS yozuvini yarating: chat.example.com CNAME chat.vvvv.uz
# 4. sertifikat soʻrang, soʻng "status":"active" boʻlguncha holatni tekshirib turing
python3 acdn-agent.py call /api/user/pull-zones/hostnames/check/PULL_ZONE_ID -- \
  --json '{"hostname":"chat.example.com"}'
python3 acdn-agent.py call '/api/user/pull-zones/hostnames/status/PULL_ZONE_ID?hostname=chat.example.com'
  • ENDPOINT_ID — xizmat kirish nuqtasining identifikatori; u xizmat va ilova javoblaridagi endpoints maydonida qaytariladi. Pull zonasini yaratish uchun tasdiqlangan elektron pochta manzili va noldan katta balans kerak.
  • Xizmat pull zonasi CORS, Edge Rules, POST va ildiz yoʻli cheklovlari, fayl yuklash va WebSocket ni qoʻllaydi. Bu sozlamalar faqat CDN domenlarida amal qiladi; yaratilgan kirish nuqtasi bevosita ochiq qoladi. Token Auth va Origin Shield mavjud emas. Host, Connection va Upgrade sarlavhalarini Edge Rules orqali almashtirish mumkin emas; qoida origin URL ni almashtirganda ham Host va TLS SNI kirish nuqtasi xost nomi boʻlib qoladi.
  • Deploy uchun standart TTL belgilanmagan: ilova keshlashni Cache-Control yoki Expires orqali boshqaradi. Ommaviy kontent uchun Cache-Control: public, max-age=3600 qaytaring. Kesh muddati boʻlmasa javob keshlanmaydi; private/no-store va Set-Cookie javoblari chiqarib tashlanadi. Cookie, Authorization yoki WebSocket Upgrade bilan soʻrovlar keshni chetlab oʻtadi. Kalitni saralash, coalescing va katta fayllarni boʻlish CDN sozlamalarida mavjud. Kesh kalitini saralash ilovaga yuboriladigan query parametrlar tartibini oʻzgartirmaydi.
  • Subdomen uchun CNAME dan foydalaning. Ildiz domen uchun zonani ACDN DNS ga joylashtiring: shunda yozuv avtomatik boshqariladi.
  • Xizmat Host sarlavhasida kirish nuqtasining yaratilgan xost nomini oladi. Tashrif buyuruvchi murojaat qilgan xost nomi X-Forwarded-Host sarlavhasida uzatiladi.
  • Soʻrovlar ikkita proksi orqali keladi, shuning uchun tashrif buyuruvchining manzili X-Forwarded-For da boshqa oʻrinda turadi («Mijoz manzili» boʻlimiga qarang).
  • Pull zonasining xost nomlarida HTTP sukut boʻyicha HTTPS ga yoʻnaltirilmaydi. Yoʻnaltirishni har bir xost nomi uchun force-ssl amali bilan yoqing; oddiy HTTP ni X-Forwarded-Proto sarlavhasi boʻyicha aniqlamang.
  • Pull zonasi orqali 100 MiB gacha boʻlgan soʻrov tanalari qabul qilinadi. /.env va /.git kabi maʼlum maxfiy yoʻllarga soʻrovlar 403 holati bilan rad etiladi va xizmatga yetib bormaydi.
  • WebSocket uchun 5 daqiqalik harakatsizlik cheklovi va javob uchun 15 soniyalik cheklov oʻzgarishsiz amal qiladi.
  • Pull zonasi orqali oʻtgan trafik uchun ikki marta toʻlanadi: pull zonasi tarifi narxida CDN yetkazib berish sifatida va xizmatning chiquvchi trafigi sifatida.
  • Kirish nuqtasining yaratilgan xost nomi ishlashda davom etadi. Kirish nuqtasi, uning xizmati yoki ilovasi oʻchirilganda, oʻchirilayotgan kirish nuqtalariga bogʻlangan CDN pull zonalari, maxsus domen sozlamalari va ACDN boshqaradigan DNS yozuvlari ham butunlay oʻchiriladi. Kabinet oʻchirishdan oldin ogohlantiradi; API qoʻshimcha tasdiqlash parametrini talab qilmaydi. Tashqi provayderdagi DNS yozuvlarini alohida oʻchiring.

WebSocket va taym-autlar

  • WebSocket har bir kirish nuqtasida, HTTP bilan bir xil portda, hech qanday sozlamasiz qoʻllab-quvvatlanadi. wss:// va kirish nuqtasining xost nomi orqali ulaning.
  • WebSocket ulanishi ikkala yoʻnalishda ham 5 daqiqa maʼlumot boʻlmasa yopiladi. WebSocket ping va pong kadrlari maʼlumot hisoblanadi. Kamida daqiqada bir marta ping yoki ilova darajasidagi heartbeat yuboring.
  • Faol WebSocket ulanishining maksimal yashash muddati yoʻq, lekin u nusxa almashtirilganda tugaydi.
  • Oddiy HTTP javobi soʻrov toʻliq qabul qilingandan keyin 15 soniya ichida toʻliq berilishi kerak. Aks holda soʻrov uziladi; javob hali boshlanmagan boʻlsa, mijoz 504 holatini oladi.
  • Bu 15 soniya Server-Sent Events va long polling kabi oqimli javoblarga hamda undan uzoq davom etadigan yuklab olishlarga ham tegishli. Uzoq yashaydigan ulanishlar uchun WebSocket dan, katta fayllar uchun ACDN Storage yoki CDN dan foydalaning.
  • Mijoz soʻrov tanasini yuborishga sarflagan vaqt bu 15 soniyaga kirmaydi.
  • Reliz paytida eski nusxa bilan ochiq ulanishlar u yakunlanganda uziladi. Mijozlar qayta ulanishi kerak.

Mijoz manzili

  • Konteyneringiz ulanishlarni tashrif buyuruvchidan emas, ACDN shlyuzidan koʻradi. Tashrif buyuruvchining manzili X-Forwarded-For sarlavhasida uzatiladi.
  • Kirish nuqtasining yaratilgan xost nomida mijoz va konteyner orasida aynan bitta proksi bor. Shlyuz ulangan mijozning manzilini har bir soʻrovda, jumladan WebSocket ga oʻtish soʻrovida ham, X-Forwarded-For ning oxirgi qiymati sifatida qoʻshadi. Undan oldingi qiymatlarni mijozning oʻzi yuborgan va ularga ishonib boʻlmaydi.
  • IP boʻyicha soʻrovlar chastotasini cheklash uchun X-Forwarded-For ning oxirgi qiymatidan foydalaning. Ishonchli proksi sozlamasi bor freymvorklarda bitta proksiga ishoning.
  • Pull zonasi (oʻz domeningiz) orqali ikkita proksi bor: oxirgi qiymat — ACDN edge tugunining manzili, tashrif buyuruvchining manzili esa undan oldingi qiymat.
  • Yaratilgan xost nomiga toʻgʻridan-toʻgʻri murojaat qilgan mijoz oxirgi qiymatdan oldin oʻz qiymatlarini qoʻyishi mumkin, shuning uchun oxirgidan oldingi qiymatga faqat haqiqatan pull zonasi orqali kelgan soʻrovlarda ishonish mumkin. Oʻz domeningizni suiisteʼmoldan himoya qilish uchun pull zonasining IP boʻyicha soʻrov va ulanish cheklovlaridan foydalangan maʼqul: ular edge tugunida tashrif buyuruvchining haqiqiy manzili boʻyicha qoʻllanadi.
  • Uzatilgan soʻrovlarda X-Forwarded-Proto qiymati https, X-Request-Id har bir soʻrovning noyob identifikatorini saqlaydi, Host esa kirish nuqtasining xost nomi.

Xizmatlar orasidagi xususiy tarmoq

  • Bitta ilovaning xizmatlari bir-biriga xizmat nomi orqali murojaat qiladi, masalan http://api:8080. Buning uchun kirish nuqtasi kerak emas.
  • Xizmat nomi orqali oʻzining http_port portida va kirish nuqtalarining portlarida ochiq. HTTP boʻlmagan xizmatni, masalan maʼlumotlar bazasini ochish uchun uning portini http_port ga yozing va health_check_path ni boʻsh qoldiring; shunda holat tekshiruvi faqat port ulanishlarni qabul qilishini tekshiradi.
  • Turli ilovalarning xizmatlari bir-biriga faqat ommaviy kirish nuqtalari orqali murojaat qila oladi.
  • Internetdan faqat ommaviy kirish nuqtalariga kirish mumkin.

Chiquvchi ulanishlar

  • Konteynerlar internetning ommaviy manzillariga faqat 80 va 443 TCP portlari orqali chiquvchi ulanish ocha oladi, shuningdek DNS soʻrovlarini bajaradi.
  • Boshqa barcha chiquvchi portlar yopiq. Jumladan SMTP (25, 465, 587), oʻz portlaridagi maʼlumotlar bazalari va keshlar, SSH va har qanday UDP xizmatlari.
  • Pochtani pochta provayderining HTTPS API si orqali yuboring, tashqi xizmatlarga esa HTTPS orqali murojaat qiling.
  • Xususiy va link-local manzil diapazonlariga kirib boʻlmaydi. ACDN Storage https://storage.acdn.uz manzilida ochiq.
  • Chiquvchi ulanishlar ACDN ning umumiy manzillaridan chiqadi; qatʼiy yoki ajratilgan chiquvchi manzil berilmaydi.
  • Chiquvchi trafik har bir nusxaga 1 Gbit/s bilan cheklangan va GiB boʻyicha toʻlanadi.

Soʻrov va javoblarning aniq maydonlari, cheklovlar va xato javoblari Management API maʼlumotnomasida keltirilgan.