Изменение настроек инстанса

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

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

По умолчанию секреты создаются в том же каталоге, что и подключения. Чтобы создать секрет в другом каталоге, в параметре --secret-folder-id укажите идентификатор этого каталога (для этого вам потребуется роль resource-manager.user на целевой каталог). Каталоги для подключения и секрета должны находиться в одном облаке. После создания подключения вы не сможете изменить этот параметр.

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

   yc managed-gitlab instance update --help
   

2. Измените настройки инстанса GitLab (в примере приведены не все доступные параметры):

   yc managed-gitlab instance update <имя_или_идентификатор_инстанса> \
     --new-name <новое_имя_инстанса> \
     --resource-preset-id <класс_хостов> \
     --disk-size <размер_диска_ГБ> \
     --deletion-protection \
     --approval-rules <конфигурация_правил_ревью_кода>
   

   Где:

   • --new-name — новое имя инстанса, уникальное в рамках Yandex Cloud. Требования к имени:

     • длина — от 3 до 63 символов;
     • может содержать строчные буквы латинского алфавита, цифры и дефисы;
     • первый символ — буква, последний — не дефис.

   • --resource-preset-id — класс хостов. Он определяет технические характеристики виртуальной машины, на которой будет развернут инстанс GitLab. Возможные значения:

     • s2.micro — 2 vCPU, 8 ГБ RAM.
     • s2.small — 4 vCPU, 16 ГБ RAM.
     • s2.medium — 8 vCPU, 32 ГБ RAM.
     • s2.large — 16 vCPU, 64 ГБ RAM.

   • --disk-size — размер диска в ГБ.

   • --deletion-protection — защита инстанса от случайного удаления пользователем.

     Примечание

     С помощью CLI можно включить, но нельзя отключить защиту от случайного удаления.

   • --approval-rules — конфигурация правил ревью кода. Возможные значения:

     • BASIC — базовая.
     • STANDARD — стандартная.
     • ADVANCED — продвинутая.

     Примечание

     Выбранная конфигурация влияет на стоимость использования вычислительных ресурсов инстанса.

   Результат:

   id: c17c60tpadua********
   folder_id: b1g2slt7p9ug********
   created_at: "2025-07-20T18:34:16.078Z"
   updated_at: "2025-07-20T18:54:49.829961285Z"
   name: test-cli
   resource_preset_id: s2.small
   disk_size: "107374182400"
   status: RUNNING
   admin_login: admin-gl
   admin_email: user@example.com
   domain: test-domain-user.gitlab.yandexcloud.net
   subnet_id: e9b4rrpuu2a********
   backup_retain_period_days: "7"
   deletion_protection: true
   approval_rules_id: BASIC
   gitlab_version: 17.11.6
   

   Подробнее о команде читайте в справочнике CLI.

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

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

2. Измените в описании инстанса GitLab значения параметров:

   resource "yandex_gitlab_instance" "my_gitlab_instance" {
     ...
     resource_preset_id        = "<класс_хостов>"
     disk_size                 = <размер_диска_ГБ>
     approval_rules_id         = "<конфигурация_правил_ревью_кода>"
     backup_retain_period_days = <срок_хранения_копий>
     deletion_protection       = <true_или_false>
     ...
   }
   

   Где:

   • resource_preset_id — класс хостов. Он определяет технические характеристики виртуальной машины, на которой будет развернут инстанс GitLab. Возможные значения:

     • s2.micro — 2 vCPU, 8 ГБ RAM.
     • s2.small — 4 vCPU, 16 ГБ RAM.
     • s2.medium — 8 vCPU, 32 ГБ RAM.
     • s2.large — 16 vCPU, 64 ГБ RAM.

   • disk_size — размер диска в ГБ.

   • approval_rules_id — конфигурация правил ревью кода. Возможные значения:

     • BASIC — базовая.
     • STANDARD — стандартная.
     • ADVANCED — продвинутая.

     Примечание

     Выбранная конфигурация влияет на стоимость использования вычислительных ресурсов инстанса.

   • backup_retain_period_days — срок хранения автоматических резервных копий (в днях).

   • deletion_protection — защита инстанса от случайного удаления пользователем. Возможные значения: true или false.

   Более подробную информацию о параметрах ресурса yandex_gitlab_instance см. в документации провайдера.

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

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

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

      terraform validate
      

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

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

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

   Terraform обновит все требуемые ресурсы. Проверить изменение ресурсов можно в консоли управления или с помощью команды CLI:

   yc managed-gitlab instance list
   

Подробнее см. в документации провайдера Terraform.

Воспользуйтесь методом REST API Update для ресурса Instance или вызовом gRPC API InstanceService/Update.