PostgreSQL нұсқасын жаңарту

ДҚ инстанстарының тізімін алыңыз:

 
curl \  --request GET \  --url https://<эндпоинт API>/<идентификатор проекта>/instances \  --header 'X-Auth-Token: <токен>'

 
curl `  --request GET `  --url https://<эндпоинт API>/<идентификатор проекта>/instances `  --header 'X-Auth-Token: <токен>'

API сұрауына берілген жауаптан Master рөлі бар инстанстың идентификаторын анықтаңыз. Master-Replica конфигурациясында барлық инстанстарды жаңарту Master рөлі бар ДҚ инстансын жаңарту арқылы орындалады. Жаңартуды тек Replica рөлі бар инстанстар үшін ғана орындау мүмкін емес.

Мұндай инстанстың идентификаторын анықтау үшін:

1. instances[].name өрісінен қажетті атауы бар инстансты табыңыз.

2. Бұл PostgreSQL инстансы екеніне көз жеткізіңіз:

    
   {  "instances": [    {      "id": "<идентификатор инстанса>",      "name": "<имя инстанса>",      ...      "datastore": {        "type": "<тип СУБД: postgresql>",        "version": "<версия СУБД>"      },      ...    },  ...]}

3. instances[].replica_of өрісінің бар-жоғын тексеріңіз:

   • Егер мұндай өріс бар болса, онда бұл Replica рөлі бар инстанс, ал өрістегі мән — Master рөлі бар инстанстың қажет идентификаторы.
   • Егер мұндай өріс жоқ болса, онда бұл Master рөлі бар инстанс. Осы инстанстың идентификаторын instances[].id өрісінен жазыңыз.

API сұрауына берілген жауаптан жаңартуға болатын нұсқаны анықтаңыз. Бұл үшін Master рөлі бар инстанс туралы мәліметтерді қараңыз. Replica рөлі бар инстанстар үшін жаңарту мүмкіндіктері туралы ақпарат берілмейді.

 
{  "instances": [    {      "id": "<идентификатор инстанса с ролью Master>",      ...      "datastore": {        ...,        "version": "<версия СУБД>"      },      ...      "upgrade_info": {        "major_version": "<версия, на которую можно обновиться>",        "minor_versions": []      },    },  ...]}

Жаңартуды instances[].upgrade_info.major_version өрісінде көрсетілген нұсқаға дейін орындауға болады. Егер өрісте — бос мән болса, онда ДҚ инстансы ең өзекті нұсқаны пайдаланып тұр және жаңарту қажет емес.

ДҚ инстансын бірден бірнеше нұсқа алға жаңартқанда аралық нұсқаларды өткізіп жіберу мүмкін емес:

• PostgreSQL 10 → 11 → 12 → 13 → 14 жаңартуын орындауға болады;
• PostgreSQL 10 → 14 жаңартуын орындауға болмайды;

API сұрауына берілген жауаптан Master рөлі бар инстанс үшін барлық репликаларды табыңыз және, егер олар бар болса, олардың идентификаторларын алыңыз. Идентификаторлар репликалар үшін жаңарту барысын бақылау үшін қажет.

Master рөлі бар инстанстың идентификаторы бойынша іздеуді орындаңыз:

• Егер осы идентификатор instances[].replica_of өрістерінде аталған болса, онда осындай мәндері бар өрістері бар инстанстар — репликалар. Олардың идентификаторларын жазыңыз.

   
  {   "instances": [     {       "id": "<идентификатор инстанса c ролью Replica>",       ...,       "replica_of": "<идентификатор инстанса с ролью Master>",       ...     },   ...]}

• Егер осы идентификатор instances[].replica_of өрістерінде табылмаса, онда репликалар жоқ, ал осындай идентификаторы бар инстанс — Single конфигурациясында. Қосымша әрекеттер қажет емес.

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

 
curl \  --request PATCH \  --url https://<эндпоинт API>/<идентификатор проекта>/instances/<идентификатор инстанса с ролью Master> \  --header 'X-Auth-Token: <токен>' \  --data '{      "instance":        {            "datastore_version": "<версия, на которую нужно обновиться>"        }   }'

 
curl `  --request PATCH `  --url https://<эндпоинт API>/<идентификатор проекта>/instances/<идентификатор инстанса с ролью Master> `  --header 'X-Auth-Token: <токен>' `  --data '{      \"instance\":        {            \"datastore_version\": \"<версия, на которую нужно обновиться>\"        }   }'

Жаңарту басталады, процесс ұзақ уақыт алуы мүмкін.

Жеке Master немесе Replica рөлі бар инстанстар үшін (бар болса) жаңарту барысын мерзімді түрде тексеріп отырыңыз:

 
curl \  --request GET \  --url https://<эндпоинт API>/<идентификатор проекта>/instances/<идентификатор инстанса> \  --header 'X-Auth-Token: <токен>'

 
curl `  --request GET `  --url https://<эндпоинт API>/<идентификатор проекта>/instances/<идентификатор инстанса> `  --header 'X-Auth-Token: <токен>'

Жаңарту кезінде instance.status өрісінің мәні ретімен BACKUP, UPGRADE болып өзгереді.

Жаңарту аяқталғаннан кейін:

• instance.status өрісіндегі мән ACTIVE болып өзгереді.
• instance.last_task_result өрісінде соңғы орындалған операцияның нәтижесі туралы ақпарат пайда болады. Сәтті жаңартылғандағы мәні — MAJOR_UPGRADE_COMPLETED.