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

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

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

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

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

   yc managed-postgresql cluster update --help
   

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

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

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

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

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

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

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

   resource "yandex_mdb_postgresql_cluster" "<имя_кластера>" {
     ...
     config {
       resources {
         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.diskSize",
               "configSpec": {
                 "resources": {
                   "diskSize": "<размер_хранилища_в_байтах>"
                 }
               }
             }'
   

   Где:

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

     В данном случае передается только один параметр.

   • configSpec.resources.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_size"
             ]
           },
           "config_spec": {
             "resources": {
               "disk_size": "<размер_хранилища_в_байтах>"
             }
           }
         }' \
     mdb.api.cloud.yandex.net:443 \
     yandex.cloud.mdb.postgresql.v1.ClusterService.Update
   

   Где:

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

     В данном случае передается только один параметр.

   • config_spec.resources.disk_size — новый размер хранилища в байтах.

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

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

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

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --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. Получите 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 до 100. По умолчанию — 0 (автоматическое расширение отключено).

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

     • emergencyUsageThreshold — процент заполнения хранилища, при котором хранилище будет увеличено немедленно.

       Значение задается в процентах от 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 до 100. По умолчанию — 0 (автоматическое расширение отключено).

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

     • emergency_usage_threshold — процент заполнения хранилища, при котором хранилище будет увеличено немедленно.

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

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

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

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

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

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