Управление дисковым пространством

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

Чтобы изменить тип диска и увеличить размер хранилища для кластера:

1. Посмотрите описание команды CLI для изменения кластера:

   yc managed-postgresql cluster update --help
   

2. Укажите тип диска и нужный размер хранилища в команде изменения кластера (размер хранилища должен быть не меньше, чем значение disk_size в свойствах кластера):

   yc managed-postgresql cluster update <имя_или_идентификатор_кластера> \
       --disk-type <тип_диска> \
       --disk-size <размер_хранилища_ГБ>
   

Чтобы изменить тип диска и увеличить размер хранилища для кластера:

1. Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.

   О том, как создать такой файл, см. в разделе Создание кластера.

   Полный список доступных для изменения полей конфигурации кластера Managed Service for PostgreSQL см. в документации провайдера Terraform.

2. Измените в описании кластера Managed Service for PostgreSQL значения атрибутов disk_type_id и disk_size в блоке config.resources:

   resource "yandex_mdb_postgresql_cluster" "<имя_кластера>" {
     ...
     config {
       resources {
         disk_type_id = "<тип_диска>"
         disk_size    = <размер_хранилища_в_гигабайтах>
         ...
       }
     }
   }
   

3. Проверьте корректность настроек.

   1. В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.

   2. Выполните команду:

      terraform validate
      

      Если в файлах конфигурации есть ошибки, Terraform на них укажет.

4. Подтвердите изменение ресурсов.

   1. Выполните команду для просмотра планируемых изменений:

      terraform plan
      

      Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.

   2. Если вас устраивают планируемые изменения, внесите их:

      1. Выполните команду:

         terraform apply
         

      2. Подтвердите изменение ресурсов.

      3. Дождитесь завершения операции.

   Ограничения по времени

   Провайдер Terraform ограничивает время на выполнение операций с кластером Managed Service for PostgreSQL:

   • создание, в том числе путем восстановления из резервной копии, — 30 минут;
   • изменение — 60 минут;
   • удаление — 15 минут.

   Операции, длящиеся дольше указанного времени, прерываются.

   Как изменить эти ограничения?

   Добавьте к описанию кластера блок timeouts, например:

   resource "yandex_mdb_postgresql_cluster" "<имя_кластера>" {
     ...
     timeouts {
       create = "1h30m" # Полтора часа
       update = "2h"    # 2 часа
       delete = "30m"   # 30 минут
     }
   }
   

1. Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:

   export IAM_TOKEN="<IAM-токен>"
   

2. Воспользуйтесь методом Cluster.Update и выполните запрос, например, с помощью cURL:

   Важно

   Метод API переопределит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре updateMask (одной строкой через запятую).

   curl \
     --request PATCH \
     --header "Authorization: Bearer $IAM_TOKEN" \
     --header "Content-Type: application/json" \
     --url 'https://mdb.api.cloud.yandex.net/managed-postgresql/v1/clusters/<идентификатор_кластера>' \
     --data '{
               "updateMask": "configSpec.resources.diskTypeId,configSpec.resources.diskSize",
               "configSpec": {
                 "resources": {
                   "diskTypeId": "<тип_диска>",
                   "diskSize": "<размер_хранилища_в_байтах>"
                 }
               }
             }'
   

   Где:

   • updateMask — перечень изменяемых параметров в одну строку через запятую.

   • configSpec.resources — параметры хранилища:

     • diskTypeId — тип диска.
     • diskSize — новый размер хранилища в байтах.

   Идентификатор кластера можно запросить со списком кластеров в каталоге.

3. Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

1. Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:

   export IAM_TOKEN="<IAM-токен>"
   

2. Клонируйте репозиторий cloudapi:

   cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi
   

   Далее предполагается, что содержимое репозитория находится в директории ~/cloudapi/.

