Səhifəni Cloudflare Workers-də necə yerləşdirmək olar

Hazır səhifə olan qovluq var, linki isə yoxdur. Onu Cloudflare Workers-də dərc edəcəyik, proseduru isə Claude Code-a tapşıracağıq: elə bir skill yaradacağıq ki, dərc etmək və yeniləmək qısa bir xahişlə həll olunsun.

1. Statika üçün Cloudflare Workers nədir

Workers sözü "serverdə işləyən proqramlar" kimi səslənir və bu doğrudur. Amma tam həqiqət deyil: workerə fayl qovluğu əlavə etmək olar, o zaman server onları adi hostinq kimi sadəcə paylayır. Bu zaman bir sətir də kod yazılmır.

HTML, CSS və şəkillərdən ibarət səhifə üçün bu rejim kifayətdir. Sənədlərdə bu qovluq static assets, yəni statik resurslar adlanır, layihə tənzimləmələrində isə yolu olan cəmi bir sahə tutur.

Cloudflare faylları öz server şəbəkəsi vasitəsilə paylayır və onları ziyarətçilərə yaxın keşləyir.

2. Bu nə qədər başa gəlir

Statik fayllara sorğular pulsuzdur və sayına görə məhdudlaşdırılmır. Bu tarifin şərtidir, ziyarət statistikasının olmayacağına dair vəd deyil.

Bəs onda o məşhur rəqəm - sutkada 100 000 sorğu - haradan gəldi? Bu, Worker-skriptinin, elə həmin server proqramının, çağırışlarına qoyulan limitdir. Yalnız qovluq əlavə edilmiş səhifədə skript yoxdur və o, bu sayğaca düşmür.

Sxemdəki üst yol bizim səhifəyə uyğundur: fayl server proqramı çağırılmadan verilir. Alt yol isə sonradan Worker-skripti əlavə etsəniz lazım olacaq.

Pulsuz tarifin limitləri yenə də var, amma onlar başqa şey haqqındadır - yerləşdirdiyiniz faylların ölçüsü haqqında:

Təxminən on şəkli olan səhifə üçün bu limitlər adətən kifayət edir. Böyük layihədən əvvəl Cloudflare-in cari şərtlərini yoxlayın: məhdudiyyətlər dəyişə bilər. Fayl başına 25 MB, yeri gəlmişkən, ilk videoya qədər səxavətli görünür.

3. Hesab

cloudflare.com-da qeydiyyat adidir: e-poçt və parol, ardınca təsdiq məktubu. Pulsuz tarif üçün kart lazım deyil. Öz domeninizi əlavə etmək də lazım deyil - servis bunu təklif edəcək, amma bu təklif məhsulun başqa yarısına, mövcud saytların qorunması və sürətləndirilməsinə aiddir.

Giriş etdikdən sonra lazımi bölmə "Workers & Pages" adlanır və görünən yerdə deyil: sol menyuda əvvəlcə Build qrupu, onun içində Compute, artıq onun içində isə "Workers & Pages". Panel zaman-zaman yenidən qurulur, ona görə bu yolla bölmə tapılmasa, ada görə axtarın: yuxarı soldakı axtarış Ctrl + K ilə açılır. Addakı iki söz Cloudflare-in iki məhsuludur; sizə birinci yarısı, Workers, lazımdır və siz oraya heç nəyi ayrıca seçmədən özünüz düşəcəksiniz.

İlk deploy zamanı daha bir şey üzə çıxacaq: Cloudflare hesab üçün subdomen adı seçməyi xahiş edəcək. Bütün layihələriniz onun üzərində yaşayacaq, ünvan isə iki hissədən yaranır - layihənin adı üstəgəl sizin subdomeniniz:

my-landing.example-account.workers.dev
|          |               |
|          |               Cloudflare-in ümumi domeni
|          hesabınızın subdomeni
layihənin adı

bu ad sonradan çətinliklə dəyişdirilir, ona görə ağla ilk gələni yazmamaq daha yaxşıdır.

4. İlk deploy

Əvvəlcə qısaca dərc etmənin paneldə necə göründüyünə baxaq. Bu, servislə könüllü tanışlıqdır: əgər deployu dərhal agentə tapşırıb bir ünvanı saxlamaq istəyirsinizsə, aşağıdakı hazırlığa keçin.

landing/          <- bu qovluğu veririk
  index.html      <- əsas səhifə, adı məcburidir
  wrangler.jsonc  <- agent ilk deploydan əvvəl yaradacaq
  style.css
  img/
    hero.png

