Astro-сайтын объекттік қоймада CDN-мен орналастыру
VK Object Storage және CDN көмегімен Astro фреймворкіндегі статикалық сайтты жаһандық контент жеткізумен және төмен кешігуге ие түрде орналастыруға болады. Нысаналық қойма фронтенд үшін serverless-хостинг рөлін атқарады, ал CDN edge-серверлерде кэштеуді және контентті HTTPS арқылы жеткізуді қамтамасыз етеді.
Мысал ретінде келесі деректер қолданылады:
- Бакет атауы:
astro-site-bucket - Сайттың домен атауы:
astro.example.com - Жинақталған жобаның директориясы:
./dist - Қойманың эндпоинті:
https://hb.ru-msk.vkcloud-storage.ru
-
AWS CLI орнатылғанын және бапталғанын тексеріңіз.
-
Келесі параметрлерімен VK Object Storage бакет жасаңыз:
- Атауы:
astro-site-bucket. Бакет атауы атау ережелеріне сәйкес болуы тиіс. - Сақтау класы:
Hotbox— көптеген файлдарды жылдам таратуға жарамды.
- Атауы:
-
Егер әлі орнатылмаған болса, Node.js 18 нұсқасын немесе одан жаңалауын орнатыңыз.
-
Astro жобасын жасаңыз:
npm create astro@latest -
astro.example.comдоменінің DNS-жазбаларын басқаруға қолжетімділігіңіз бар екенін тексеріңіз.
-
Astro жобасының директориясына өтіңіз.
-
astro.config.mjsфайлында статикалық шығу бапталғанын тексеріңіз:import { defineConfig } from 'astro/config';export default defineConfig({output: 'static',}); -
Жобаны жинаңыз:
npm run build./distдиректориясында сайттың статикалық файлдары пайда болады:index.html, қате беттері, суреттер, CSS және JavaScript файлдары. -
./distтүбіріндеindex.htmlжәне404.htmlфайлдары бар екенін тексеріңіз. Егер404.htmlфайлы автоматты түрде жасалмаған болса, оны қолмен жасаңыз.
Статикалық сайт конфигурациясын баптаңыз. Конфигурацияда бакет үшін индекстік құжатты және қате бетін көрсетіңіз. Бұл конфигурация файлы арқылы немесе бірден AWS CLI командасында жасалуы мүмкін:
aws s3api put-bucket-website \--bucket astro-site-bucket \--website-configuration '{"IndexDocument":{"Suffix":"index.html"},"ErrorDocument":{"Key":"404.html"}}' \--endpoint-url https://hb.ru-msk.vkcloud-storage.ru
Мұнда:
index.html— бакет түбіріне өткенде берілетін құжат.404.html— 404 қатесі кезінде берілетін құжат.
Конфигурация бапталғаннан кейін статикалық сайт келесі мекенжай бойынша қолжетімді болады: https://astro-site-bucket.hb-website.hb.ru-msk.vkcloud-storage.ru
-
Сайт нысандарына жалпыхалықтық оқу қолжетімділігін баптаңыз. Әдістердің бірін қолданыңыз.
Қолжетімділік саясаты (ұсынылады)ACL-
Нысандарды анонимді оқуға рұқсат беретін саясаты бар
policy.jsonфайлын жасаңыз:{"Version": "2012-10-17","Statement": [{"Sid": "PublicReadGetObject","Effect": "Allow","Principal": "*","Action": "s3:GetObject","Resource": ["arn:aws:s3:::astro-site-bucket/*"]}]} -
Саясатты қолданыңыз:
aws s3api put-bucket-policy \--bucket astro-site-bucket \--policy file://policy.json \--endpoint-url https://hb.ru-msk.vkcloud-storage.ru
-
-
Егер сайт қоймадағы ресурстарға кросс-домендік сұраныстар жасаса, бакет үшін CORS баптаңыз.
CORS XML-конфигурациясының мысалы:
<CORSConfiguration><CORSRule><AllowedOrigin>https://astro.example.com</AllowedOrigin><AllowedMethod>GET</AllowedMethod><AllowedMethod>HEAD</AllowedMethod><AllowedHeader>*</AllowedHeader><MaxAgeSeconds>3000</MaxAgeSeconds></CORSRule></CORSConfiguration>Мұнда:
AllowedOrigin— бакетке сұраныстар жасауға рұқсат етілген сайт домені.AllowedMethods— сұраныстарда рұқсат етілген HTTP-әдістер.MaxAgeSeconds— алдын ала сұраныс нәтижелерін браузерде кэштеу уақыты.
-
AWS CLI көмегімен
./distдиректориясының мазмұнын бакетпен синхрондаңыз:aws s3 sync ./dist s3://astro-site-bucket \--endpoint-url https://hb.ru-msk.vkcloud-storage.ruКоманда тек жаңа және өзгертілген файлдарды жүктейді, бұл қайта деплойлауды жылдамдатады.
-
Файлдар жүктелгенін тексеріңіз:
aws s3 ls s3://astro-site-bucket \--endpoint-url https://hb.ru-msk.vkcloud-storage.ru
-
astro-site-bucketбакетінің интерфейсі арқылы CDN-ресурсын жасаңыз. Параметрлерде көрсетіңіз:- Жеке домен:
astro.example.com. - Кэштің өмір сүру уақыты:
4. Статикалық сайт үшін1-ден7күнге дейінгі мәнді көрсеткен ұсынылады.
- Жеке домен:
-
Әрі қарай баптау үшін CDN бөліміне өту үшін CDN-ресурсіне өту түймесін басыңыз.
-
CDN-ресурсының қызметтік домен атауын сақтаңыз (мысалы,
cl-541e19d9.service.cdn.msk.vkcs.cloud) — ол CNAME-жазбасын жасау үшін қажет болады. -
Соңғы пайдаланушыларға контентке қолжетімділікті қосыңыз. Бұл кейін Let's Encrypt SSL-сертификаты ретінде таңдау мүмкіндігі үшін қажет.
-
Пайдаланушыларға деректерді қауіпсіз жеткізу үшін CDN-ресурсы үшін дереккөзбен өзара әрекеттесу хаттамасы ретінде HTTPS таңдаңыз. Бұл Let's Encrypt SSL-сертификаты ретінде қолдану үшін де қажет.
-
CDN-ресурсының шифрлау баптауларында Let's Encrypt опциясын таңдаңыз — CNAME-жазбалары DNS-те таралғаннан кейін (әдетте 30 минутқа дейін) автоматты түрде жасалатын тегін SSL-сертификаты қолданылады. SSL-сертификаттарын басқару туралы толығырақ — SSL-сертификатын қолдану бөлімінде.
-
DNS-жазбасын баптаңыз:
astro.example.comдомені үшін CNAME-жазбасын жасаңыз, псевдоним ретінде сақталған CDN-ресурсының қызметтік домен атауын көрсетіңіз. Егер VK Cloud DNS қызметі қолданылса, DNS-жазбаларын қосу нұсқаулығын орындаңыз.
CDN-ресурсында кэштеуді баптаңыз. Әртүрлі контент түрлері үшін ұсынылатын TTL мәндері туралы толығырақ Контентті кэштеу бөлімінде.
- Басқа сайттардың сіздің ресурстарыңызды қолдануын болдырмау үшін домен бойынша қолжетімділік саясатын баптаңыз.
- Дереккөздерге географиялық белгі бойынша контентке қолжетімділікті шектеу үшін елдер бойынша қолжетімділік саясатын баптаңыз.
-
Сайтты браузерде
https://astro.example.comмекенжайы бойынша ашыңыз. Astro-сайттың басты беті көрсетілуі тиіс. -
Қате бетін тексеріңіз — мысалы,
https://astro.example.com/nonexistent-pageсияқты жоқ URL ашыңыз.404.htmlбеті көрсетілуі тиіс. -
Жауап тақырыптарын тексеріңіз:
curl -I https://astro.example.comКелесілерді тексеріңіз:
Content-Typeтақырыбында дұрыс MIME-типі көрсетілген.- CDN-нен кэштеу тақырыптары бар.
-
Суреттер мен басқа статикалық ресурстардың дұрыс жүктелетінін тексеріңіз.
Жасалған ресурстар тарифтеленеді. Егер олар сізге қажет болмаса:
- Бакеттен нысандарды жойыңыз.
- Бакетті жойыңыз.
- Егер қажет болмаса, CDN-ресурсын жойыңыз.