Сервистік пакетті дүкенге жүктеу

Сервистік пакетті дүкенге жүктеу deployment system арқылы Infra API сервисінің көмегімен орындалады. Жүктеу сызбасы 1 суретте берілген.

1 сурет — сервистік пакетті жүктеу сызбасы

Сызбаның негізгі элементтерінің сипаттамасы 1 кестеде берілген.

Әрбір қызметке арналған дүкеннің тестілік (NameSpace_test) және ашық (NameSpace_public) namespace-тері сервистік кілтте берілген.

1. Дайындық операциялары орындаңыз.

2. Terraform манифестерін жергілікті түрде тестілеңіз (толығырақ — Terraform манифесін жергілікті тестілеу бөлімінде).

3. Terraform манифестерін deployment system арқылы тестілеңіз (толығырақ — Манифесттерді орналастыру жүйесімен тестілеу бөлімінде).

4. Сервистік пакет файлдарының толтырылғанына және олардың құрылымы JSON-файлы генераторының пайдаланылатын нұсқасына сәйкес келетініне көз жеткізіңіз (толығырақ — Сервис пакетінің құрылымы бөлімінде).

5. Әрбір тарифтік жоспардың ID және ревизия комбинациялары сервистік пакет шеңберінде бірегей екеніне көз жеткізіңіз.

6. Сервистік пакетті (<SERVICE_NAME> директориясы, яғни қызметтің конфигурациялық файлдары мен Terraform манифестері бар бума) zip-архивке қаптаңыз. Архив өлшемі 30 МБ-тан аспауы тиіс.

7. Архивті дүкенге келесі тәсілдердің бірімен жүктеңіз:

   Кабинет поставщика

   Infra API

   1. Бұлтты платформаның VK Cloud ЖК-сіне өтіңіз.
   2. Қолданбалар дүкені бөлімінде Жеткізуші кабинетіне өту түймесін басыңыз.
   3. Қызметтерді басқару қойындысында Қызмет қосу түймесін басыңыз.
   4. Жүйеге жүктеу үшін құрылғыңыздан zip-архивті таңдаңыз.
   5. Қосу түймесін басыңыз.

   Осыдан кейін қосылған қызмет Скрыто күйінде қызметтер тізімінде пайда болады. Жүктелген архив файлы валидацияға жіберіледі.

   Infra API сервисіне келесі параметрлермен сұрау орындаңыз:

   • Сұрау әдісі: POST.

   • Сұрау жолы: https://<CLOUD_HOST>/marketplace/api/infra-api/api/v1-public/product

     Мұнда <CLOUD_HOST> — https://cloud.vk.com бұлтты платформасының домендік атауы.

   • Сұрау денесі: zip-архив.

   • x-service-token: <SERVICE_TOKEN> — сервистік кілт.

     Сервистік пакетті дүкенге жүктеуге арналған сұрау мысалы

     Linux (bash)

     Windows (cmd)

      
     curl -v -X POST https://cloud.vk.com/marketplace/api/infra-api/api/v1-public/product       -H 'x-service-token: <SERVICE_TOKEN>'       -F "upload=@/home/VKservice.zip"

      
     curl -v -X POST https://cloud.vk.com/marketplace/api/infra-api/api/v1-public/product ^-H "x-service-token: <SERVICE_TOKEN>" ^-F "upload=@/home/VKservice.zip"

     Жауаптың HTTP кодтары:

     • 204 — сервистік пакет жүктелді.
     • 400, 404, 500 — сұрауды орындау қатесі.
     • 401 — авторизация қатесі.

     Қызметтің тарифтік жоспарлары мен опцияларын сипаттайтын конфигурациялық файлдар image-based брокерге, ал Terraform манифестері deployment system-ге жіберіледі.

   Дүкенге жүктелетін сервистік пакет алдымен тестілік namespace-ке, ал жарияланғаннан кейін ашық namespace-ке түседі.