Dərc etmədən əvvəl seçdiyiniz qovluğun məzmununu yoxlayın: ondakı fayllar ictimai olacaq. Göstərmək istəmədiyiniz şəxsi faylları və qaralamaları oradan çıxarın.

Panel vasitəsilə əl ilə

Layihələr bölməsində yeni layihə açan düymə var. Sonra sizdən faylları vermək istəniləcək: bir fayl və ya bütöv qovluq seçmək olar. Yüklədiniz, təsdiqlədiniz - Cloudflare onları öz tərəfində yerləşdirdi və linki qaytardı. Düymələrin adları və ekranların sırası burada məqalələrdən daha tez-tez dəyişir, ona görə yazılara yox, mənaya əsaslanın: layihə açmaq, faylları vermək, ünvan almaq.

Alınan https://…workers.dev ünvanını açın və səhifəni, şəkilləri yoxlayın. Bunu eyni kompüterdən etmək olar. Telefon isə əlçatanlığı və mobil görünüşü əlavə yoxlamaq üçün lazım olacaq.

Panel vasitəsilə dərc etdikdən sonra lokal konfiqurasiya faylı yaranmır. Bizim nümunədəki skill qovluğu belə layihə ilə özü əlaqələndirmir: konfiqurasiya faylı olmadan o, yeni ad və ikinci ünvan yaradacaq. Cloudflare Wrangler vasitəsilə mövcud Worker-i yeniləməyə imkan verir, amma bunun üçün konfiqurasiyanı ayrıca onun adına tənzimləmək lazımdır.

Bunu agentə tapşırmaq üçün nə lazımdır

Sonrakı dərclər üçün skill hazırlayaq. Hazırlıq kompüterinizdə bir dəfə lazımdır.

Proqram çox lazım olmayacaq. Hesabınız artıq var, bir də Node.js lazımdır - node -v əmri ilə yoxlanılır, tapılmasa, əvvəlcə onu quraşdırmalı olacaqsınız. Wrangler-in özünü quraşdırmaq lazım deyil: npx lazım olanda onun təzə versiyasını özü endirəcək.

Sxemdə ikinci addım girişdir və onu elə indi, hər şeydən əvvəl həll etməyə dəyər:

npx wrangler login    # brauzer açılacaq, orada təsdiq düyməsi olacaq

Əmri terminalda icra edin. Bu addım atlansa, bütün prosedur ilk işə salmada elə buna ilişib qalacaq və bu, skill xarab olubmuş kimi görünəcək, halbuki məsələ heç onda deyil. Hər şeyin uğurlu olduğunu npx wrangler whoami əmri ilə yoxlamaq olar - o, hansı hesabla girdiyinizi göstərəcək.

Bu marşrut üçün brauzer vasitəsilə giriş kifayətdir. API-token sondakı könüllü davamda izah olunur.

Sxemin üçüncü addımını, npx wrangler deploy-u, agent səhifənin qovluğundan işə salacaq. Əvvəlcə ona konfiqurasiya faylının hazırlanması və dərc etmə qaydalarını verək.

5. Deploy üçün öz skilliniz

Səhifə bir dənə olduğu müddətcə çatda bir xahiş kifayətdir. Amma ikincini, üçüncünü, onuncunu yaradanda hər dəfə agentə eyni şeyi izah etmək lazım gələcək: hansı qovluğu götürürük, layihəni necə adlandırırıq, tənzimləmə faylı ilə nə edirik. Üçüncü dəfədə bu artıq bezdirir.

Skill nəyi bacarmalıdır

Beş addım, hər biri konkret problemi həll edir, tamlıq üçün əlavə olunmayıb:

1. Adı çəkilən qovluğu götürüb index.html-in onun kökündə olduğuna əmin olmaq. Ucuz yoxlama, deploydan sonra yox, əvvəl ən tez-tez rast gəlinən xətanı tutur.
2. Layihənin adını müəyyən etmək - onu hər dəfə soruşmaq əvəzinə qovluğun adından çıxarmaq.
3. Qovluğun içində, index.html-in yanında, wrangler.jsonc faylının olub-olmadığına baxmaq. Yoxdursa - yaratmaq; varsa - adı oradan götürüb heç nəyi yenidən yazmamaq.
4. Deployu bu qovluqdan işə salmaq və əmri işə salmadan əvvəl göstərmək.
5. İctimai ünvanı qaytarmaq və onun üzrə səhifəni, şəkilləri yoxlamağı xatırlatmaq.

Layihənin adı qovluqdan çıxarılır

