VK Cloud logo

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

Дайындық қадамдар

  1. AWS CLI орнатылғанын және бапталғанын тексеріңіз.

  2. Келесі параметрлерімен VK Object Storage бакет жасаңыз:

    • Атауы: astro-site-bucket. Бакет атауы атау ережелеріне сәйкес болуы тиіс.
    • Сақтау класы: Hotbox — көптеген файлдарды жылдам таратуға жарамды.
  3. Егер әлі орнатылмаған болса, Node.js 18 нұсқасын немесе одан жаңалауын орнатыңыз.

  4. Astro жобасын жасаңыз:

    npm create astro@latest
  5. astro.example.com доменінің DNS-жазбаларын басқаруға қолжетімділігіңіз бар екенін тексеріңіз.

1. Astro-жобасын жинаңыз

  1. Astro жобасының директориясына өтіңіз.

  2. astro.config.mjs файлында статикалық шығу бапталғанын тексеріңіз:

    import { defineConfig } from 'astro/config';export default defineConfig({  output: 'static',});
  3. Жобаны жинаңыз:

    npm run build

    ./dist директориясында сайттың статикалық файлдары пайда болады: index.html, қате беттері, суреттер, CSS және JavaScript файлдары.

  4. ./dist түбірінде index.html және 404.html файлдары бар екенін тексеріңіз. Егер 404.html файлы автоматты түрде жасалмаған болса, оны қолмен жасаңыз.

2. Статикалық сайтты хостингке арналған бакетті баптаңыз

Статикалық сайт конфигурациясын баптаңыз. Конфигурацияда бакет үшін индекстік құжатты және қате бетін көрсетіңіз. Бұл конфигурация файлы арқылы немесе бірден 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

3. Қолжетімділік құқықтарын және CORS баптаңыз

  1. Сайт нысандарына жалпыхалықтық оқу қолжетімділігін баптаңыз. Әдістердің бірін қолданыңыз.

    1. Нысандарды анонимді оқуға рұқсат беретін саясаты бар policy.json файлын жасаңыз:

      {"Version": "2012-10-17","Statement": [   {      "Sid": "PublicReadGetObject",      "Effect": "Allow",      "Principal": "*",      "Action": "s3:GetObject",      "Resource": ["arn:aws:s3:::astro-site-bucket/*"]   }]}
    2. Саясатты қолданыңыз:

      aws s3api put-bucket-policy \--bucket astro-site-bucket \--policy file://policy.json \--endpoint-url https://hb.ru-msk.vkcloud-storage.ru
  2. Егер сайт қоймадағы ресурстарға кросс-домендік сұраныстар жасаса, бакет үшін 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 — алдын ала сұраныс нәтижелерін браузерде кэштеу уақыты.

4. Сайт файлдарын бакетке жүктеңіз

  1. AWS CLI көмегімен ./dist директориясының мазмұнын бакетпен синхрондаңыз:

    aws s3 sync ./dist s3://astro-site-bucket \  --endpoint-url https://hb.ru-msk.vkcloud-storage.ru

    Команда тек жаңа және өзгертілген файлдарды жүктейді, бұл қайта деплойлауды жылдамдатады.

  2. Файлдар жүктелгенін тексеріңіз:

    aws s3 ls s3://astro-site-bucket \  --endpoint-url https://hb.ru-msk.vkcloud-storage.ru

5. CDN қосыңыз және домен байланыстырыңыз

  1. astro-site-bucket бакетінің интерфейсі арқылы CDN-ресурсын жасаңыз. Параметрлерде көрсетіңіз:

    • Жеке домен:astro.example.com.
    • Кэштің өмір сүру уақыты: 4. Статикалық сайт үшін 1-ден 7 күнге дейінгі мәнді көрсеткен ұсынылады.
  2. Әрі қарай баптау үшін CDN бөліміне өту үшін CDN-ресурсіне өту түймесін басыңыз.

  3. CDN-ресурсының қызметтік домен атауын сақтаңыз (мысалы, cl-541e19d9.service.cdn.msk.vkcs.cloud) — ол CNAME-жазбасын жасау үшін қажет болады.

  4. Соңғы пайдаланушыларға контентке қолжетімділікті қосыңыз. Бұл кейін Let's Encrypt SSL-сертификаты ретінде таңдау мүмкіндігі үшін қажет.

  5. Пайдаланушыларға деректерді қауіпсіз жеткізу үшін CDN-ресурсы үшін дереккөзбен өзара әрекеттесу хаттамасы ретінде HTTPS таңдаңыз. Бұл Let's Encrypt SSL-сертификаты ретінде қолдану үшін де қажет.

  6. CDN-ресурсының шифрлау баптауларында Let's Encrypt опциясын таңдаңыз — CNAME-жазбалары DNS-те таралғаннан кейін (әдетте 30 минутқа дейін) автоматты түрде жасалатын тегін SSL-сертификаты қолданылады. SSL-сертификаттарын басқару туралы толығырақ — SSL-сертификатын қолдану бөлімінде.

  7. DNS-жазбасын баптаңыз: astro.example.com домені үшін CNAME-жазбасын жасаңыз, псевдоним ретінде сақталған CDN-ресурсының қызметтік домен атауын көрсетіңіз. Егер VK Cloud DNS қызметі қолданылса, DNS-жазбаларын қосу нұсқаулығын орындаңыз.

6. Кэштеу ережелерін баптаңыз

CDN-ресурсында кэштеуді баптаңыз. Әртүрлі контент түрлері үшін ұсынылатын TTL мәндері туралы толығырақ Контентті кэштеу бөлімінде.

7. Контентке қолжетімділікті баптаңыз

  1. Басқа сайттардың сіздің ресурстарыңызды қолдануын болдырмау үшін домен бойынша қолжетімділік саясатын баптаңыз.
  2. Дереккөздерге географиялық белгі бойынша контентке қолжетімділікті шектеу үшін елдер бойынша қолжетімділік саясатын баптаңыз.

Жұмыс істеуін тексеріңіз

  1. Сайтты браузерде https://astro.example.com мекенжайы бойынша ашыңыз. Astro-сайттың басты беті көрсетілуі тиіс.

  2. Қате бетін тексеріңіз — мысалы, https://astro.example.com/nonexistent-page сияқты жоқ URL ашыңыз. 404.html беті көрсетілуі тиіс.

  3. Жауап тақырыптарын тексеріңіз:

    curl -I https://astro.example.com

    Келесілерді тексеріңіз:

    • Content-Type тақырыбында дұрыс MIME-типі көрсетілген.
    • CDN-нен кэштеу тақырыптары бар.
  4. Суреттер мен басқа статикалық ресурстардың дұрыс жүктелетінін тексеріңіз.

Қолданылмайтын ресурстарды жойыңыз

Жасалған ресурстар тарифтеленеді. Егер олар сізге қажет болмаса:

  1. Бакеттен нысандарды жойыңыз.
  2. Бакетті жойыңыз.
  3. Егер қажет болмаса, CDN-ресурсын жойыңыз.
Мақала пайдалы болды ма?