8. Қызметті жүктеу аяқталғаннан кейін бұлтты платформаның ЖК-сіне кіріп, қызметтің дүкенде көрсетілетініне көз жеткізіңіз. Жүктелген қызмет тек сервистік кілтте көрсетілген дүкеннің тестілік namespace-терінің пайдаланушыларына ғана қолжетімді болады.

Қызметтің бұлтты платформада қалай жұмыс істейтінін тексеру үшін, сервистік пакет жүктелгеннен кейін қызметті дүкеннің тестілік namespace-інде тестілеңіз:

1. Бұлтты платформаның VK Cloud ЖК-сіне өтіңіз.

2. Әрбір тарифтік жоспардың конфигурация шебері дұрыс көрсетілетініне көз жеткізіңіз.

3. Қызметті қосыңыз. Қызмет инстансын орналастыру сәтті орындалғанына көз жеткізіңіз.

   Егер қызмет инстансын орналастыру кезінде манифесте сипатталған ресурсты құру мүмкін болмаса, deployment system қызметті орналастыру процесін қайта іске қосады. Қайталап әрекет жасау 1,5 сағатқа дейін созылуы мүмкін және оларды settings.yaml файлында өшіруге болады (толығырақ — settings.yaml файлы бөлімінде).

4. Қызмет инстансын жаңартыңыз:

   1. Ағымдағы тарифтік жоспардың тарифтік опцияларының мәндерін өзгертіңіз.

   2. Жаңа тарифтік жоспарға өтіңіз.

      Манифесте сипатталған ресурстар параметрлерінің өзгеруі қызмет инстансын қайта орнату процесін іске қосады, бұл кезде тек өзгертілген ресурстар жаңартылады. Егер deployment system ресурстарды жаңарта алмаса, ол оларды қайта жаңартуға әрекет жасайды. Қайта әрекеттерді ескере отырып, қызмет инстансының конфигурациясын жаңарту процесі 1,5 сағатқа дейін созылуы мүмкін. Қайта әрекеттерді settings.yaml файлында өшіруге болады (толығырақ — settings.yaml файлы бөлімінде).

5. Қызметтің негізгі пайдаланушылық сценарийлерін тексеріңіз.

6. Қызмет инстансын жойыңыз.

7. Қажет болса, қызмет конфигурациясына өзгерістер енгізіңіз (толығырақ — Image-based қосымшаны жаңарту бөлімінде).

8. Егер тестілеу барысында сервистік пакетке өзгерістер енгізілген болса, қызмет ревизиясы жаңартылғанына көз жеткізіңіз.

1. Бұлтты платформаның VK Cloud ЖК-сіне өтіңіз.

2. Қолданбалар дүкені бөліміне өтіңіз.

3. Консольді ашып, дүкенде авторизациялауға арналған JWT-токенді алыңыз:

   Linux (bash)

   Windows (cmd)

    
   curl -X POST https://cloud.vk.com/marketplace/api/um/v1/tokens/sid    --cookie 'sid=<SID>'

    
   curl -X POST https://cloud.vk.com/marketplace/api/um/v1/tokens/sid ^--cookie "sid=<SID>"

   Мұнда <SID> — веб-браузердегі sid cookie файлының мәні.

   Пәрменге жауап ретінде JWT-токен көрсетіледі.

4. Қызмет инстансының логын алыңыз:

   Linux (bash)

   Windows (cmd)

    
   curl -v https://cloud.vk.com/marketplace/api/notifications/api/v1/instance?uuid=<UUID>    -H 'Authorization: Bearer <JWT_TOKEN>'

    
   curl -v https://cloud.vk.com/marketplace/api/notifications/api/v1/instance?uuid=<UUID> ^-H "Authorization: Bearer <JWT_TOKEN>"

   Мұнда:

   • <UUID> — қызмет инстансының идентификаторы. Мәні бұлтты платформаның ЖК-сінде қызмет инстансы бетінде ID параметрінде көрсетіледі.
   • <JWT_TOKEN> — алдыңғы қадамда алынған авторизацияға арналған JWT-токен.