Bu, bütün prosedurun əsas qərarıdır və məhz onu agentin improvizasiyasına buraxmaq olmaz. Ad qayda ilə verilməzsə, agent onu özü uydurar - və növbəti dəfə başqasını uydurar. Nəticədə başqa ünvanlı ikinci layihə yaranar, birincisi isə unudulmuş halda qalar.

Qayda sadədir: qovluğun adı elə layihənin adıdır. Worker adında yalnız kiçik latın hərfləri, rəqəmlər və defis ola bilər, ona görə qalan hər şeyi - nöqtələri, boşluqları, alt xəttləri - defisə çeviririk və sona qısa suffiks, dörd təsadüfi simvol əlavə edirik:

landing/                 ->  landing-42c2
my.first.page/           ->  my-first-page-8e10
portfolio-2026/          ->  portfolio-2026-b7a3

Suffiks lazımdır ki, fərqli layihələrdə eyni adlı iki qovluq bir ünvanı tutmasın. O, bir dəfə, tənzimləmə faylı yaradılanda generasiya olunur, həm də mütləq əmrlə, agentin öz ağlından yox: əks halda agent suffiksi nümunədən götürər və eyni məqaləni oxuyan hər kəsdə suffiks eyni olar. Sonra suffiks həmişə konfiqurasiya faylından oxunur. Skillin əvvəlcə mövcud konfiqurasiya faylına baxıb, yalnız sonra nəyisə yazmasının səbəbi də elə budur.

Tənzimləmə faylını agent yazır

wrangler.jsonc-ə agent layihənin adını və dərc etmə tənzimləmələrini yazır ki, deployu terminalda sualsız işə salsın. Konfiqurasiya faylı index.html-in yanında yerləşir, ona görə ondakı fayl yolu nöqtədir, "elə bu qovluq":

{
  "name": "landing-42c2",
  "compatibility_date": "2026-09-07",
  "assets": { "directory": "." }
}

compatibility_date sahəsi göstərilən tarixdə platformanın uyğun davranışını seçir. Yeni konfiqurasiya faylı üçün agent, Cloudflare sənədlərinin tövsiyə etdiyi kimi, cari tarixi qoyur; təkrar dərc etmədə isə əvvəlkini saxlayır.

Konfiqurasiya faylını bir səviyyə yuxarıda, qovluğun yanında saxlamağa dəyməz: fayl adı sabitdir, bir kataloqda belə fayl yalnız bir dənə ola bilər, ikinci qovluq isə ya birincinin konfiqurasiya faylını üzərinə yazar, ya da onun adı altında dərc olunar. Qovluğun içində hər layihə özünəyetərlidir və deploy birbaşa ondan işə salınır.

Bu düzülüşün yan təsiri: konfiqurasiya faylı səhifə ilə eyni qovluqda yerləşir, ona görə onunla birgə hostinqə köçür və link üzrə açılır. Onda sirr yoxdur - ad, tarix və nöqtə; kimə mane olsa, yanına .assetsignore faylı qoyub nəyin dərc olunmayacağını orada sadalayır.

Tapşırıqda açıq deyilməli üç qayda var, əks halda agent onları təxmin edə bilməyəcək:

• fayl yoxdursa - yaratmaq, nə yazdığını göstərərək;
• fayl varsa - adı və tarixi olduğu kimi saxlamaq, bugünkü tarix başqa olsa belə;
• faylı yalnız məzmun həqiqətən dəyişəndə yenidən yazmaq.

Əl altında saxlamağa dəyər dörd xahiş

Birincisi - skillin özü üçün tapşırıq. O, digərlərindən uzundur, çünki bu, prosedurun tamamını təsvir etdiyiniz yeganə dəfədir:

Cloudflare Workers-də statik səhifələrin deployu üçün skill yığ.
Onu bu layihənin .claude/skills/ qovluğuna qoy.
Sonda yaradılmış SKILL.md-nin yolunu və skilli açıq çağırma üsulunu göstər.

Əvvəlcə Cloudflare-in Workers və static assets haqqında aktual
sənədlərini oxu: əmrlər və konfiqurasiya sahələri dəyişmiş ola bilər.
Aşağıdakı təsvirdə nəsə sənədlərlə uyğun gəlməzsə - mənə de,
səssizcə yenidən yazma.

Skillin təsvirində onun işə düşəcəyi ifadələri sadala,
ən azı: "qovluğu dərc et", "yenidən dərc et", "Cloudflare-də deploy et".

