Контентті басқару

Кэшті тазалау

CDN-ресурсы дұрыс жұмыс істемегенде немесе бастаудағы деректер жаңартылған жағдайда, кэшті ішінара немесе толық тазалау қажет болуы мүмкін.

CDN-ресурсының кэшін тазалау үшін:

Жеке кабинет

API

Өтіңіз в VK Cloud жеке кабинетіне.
Қажетті CDN-ресурс орналасқан жобаны таңдаңыз.
CDN → CDN-ресурсы бөліміне өтіңіз.
Тізімнен қажетті дербес доменнің атауын басыңыз.
Контент қойындысына өтіңіз.
Кэшті тазалау блогында тазалау түрін таңдаңыз:
- Полная — CDN-ресурсының кэшінен барлық файлдарды толығымен жояды. Кэш толық тазаланғанда, CDN-серверлер контентті бастау серверлерінен сұратады, бұл бастауларға түсетін жүктемені арттырып, сервистің жұмысын тұрақсыздандыруы мүмкін. Егер кэштен үлкен көлемдегі контентті жою қажет болса, кэшті таңдамалы тазалауды пайдаланыңыз.
- Выборочная — CDN-ресурсының кэшінен жекелеген файлдарды жоюға мүмкіндік береді. Енгізу өрісінде жойылуы тиіс файлдарға дейінгі жолды немесе жол үлгісін көрсетіңіз. Үлгі үшін келесі таңбаларды пайдаланыңыз:
  - жолдың басында / немесе * пайдаланыңыз;
  - жолдағы кез келген таңбалар санын алмастыру үшін * пайдаланыңыз.
Кэшті тазалау батырмасын басыңыз.

әдісті POST /projects/{project_id}/resources/{resources_id}/purge пайдаланыңыз.

Сұрау денесінде мынаны көрсетіңіз:

[] — CDN-ресурсындағы барлық файлдарды жою үшін;
таңдалған файлдың кэшін тазалау үшін домен атауынсыз файлға дейінгі жолды;
белгілі бір файлдарды жою үшін жол үлгісін. Үлгі үшін келесі таңбаларды пайдаланыңыз:
- жолдың басында / немесе * пайдаланыңыз;
- жолдағы кез келген таңбалар санын алмастыру үшін * пайдаланыңыз.

CDN-ресурсының кэшін тазалауға арналған сұрау мысалы:


curl --location --request POST 'https://kz.cloud.vk.com/api/cdn/api/v1/projects/examplef8f67/resources/175281/purge'\--header 'X-Auth-Token: example6UjMOd'\--header 'Content-Type: application/json'\--data '{    "paths": [        "/test.jpg",        "/static/*",        "*.png",        "*/images/*",        "*/pictures/*.jpg"    ]}'

Кэшті толтыру

Кэшті толтыру (алдын ала жүктеу) пайдаланушы сұрауын алғанға дейін контентті CDN-ресурсының кэшіне орналастыруға мүмкіндік береді. Осылайша CDN-ресурсына алғашқы сұрау кезінде контентті беру уақытын қысқартуға болады. Толтыру көлемі 200 МБ-тан асатын файлдар үшін өзекті.

CDN-ресурсының кэшін толтыру үшін:

Жеке кабинет

API

Өтіңіз в VK Cloud жеке кабинетіне.
Қажетті CDN-ресурс орналасқан жобаны таңдаңыз.
CDN → CDN-ресурсы бөліміне өтіңіз.
Тізімнен қажетті дербес доменнің атауын басыңыз.
Контент қойындысына өтіңіз.
Кэшті толтыру блогында бастаудағы файлдарға дейінгі жолды доменді көрсетпей және әрқайсысын бөлек жолға көрсетіңіз.
Кэшті толтыру батырмасын басыңыз.

әдісті POST /projects/{project_id}/resources/{resources_id}/prefetch пайдаланыңыз.

Сұрау денесінде жүктеу қажет файлдарға дейінгі жолдарды доменді көрсетпей жазыңыз.

CDN-ресурсының кэшін толтыруға арналған сұрау мысалы:


curl --location --request POST 'https://kz.cloud.vk.com/api/cdn/api/v1/projects/examplef8f67/resources/175281/prefetch'\--header 'X-Auth-Token: example6UjMOd'\--header 'Content-Type: application/json'\--data '{    "paths": [        "/video.mp4",        "video.mp4"        ]    }'

HTTP жауап кодының баптауы

HTTP жауап кодының қайтарылуын қосу опциясы CDN-ресурсында орналастырылған контент үшін HTTP жауап кодын орнатуға мүмкіндік береді. Мысалы, басқа URL-ге қайта бағыттауды баптауға немесе белгілі бір файлдар сұралғанда соңғы пайдаланушыларға 403 кодын жіберуге болады.

HTTP жауап кодын баптау үшін:

Жеке кабинет

API

