[Документация Yandex Cloud](../../../index.md) > [Yandex Managed Service for GitLab](../../index.md) > [Пошаговые инструкции](../index.md) > Изменение настроек инстанса

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

После создания [инстанса GitLab](../../concepts/index.md#instance) вы самостоятельно можете изменить общие и дополнительные настройки инстанса.

## Изменить общие и дополнительные настройки инстанса {#change-settings}

{% note warning %}

При изменении [типа инстанса](../../concepts/index.md#config) или размера диска инстанс GitLab будет временно недоступен.

{% endnote %}

{% list tabs group=instructions %}

- Консоль управления {#console}

  1. В консоли управления выберите [каталог](../../../resource-manager/concepts/resources-hierarchy.md#folder), в котором находится [инстанс GitLab](../../concepts/index.md#instance).
  1. Перейдите в сервис **Managed Service for GitLab**.
  1. Выберите инстанс и нажмите кнопку ![image](../../../_assets/console-icons/pencil.svg) **Редактировать** в верхней части страницы.
  1. В верхней части страницы:

      * Задайте новые имя и описание инстанса.
      * Добавьте [метки](../../../resource-manager/concepts/labels.md) для разделения инстансов на логические группы.
      * Установите или снимите защиту инстанса от случайного удаления пользователем.

  1. В блоке **Конфигурация**:

      * Измените тип инстанса. С текущего типа инстанса можно перейти только на более производительный тип, например с `s2.micro` на `s2.small`. Перейти на менее производительный тип инстанса нельзя.
      * Выберите другую [группу безопасности](../../../vpc/concepts/security-groups.md) или создайте новую:

        * Нажмите кнопку **Создать группу**.
        * Введите имя и описание группы безопасности. Правила для группы безопасности вы сможете добавить позже в сервисе Virtual Private Cloud.
        * Нажмите кнопку **Создать**.

        Если не задать отдельную группу безопасности, будет использована [группа безопасности по умолчанию](../../../vpc/concepts/security-groups.md#default-security-group), созданная в сети инстанса.
        
        [Настройте](../configure-security-group.md) группу безопасности так, чтобы правила разрешали входящий и исходящий трафик с нужных портов и IP-адресов.
              
        {% note warning %}
        
        От настройки группы безопасности зависит работоспособность и доступность инстанса Managed Service for GitLab.
        
        {% endnote %}
        
        Если у вас возникли проблемы с настройкой группы безопасности, обратитесь в [техническую поддержку](https://kz.center.yandex.cloud/support).

      * Задайте размер диска. Размер диска можно увеличить или оставить прежним. Уменьшить размер диска нельзя.
      * Измените срок хранения автоматических резервных копий (в днях).
      * Выберите подходящую [конфигурацию](../../concepts/approval-rules.md#packages) правил ревью кода.

          {% note warning %}
          
          За использование правил ревью кода в Managed Service for GitLab взимается плата в зависимости от используемой [конфигурации](../../concepts/approval-rules.md#packages). Подробнее читайте на странице [Правила тарификации для Yandex Managed Service for GitLab](../../pricing.md).
          
          {% endnote %}

      * Укажите [токен GitLab](../approval-rules.md#gitlab-token) для активации правил ревью кода.

  1. В блоке **Дополнительные настройки** включите или отключите удаление образов без тегов. Настройка влияет на свободное место на диске инстанса.
  1. Нажмите кнопку **Сохранить**.

- CLI {#cli}

  Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), [установите и инициализируйте его](../../../cli/quickstart.md#install).

  По умолчанию используется каталог, указанный при [создании](../../../cli/operations/profile/profile-create.md) профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду `yc config set folder-id <идентификатор_каталога>`. Также для любой команды вы можете указать другой каталог с помощью параметров `--folder-name` или `--folder-id`. Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.

  1. Посмотрите описание команды [CLI](../../../cli/index.md) для изменения настроек инстанса Managed Service for GitLab:

      ```bash
      yc managed-gitlab instance update --help
      ```

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

      ```bash
      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` — защита инстанса от случайного удаления пользователем.

          {% note info %}

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

          {% endnote %}

      * `--approval-rules` — конфигурация [правил ревью кода](../../concepts/approval-rules.md). Возможные значения:

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

          {% note warning %}
          
          За использование правил ревью кода в Managed Service for GitLab взимается плата в зависимости от используемой [конфигурации](../../concepts/approval-rules.md#packages). Подробнее читайте на странице [Правила тарификации для Yandex Managed Service for GitLab](../../pricing.md).
          
          {% endnote %}

      Результат:

      ```text
      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](../../cli-ref/instance/update.md).

- Terraform {#tf}

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

      Как создать такой файл, описано в разделе [Создать инстанс GitLab](instance-create.md#create).

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

      ```hcl
      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` — конфигурация [правил ревью кода](../../concepts/approval-rules.md). Возможные значения:

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

          {% note warning %}
          
          За использование правил ревью кода в Managed Service for GitLab взимается плата в зависимости от используемой [конфигурации](../../concepts/approval-rules.md#packages). Подробнее читайте на странице [Правила тарификации для Yandex Managed Service for GitLab](../../pricing.md).
          
          {% endnote %}

      * `backup_retain_period_days` — срок хранения автоматических резервных копий (в днях).
      * `deletion_protection` — защита инстанса от случайного удаления пользователем. Возможные значения: `true` или `false`.

      Подробнее о параметрах ресурса `yandex_gitlab_instance` в [документации провайдера](../../../terraform/resources/gitlab_instance.md).

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

      1. В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.
      1. Выполните команду:
      
         ```bash
         terraform validate
         ```
      
         Если в файлах конфигурации есть ошибки, Terraform на них укажет.

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

      1. Выполните команду для просмотра планируемых изменений:
      
         ```bash
         terraform plan
         ```
      
         Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.
      
      1. Если вас устраивают планируемые изменения, внесите их:
         1. Выполните команду:
      
            ```bash
            terraform apply
            ```
      
         1. Подтвердите изменение ресурсов.
         1. Дождитесь завершения операции.

      Terraform обновит все требуемые ресурсы. Проверить изменение ресурсов можно в [консоли управления](https://console.yandex.cloud) или с помощью команды [CLI](../../../cli/index.md):

      ```bash
      yc managed-gitlab instance list
      ```

  Подробнее в [документации провайдера Terraform](../../../terraform/resources/gitlab_instance.md).

- API {#api}

  Воспользуйтесь методом REST API [Update](../../api-ref/Instance/update.md) для ресурса [Instance](../../api-ref/Instance/index.md) или вызовом gRPC API [InstanceService/Update](../../api-ref/grpc/Instance/update.md).

{% endlist %}