• Русский
  • Обновление GitLab

    Обновление GitLab — это относительно простой процесс, но его сложность может увеличиваться в зависимости от:

    Метода установки, который вы использовали. Возраст вашей версии GitLab. Если вы обновляетесь до мажорной версии. По возможности, рекомендуется протестировать обновление в тестовой среде перед обновлением вашей производственной инстанции. Тестовая среда должна максимально точно имитировать производственную.

    Дополнительную информацию можно найти в официальной документации по обновлению.

    Путь обновления

    В таблице ниже приведён полный путь обновления. При обновлении необходимо последовательно обновлять версии Operator и инстанции GitLab.

    Версия Operator Alauda Build of GitLabТребования
    117.8.z-
    217.11.z-
    318.2.zPostgreSQL 16 (требуется обновление)
    318.5.z
    INFO

    В номерах версий выше .z означает последнюю доступную патч-версию для данного минорного релиза. При обновлении всегда следует использовать самую свежую патч-версию, чтобы получить последние обновления безопасности и исправления ошибок. Последние патч-версии для каждого релиза можно найти в Release Notes.

    WARNING

    Если ваша версия GitLab ниже 17.8.5, пожалуйста, обратитесь к разделу GitLab Data Migration для завершения обновления.

    Шаги обновления

    WARNING

    Для безопасного обновления версии GitLab обратите внимание на следующее:

    1. Проверка версии PostgreSQL: Убедитесь, что версия PostgreSQL соответствует требованиям для целевой версии GitLab
    2. Перед обновлением инстанции GitLab обязательно выполните резервное копирование данных инстанции.
    3. Обновление GitLab занимает некоторое время, которое зависит от размера данных GitLab и разрыва между текущей и целевой версиями (количества обновлений).
    4. Инстанция будет недоступна во время процесса обновления.

    При обновлении необходимо последовательно обновлять версию Operator и версию инстанции согласно пути обновления. Обновление Operator не приводит к автоматическому обновлению версии инстанции, а обновлённый Operator не будет управлять старыми инстанциями GitLab, поэтому необходимо своевременно вручную инициировать обновление инстанции.

    Обновление инстанций

    Обновление инстанций через UI

    Перейдите на страницу Administrator -> Marketplace -> Operator Hub, переключитесь на целевой кластер и откройте страницу с деталями Operator Alauda Build of GitLab. Нажмите на имя инстанции, которую хотите обновить, чтобы перейти на страницу её деталей, и нажмите кнопку обновления на странице инстанции.

    Обновление инстанций через YAML

    Перейдите на страницу Administrator -> Clusters -> Resources, переключитесь на целевой кластер и найдите ресурс типа GitLabOfficial. Отредактируйте ресурс инстанции, которую хотите обновить, измените поле spec.version на нужную версию инстанции и сохраните изменения.