Өтіңіз в VK Cloud жеке кабинетіне.
Қажетті CDN-ресурс орналасқан жобаны таңдаңыз.
CDN → CDN-ресурсы бөліміне өтіңіз.
Тізімнен қажетті дербес доменнің атауын басыңыз.
Контент қойындысына өтіңіз.
HTTP жауап кодының қайтарылуын қосу опциясын қосыңыз.
Жауап коды өрісінде кодты орнатыңыз. Мысалы, 403.
Қайта бағыттауға арналған URL-ді немесе жауап кодының мәтінін енгізіңіз.
Өзгерістерді сақтау батырмасын басыңыз.

CDN-ресурсын жасау кезінде әдісті POST /projects/{project_id}/resources/ пайдаланыңыз.
Бар CDN-ресурсы үшін әдісті PUT /projects/{project_id}/resources/{resources_id} пайдаланыңыз.

options блогында force_return параметрлерін жазыңыз:

Опцияны қосу үшін "enabled": true, өшіру үшін — "enabled": false көрсетіңіз.
code параметрінде HTTP жауап кодын көрсетіңіз. Мысалы, "code": 403.
body параметрінде жауап кодының URL-ін немесе мәтінін көрсетіңіз.

HTTP 403 жауабына арналған баптаулары бар сұрау мысалы:


curl --location --request PUT 'https://kz.cloud.vk.com/api/cdn/api/v1/projects/examplef8f67/resources/175281'\--header 'X-Auth-Token: example6UjMOd'\--header 'Content-Type: application/json'\--data '{    "originGroup": 267760,    "originGroup_name": "exampleorigin",    "secondaryHostnames": [],    "options":        {        "force_return": {            "enabled": true,            "code": 403,            "body": "Доступ запрещен"        }    }}'

GZip сығуы

CDN-ресурсына түсетін файлдарды GZip әдісімен сығуға болады. Бұл әдістің орташа сығу деңгейі 70%-ды құрайды, кейде 90%-ға дейін жетеді. Сығуға арналған файлдың ең аз өлшемі — 128 байт.

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

GZip сығуын қосу үшін:

Жеке кабинет

API

Өтіңіз в VK Cloud жеке кабинетіне.
Қажетті CDN-ресурс орналасқан жобаны таңдаңыз.
CDN → CDN-ресурсы бөліміне өтіңіз.
Тізімнен қажетті дербес доменнің атауын басыңыз.
Контент қойындысына өтіңіз.
GZip сығуын қосу опциясын қосыңыз.
Өзгерістерді сақтау батырмасын басыңыз.

CDN-ресурсын жасау кезінде әдісті POST /projects/{project_id}/resources/ пайдаланыңыз.
Бар CDN-ресурсы үшін әдісті PUT /projects/{project_id}/resources/{resources_id} пайдаланыңыз.

Сұрау денесінде options блогында gzipOn параметрлерін жазыңыз.

GZip сығу баптаулары бар сұрау мысалы:


curl --location --request PUT 'https://kz.cloud.vk.com/api/cdn/api/v1/projects/examplef8f67/resources/175281'\--header 'X-Auth-Token: example6UjMOd'\--header 'Content-Type: application/json'\--data '{    "originGroup": 267760,    "originGroup_name": "exampleorigin",    "secondaryHostnames": [],    "options":        {        "gzipOn": {            "enabled": true,            "value": true        }    }}'

Brotli сығуы

CDN-ресурсына түсетін файлдарды Brotli әдісімен сығуға болады. Бұл әдіс файлдарды GZip-ке қарағанда күштірек сығуға мүмкіндік береді. Мысалы, мәтіндік файлдар үшін Brotli сығу деңгейі орта есеппен GZip-тен 20%-ға жоғары. Сығуға арналған файлдың ең аз өлшемі — 128 байт.

Brotli сығу әдісі қолданылғанда, бастау көзінен сығылмаған файлдар сұратылады, ал сығу арнайы прекэш-серверде жүзеге асады. Прекэш-сервер бастау сервері мен CDN-серверлерінің арасында орналасады және бастау серверін жоғары жүктемеден қорғайды. Прекэш-сервер (shielding) арқылы бастау серверін қорғау — ақылы опция, оны қосу үшін техникалық қолдауға хабарласыңыз.

Опция бастаудағы сығумен және үлкен файлдарды жеткізуді оңтайландырумен бірге жұмыс істемейді.

Brotli сығуын қосу үшін:

Жеке кабинет

API

Өтіңіз в VK Cloud жеке кабинетіне.
Қажетті CDN-ресурс орналасқан жобаны таңдаңыз.
CDN → CDN-ресурсы бөліміне өтіңіз.
Тізімнен қажетті дербес доменнің атауын басыңыз.
Контент қойындысына өтіңіз.
Brotli сығуын қосу опциясын қосыңыз.
Тізімнен сығылатын контент түрлерін таңдаңыз. text/html түрі әдепкі бойынша таңдалған, оны тізімнен жоюға болмайды.
Өзгерістерді сақтау батырмасын басыңыз.

CDN-ресурсын жасау кезінде әдісті POST /projects/{project_id}/resources/ пайдаланыңыз.
Бар CDN-ресурсы үшін әдісті PUT /projects/{project_id}/resources/{resources_id} пайдаланыңыз.

Сұрау денесінде options блогында brotli_compression параметрлерін жазыңыз.