Prosedur: qovluğu götürürəm, kökdə index.html olduğunu yoxlayıram.
Layihənin adını bu qovluğun adından çıxarıram: orada yalnız
kiçik latın hərfləri, rəqəmlər və defis qalır, qalan hər şeyi (boşluqlar,
alt xəttlər, böyük hərflər, kiril) defisə çevirirəm.
Sona defislə dörd simvoldan ibarət suffiks əlavə edirəm.
Suffiksi uydurmuram, əmrlə alıram:
node -e "console.log(crypto.randomUUID().slice(0,4))"
wrangler.jsonc konfiqurasiya faylı dərc olunan qovluğun içində, index.html-in
yanında yerləşir və ondakı assets.directory "." olur.
Konfiqurasiya faylı yoxdursa - onu yaradıram: name, compatibility_date,
assets.directory. Yeni compatibility_date üçün cari tarixi
YYYY-MM-DD formatında qoyuram. Nə yazdığımı göstərirəm.
Konfiqurasiya faylı varsa - adı və tarixi oradan götürürəm və yenidən yazmıram.
Faylı yalnız məzmun həqiqətən dəyişəndə yenidən yazıram.
Konfiqurasiya faylı varsa, amma assets.directory bu qovluğa işarə etmirsə,
və ya konfiqurasiya faylında main sahəsi varsa - dayanıram, deployu işə salmıram.
Yenidən dərc etmək istənilirsə, amma qovluqda konfiqurasiya faylı yoxdursa - dayanıram
və soruşuram, yeni layihə yaratmıram.
Deploy: layihənin qovluğundan npx wrangler deploy. Əmri işə salmadan
əvvəl göstərirəm. Cavabda ictimai ünvanı qaytarıram və onun üzrə
səhifəni, şəkilləri yoxlamağı xatırladıram. Yenilənmədə ünvan
əvvəlki kimi qalmalıdır.
Node.js yoxdursa və ya avtorizasiya keçilməyibsə - bunu deyirəm,
yan keçməyə çalışmıram.
Hesabda hələ workers.dev subdomeni yoxdursa - bunu deyirəm:
qeyri-interaktiv deploy məhz bu səbəbdən uğursuz olur.

Yaratdıqdan sonra agentin göstərdiyi .claude/skills/<ad>/SKILL.md faylını açın: orada yuxarıdakı qaydalar olmalıdır. İkinci xahişdən əvvəl yaradılmış skilli agentin göstərdiyi üsulla açıq şəkildə çağırın. Skill tapılmasa, agentdən yolu və skillin cari layihədə əlçatan olduğunu yoxlamağı xahiş edin.

İkincisi - işdən əvvəl yoxlama. Qovluğun ilk deployundan əvvəl, nəsə çölə çıxmazdan öncə planı görmək istəyəndə faydalıdır; bir neçə qovluq varsa, hər biri üçün ayrıca göndərilir:

Fayl yaratma və dəyişdirmə, wrangler işə salma. Yalnız göstər,
landing qovluğu ilə nə etmək niyyətindəsən: hansı layihə adı,
hansı konfiqurasiya faylı yazacaqsan, hansı əmri işə salacaqsan.

Bir qeyd: suffiks konfiqurasiya faylının yazıldığı anda yaranır, ona görə hələ konfiqurasiya faylı olmayan qovluq üçün plandakı ad ilə real işə salmadakı ad üst-üstə düşməyə bilər. Qalan hər şey üst-üstə düşəcək.

Üçüncü və dördüncüsü - gündəlik iş üçündür, hər şey elə onlara görə başlanmışdı:

landing qovluğunu Cloudflare Workers-də dərc et.

Mən landing-də index.html-i düzəltdim. Yenidən Cloudflare Workers-də dərc et.

İlk dərc etmədən sonra alınan linki açın, mətni və şəkilləri yoxlayın. Sonra landing/index.html-də bir diqqətçəkən ifadəni dəyişin və dördüncü xahişi göndərin. Səhifəni əvvəlki ünvanda yeniləyin: yeni ifadə görünməlidir. Ünvan dəyişibsə, növbəti deploydan əvvəl agentdən konfiqurasiya faylındakı adı yoxlamağı xahiş edin.

Bununla əsas marşrut tamamlanır: skill yaradıldı, səhifə dərc olundu, yeniləmə eyni link üzrə yoxlanıldı. Hər dərc etmədən əvvəl lazımi qovluğu seçib agentin əmrinə baxmaq qalır.

6. Əlavə ssenarilər

Bir çox qovluğu birdən hazırlamaq və ya brauzerdən giriş olmadan deploy işə salmaq tapşırığınız yoxdursa, davamını oxumaya bilərsiniz.

Prosedur azlıq etməyə başlayanda