3. Воспользуйтесь вызовом ClusterService.Update и выполните запрос, например, с помощью gRPCurl:

   Важно

   Метод API переопределит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре update_mask (в виде массива строк paths[]).

   Формат перечисления настроек

   "update_mask": {
       "paths": [
           "<настройка_1>",
           "<настройка_2>",
           ...
           "<настройка_N>"
       ]
   }
   

   grpcurl \
     -format json \
     -import-path ~/cloudapi/ \
     -import-path ~/cloudapi/third_party/googleapis/ \
     -proto ~/cloudapi/yandex/cloud/mdb/postgresql/v1/cluster_service.proto \
     -rpc-header "Authorization: Bearer $IAM_TOKEN" \
     -d '{
           "cluster_id": "<идентификатор_кластера>",
           "update_mask": {
             "paths": [
               "config_spec.resources.disk_type_id",
               "config_spec.resources.disk_size"
             ]
           },
           "config_spec": {
             "resources": {
               "disk_type_id": "<тип_диска>",
               "disk_size": "<размер_хранилища_в_байтах>"
             }
           }
         }' \
     mdb.api.cloud.yandex.net:443 \
     yandex.cloud.mdb.postgresql.v1.ClusterService.Update
   

   Где:

   • update_mask — перечень изменяемых параметров в виде массива строк paths[].

   • config_spec.resources — параметры хранилища:

     • disk_type_id — тип диска.
     • disk_size — новый размер хранилища в байтах.

   Идентификатор кластера можно запросить со списком кластеров в каталоге.

4. Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

Чтобы настроить автоматическое увеличение размера хранилища:

1. Посмотрите описание команды CLI для изменения кластера:

   yc managed-postgresql cluster update --help
   

2. Укажите максимальный размер хранилища и условия для его увеличения в команде изменения кластера.

   Максимальный размер хранилища должен быть больше, чем значение disk_size в свойствах кластера. Процент для незамедлительного увеличения хранилища должен быть больше процента для увеличения в следующее окно обслуживания.

   yc managed-postgresql cluster update <идентификатор_или_имя_кластера> \
       --disk-size-autoscaling disk-size-limit=<максимальный_размер_хранилища_в_байтах>,`
                              `planned-usage-threshold=<процент_для_планового_увеличения>,`
                              `emergency-usage-threshold=<процент_для_незамедлительного_увеличения>
   

   Если настроено увеличение хранилища в окно обслуживания, настройте расписание окна обслуживания.

   Подробнее об условиях для увеличения хранилища см. в соответствующем разделе.

1. Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.

   О том, как создать такой файл, см. в разделе Создание кластера.

   Полный список доступных для изменения полей конфигурации кластера Managed Service for PostgreSQL см. в документации провайдера Terraform.

2. Добавьте в блок config блок disk_size_autoscaling:

     resource "yandex_mdb_postgresql_cluster" "<имя_кластера>" {
       ...
       config {
         ...
         disk_size_autoscaling {
           disk_size_limit           = <максимальный_размер_хранилища_ГиБ>
           emergency_usage_threshold = <порог_для_незамедлительного_увеличения_в_процентах>
           planned_usage_threshold   = <порог_для_планового_увеличения_в_процентах>
         }
         ...
       }
       ...
     }
   

   Где:

   • disk_size_limit — максимальный размер хранилища после увеличения, в гибибайтах.

   • emergency_usage_threshold (опционально) — порог заполнения хранилища в процентах, при достижении которого оно будет увеличено незамедлительно. По умолчанию — 0 (автоматическое расширение отключено).

     Допустимые значения: от 0 до 100.

   • planned_usage_threshold (опционально) — порог заполнения хранилища в процентах, при достижении которого оно будет увеличено в следующее окно обслуживания. По умолчанию — 0 (автоматическое расширение отключено).

     Допустимые значения: от 0 до 100.

   Подробнее об условиях для увеличения хранилища см. в соответствующем разделе.

   Важно

   Если заданы оба порога, значение emergency_usage_threshold должно быть не меньше planned_usage_threshold.

3. Если задан параметр planned_usage_threshold, настройте расписание окна технического обслуживания.