Brotli сығу баптаулары бар сұрау мысалы:


curl --location --request PUT 'https://kz.cloud.vk.com/api/cdn/api/v1/projects/examplef8f67/resources/175281'\--header 'X-Auth-Token: example6UjMOd'\--header 'Content-Type: application/json'\--data '{    "originGroup": 267760,    "originGroup_name": "exampleorigin",    "secondaryHostnames": [],    "options":        {        "brotli_compression": {            "enabled": true,            "value": [                "text/html",                "application/xml+rss",                "application/xml"            ]        }    }}'

Бастаудағы сығу

Контентті бастауда сығу контентті жеткізуді жылдамдатады: контент CDN-серверге сығылған түрде беріледі, бұл деректерді беру уақытын қысқартады. Опция дұрыс жұмыс істеуі үшін бастау көзі сығуды қолдауы тиіс.

Опция GZip сығуымен, Brotli және үлкен файлдарды жеткізуді оңтайландырумен бірге жұмыс істемейді.

CDN-ресурсы бастаудан сығылған контентті сұратуы үшін:

Жеке кабинет

API

Өтіңіз в VK Cloud жеке кабинетіне.
Қажетті CDN-ресурс орналасқан жобаны таңдаңыз.
CDN → CDN-ресурсы бөліміне өтіңіз.
Тізімнен қажетті дербес доменнің атауын басыңыз.
Контент қойындысына өтіңіз.
Бастаудағы сығуды сұрату опциясын қосыңыз.
Өзгерістерді сақтау батырмасын басыңыз.

CDN-ресурсын жасау кезінде әдісті POST /projects/{project_id}/resources/ пайдаланыңыз.
Бар CDN-ресурсы үшін әдісті PUT /projects/{project_id}/resources/{resources_id} пайдаланыңыз.

Сұрау денесінде options блогында fetch_compressed параметрлерін жазыңыз.

Бастаудағы сығу баптаулары бар сұрау мысалы:


curl --location --request PUT 'https://kz.cloud.vk.com/api/cdn/api/v1/projects/examplef8f67/resources/175281'\--header 'X-Auth-Token: example6UjMOd'\--header 'Content-Type: application/json'\--data '{    "originGroup": 267760,    "originGroup_name": "exampleorigin",    "secondaryHostnames": [],    "options":        {        "fetch": {            "enabled": true,            "value": true        }    }}'

Үлкен файлдарды жеткізуді оңтайландыру

Жеткізуді оңтайландыру үшін үлкен файлдар бастау көзінен CDN-ресурсына беріліп, кэште тұтас күйде емес, 10 МБ-тан бөліктермен сақталады. CDN-ресурсы файлды пайдаланушыға ертерек бере бастайды, сондай-ақ файлды бір уақытта бірнеше пайдаланушыға бөліктермен бере алады.

Опция дұрыс жұмыс істеуі үшін бастау көзі HTTP Range request қолдауы тиіс. Егер ресурс үшін бастау топтары пайдаланылса, қолданылатын әрбір бастаудағы файлдарда бірдей Content-Length және ETag тақырыптары болуы тиіс.

Опция қосылғаннан немесе өшірілгеннен кейін кэштеу кілттері өзгереді, контент бастау көзінен қайтадан сұратылады.

Опция GZip сығуымен, Brotli және бастаудағы сығумен бірге жұмыс істемейді.

Үлкен файлдарды жеткізуді оңтайландыруды қосу үшін:

Жеке кабинет

API

Өтіңіз в VK Cloud жеке кабинетіне.
Қажетті CDN-ресурс орналасқан жобаны таңдаңыз.
CDN → CDN-ресурсы бөліміне өтіңіз.
Тізімнен қажетті дербес доменнің атауын басыңыз.
Контент қойындысына өтіңіз.
Үлкен файлдарды жеткізуді оңтайландыруды қосу опциясын қосыңыз.
Өзгерістерді сақтау батырмасын басыңыз.

CDN-ресурсын жасау кезінде әдісті POST /projects/{project_id}/resources/ пайдаланыңыз.
Бар CDN-ресурсы үшін әдісті PUT /projects/{project_id}/resources/{resources_id} пайдаланыңыз.

Сұрау денесінде options блогында slice параметрлерін жазыңыз.

Үлкен файлдарды жеткізуді оңтайландыру баптаулары бар сұрау мысалы:


curl --location --request PUT 'https://kz.cloud.vk.com/api/cdn/api/v1/projects/examplef8f67/resources/175281'\--header 'X-Auth-Token: example6UjMOd'\--header 'Content-Type: application/json'\--data '{    "originGroup": 267760,    "originGroup_name": "exampleorigin",    "secondaryHostnames": [],    "options":        {        "slice": {            "enabled": true,            "value": true        }    }}'

Контентті басқару

Кэшті тазалау

Кэшті толтыру

HTTP жауап кодының баптауы

GZip сығуы

Brotli сығуы

Бастаудағы сығу

Үлкен файлдарды жеткізуді оңтайландыру

Мақала пайдалы болды ма?

Мақала пайдалы болды ма?