Skill-təlimat qovluqlar bir neçə və ya bir neçə onluq olduğu müddətcə yaxşı işləyir. Sonra isə agentin hər dəfə proseduru yenidən oxuyub onu əl ilə icra etməsi mane olmağa başlayır: əlli qovluqda bu uzun çəkir və həmişə eyni cür alınmır.

O zaman prosedur skriptə köçürülür: o, qovluqları özü gəzir, konfiqurasiya fayllarını yazır, heç nə dəyişməyənləri buraxır və yekun xülasə çap edir. Skill bu zaman heç yerə getmir - o, sadəcə konfiqurasiya fayllarını özü yazmaq əvəzinə skripti çağırır, deployu isə yenə də özü işə salır.

Onu yazmaq da sizə düşmür. Agentdə artıq prosedurun ətraflı təsviri var - sizin skilliniz, - ona görə xahiş qısa alınır:

Mənim deploy üçün skillimdə təsvir olunanla eyni işi görən, amma
bunu birbaşa layihənin bütün qovluqları üzrə edən Python skripti yaz.

Kökdə index.html olan qovluqları götürür;
node_modules, .git və dist-ə baxmır.
Hər biri üçün bizim qaydaya görə ad qurur və wrangler.jsonc
faylını qovluğun içinə yazır.
Konfiqurasiya faylı artıq varsa - adı və compatibility_date-i oradan götürür,
faylı isə yalnız məzmun həqiqətən dəyişəndə yenidən yazır.
Konfiqurasiya faylı oxunmursa - ona toxunmur, bunu deyir
və qovluğu ötürür.
Standart olaraq yalnız planı göstərir və heç nə yazmır;
yazma - yalnız açıq flaqla.
Yalnız seçilmiş qovluqları emal etmək üçün filtr lazımdır.
Skript yalnız konfiqurasiya fayllarını hazırlayır, deployu işə salmır.
Sonda cədvəl çap edir: qovluq, layihə adı, nə edildi.
Bu təsvirdə nəsə birmənalı deyilsə - soruş, səssizcə öz-özünə qərar vermə.

Planın göstərilməsi yazmadan əvvəl qovluqların siyahısını yoxlamağa imkan verir. Ad və tarixin saxlanması mövcud konfiqurasiya fayllarını təsadüfi dəyişikliklərdən qoruyur. Skriptin özü yalnız tənzimləmələri hazırlayır; dərc etməni isə yenə də skill icra edir.

Giriş tokeni

Öz kompüterinizdə siz artıq npx wrangler login vasitəsilə giriş etmisiniz. Wrangler avtorizasiyanı saxlayır, ondan agentin əmrləri də istifadə edir.

Brauzerdən giriş olmadan avtomatik işə salma və ya daha dar hüquqlar lazımdırsa, API-token istifadə olunur. Onu profildə yaratmaq olar: avatar, profil, API-tokenlər bölməsi. Birbaşa ünvan - dash.cloudflare.com/profile/api-tokens.

Yaratma formu qorxuducu görünür: hüquq qrupları, resurslar, hansısa filtrlər. Əslində orada dörd qərar var, sahələrin yarısına isə heç toxunmaq lazım deyil.

1. Token adı. Yarım ildən sonra onun nə üçün olduğunu xatırlamayacaqsınız, ona görə mahiyyətə uyğun yazın: "noutbukdan səhifə deployu", "token 2" yox.
2. Hüquqlar. Onları tək-tək toplamaq lazım deyil və dəyməz. Hazır dəstlər siyahısında Edit Cloudflare Workers var - orada dərc etmə üçün lazım olan hər şey artıq toplanıb.
3. Resurslar. Tokeni bir hesabla, məhz dərc etdiyiniz hesabla məhdudlaşdırın. Hesabınız tək olsa belə, onu açıq şəkildə seçin: hesablar çoxala bilər, token isə eyni qalacaq.
4. Yaşama müddəti və IP filtri. Sahələr məcburi deyil. Müddəti token bir axşam üçün və ya yad maşın üçün lazım olanda qoymaq məna kəsb edir; adi işdə onları olduğu kimi saxlayırlar.

Sonra token CLOUDFLARE_API_TOKEN mühit dəyişəninə qoyulur, hesab isə CLOUDFLARE_ACCOUNT_ID-də göstərilir. Mühit dəyişəni - proqramların özü oxuduğu maşınınızın tənzimləməsidir; wrangler hər ikisini sizin iştirakınız olmadan tapacaq. Dəyişənlərin necə qurulduğu və onların harada düzgün saxlanması - ayrı söhbətdir, burada bunun yazışmada bir sətir yox, bir yer olduğunu bilmək kifayətdir.