4. Проверьте корректность настроек.

   1. В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.

   2. Выполните команду:

      terraform validate
      

      Если в файлах конфигурации есть ошибки, Terraform на них укажет.

5. Подтвердите изменение ресурсов.

   1. Выполните команду для просмотра планируемых изменений:

      terraform plan
      

      Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.

   2. Если вас устраивают планируемые изменения, внесите их:

      1. Выполните команду:

         terraform apply
         

      2. Подтвердите изменение ресурсов.

      3. Дождитесь завершения операции.

   Ограничения по времени

   Провайдер Terraform ограничивает время на выполнение операций с кластером Managed Service for PostgreSQL:

   • создание, в том числе путем восстановления из резервной копии, — 30 минут;
   • изменение — 60 минут;
   • удаление — 15 минут.

   Операции, длящиеся дольше указанного времени, прерываются.

   Как изменить эти ограничения?

   Добавьте к описанию кластера блок timeouts, например:

   resource "yandex_mdb_postgresql_cluster" "<имя_кластера>" {
     ...
     timeouts {
       create = "1h30m" # Полтора часа
       update = "2h"    # 2 часа
       delete = "30m"   # 30 минут
     }
   }
   

1. Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:

   export IAM_TOKEN="<IAM-токен>"
   

2. Воспользуйтесь методом Cluster.Update и выполните запрос, например, с помощью cURL:

   Важно

   Метод API переопределит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре updateMask (одной строкой через запятую).

   curl \
     --request PATCH \
     --header "Authorization: Bearer $IAM_TOKEN" \
     --header "Content-Type: application/json" \
     --url 'https://mdb.api.cloud.yandex.net/managed-postgresql/v1/clusters/<идентификатор_кластера>' \
     --data '{
               "updateMask": "configSpec.diskSizeAutoscaling,maintenanceWindow",
               "configSpec": {
                 "diskSizeAutoscaling": {
                   "plannedUsageThreshold": "<порог_для_планового_увеличения_в_процентах>",
                   "emergencyUsageThreshold": "<порог_для_незамедлительного_увеличения_в_процентах>",
                   "diskSizeLimit": "<максимальный_размер_хранилища_в_байтах>"
                 }
               },
               "maintenanceWindow": {
                 "weeklyMaintenanceWindow": {
                   "day": "<день_недели>",
                   "hour": "<час_дня>"
                 }
               }
             }'
   

   Где:

   • updateMask — перечень изменяемых параметров в одну строку через запятую.

     В данном случае надо передать только параметры configSpec.diskSizeAutoscaling и maintenanceWindow.

   • configSpec — настройки кластера:

     • diskSizeAutoscaling — настройки автоматического увеличения размера хранилища:

       • plannedUsageThreshold (опционально) — порог заполнения хранилища в процентах, при достижении которого оно будет увеличено в следующее окно обслуживания. По умолчанию — 0 (автоматическое расширение отключено).

         Допустимые значения: от 0 до 100.

       • emergencyUsageThreshold (опционально) — порог заполнения хранилища в процентах, при достижении которого оно будет увеличено незамедлительно. По умолчанию — 0 (автоматическое расширение отключено).

         Допустимые значения: от 0 до 100.

       • diskSizeLimit — максимальный размер хранилища после увеличения, в байтах.

       Важно

       • При использовании параметра plannedUsageThreshold необходимо задать окно технического обслуживания в настройке maintenanceWindow.

       • Если заданы оба порога, значение emergencyUsageThreshold должно быть не меньше plannedUsageThreshold.

       Подробнее об условиях для увеличения хранилища см. в соответствующем разделе.

     Значение задается в процентах от 0 до 100. По умолчанию — 0 (автоматическое расширение отключено). Должно быть не меньше значения plannedUsageThreshold.

     • diskSizeLimit — максимальный размер хранилища (в байтах), который может быть установлен при достижении одного из заданных процентов заполнения.

     Подробнее об условиях для увеличения хранилища см. в соответствующем разделе.

   • maintenanceWindow — расписание окна технического обслуживания. Нужно, только если вы задали параметр plannedUsageThreshold. Содержит следующие параметры:

     • day — день недели в формате DDD, когда должно проходить обслуживание.
     • hour — час дня в формате HH, когда должно проходить обслуживание. Возможные значения: от 1 до 24.

   Идентификатор кластера можно запросить со списком кластеров в каталоге.

3. Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

1. Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:

   export IAM_TOKEN="<IAM-токен>"
   

2. Клонируйте репозиторий cloudapi:

   cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi
   

   Далее предполагается, что содержимое репозитория находится в директории ~/cloudapi/.

3. Воспользуйтесь вызовом ClusterService.Update и выполните запрос, например, с помощью gRPCurl:

   Важно

   Метод API переопределит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре update_mask (в виде массива строк paths[]).

   Формат перечисления настроек

   "update_mask": {
       "paths": [
           "<настройка_1>",
           "<настройка_2>",
           ...
           "<настройка_N>"
       ]
   }
   

   grpcurl \
     -format json \
     -import-path ~/cloudapi/ \
     -import-path ~/cloudapi/third_party/googleapis/ \
     -proto ~/cloudapi/yandex/cloud/mdb/postgresql/v1/cluster_service.proto \
     -rpc-header "Authorization: Bearer $IAM_TOKEN" \
     -d '{
           "cluster_id": "<идентификатор_кластера>",
           "update_mask": {
             "paths": [
               "config_spec.disk_size_autoscaling",
               "maintenance_window"
             ]
           },
           "config_spec": {
             "disk_size_autoscaling": {
               "planned_usage_threshold": "<порог_для_планового_увеличения_в_процентах>",
               "emergency_usage_threshold": "<порог_для_незамедлительного_увеличения_в_процентах>",
               "disk_size_limit": "<максимальный_размер_хранилища_в_байтах>"
             }
           },
           "maintenance_window": {
             "weekly_maintenance_window": {
               "day": "<день_недели>",
               "hour": "<час_дня>"
             }
           }
         }' \
     mdb.api.cloud.yandex.net:443 \
     yandex.cloud.mdb.postgresql.v1.ClusterService.Update
   

   Где:

   • update_mask — перечень изменяемых параметров в виде массива строк paths[].

     В данном случае надо передать только параметры config_spec.disk_size_autoscaling и maintenance_window.

   • config_spec — настройки кластера:

     • disk_size_autoscaling — настройки автоматического увеличения размера хранилища:

       • planned_usage_threshold (опционально) — порог заполнения хранилища в процентах, при достижении которого оно будет увеличено в следующее окно обслуживания. По умолчанию — 0 (автоматическое расширение отключено).

         Допустимые значения: от 0 до 100.

       • emergency_usage_threshold (опционально) — порог заполнения хранилища в процентах, при достижении которого оно будет увеличено незамедлительно. По умолчанию — 0 (автоматическое расширение отключено).

         Допустимые значения: от 0 до 100.

       • disk_size_limit — максимальный размер хранилища после увеличения, в байтах.

       Важно

       • При использовании параметра planned_usage_threshold необходимо задать окно технического обслуживания в настройке maintenance_window.

       • Если заданы оба порога, значение emergency_usage_threshold должно быть не меньше planned_usage_threshold.

       Подробнее об условиях для увеличения хранилища см. в соответствующем разделе.

     Подробнее об условиях для увеличения хранилища см. в соответствующем разделе.

   • maintenance_window — расписание окна технического обслуживания. Нужно, только если вы задали параметр planned_usage_threshold. Содержит следующие параметры:

     • day — день недели в формате DDD, когда должно проходить обслуживание.
     • hour — час дня в формате HH, когда должно проходить обслуживание. Возможные значения: от 1 до 24.

   Идентификатор кластера можно запросить со списком кластеров в каталоге.

4. Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.