Удаление GitLab Runner требует последовательного выполнения действий: сначала необходимо определить, какие экземпляры зарегистрированы на сервере, затем остановить их работу и удалить как программное обеспечение, так и сопутствующие конфигурационные файлы. Игнорирование этих шагов может привести к оставлению активных процессов и ненужных файлов, влияющих на производительность системы.
В данном руководстве приведены практические шаги для безопасного удаления GitLab Runner, включая очистку кеша, удаление пользовательских данных и системных сервисов. Следование этим инструкциям позволяет полностью удалить Runner без сохранения остаточных настроек, обеспечивая чистую среду для будущих установок или конфигураций.
Проверка зарегистрированных GitLab Runner на сервере
Если Runner был зарегистрирован через Docker, необходимо проверить контейнеры командой docker ps -a | grep gitlab-runner. Это позволит выявить работающие и остановленные контейнеры, которые могут сохранять конфигурации.
Для серверов с несколькими пользователями рекомендуется проверить наличие Runner, установленных в пользовательских директориях, проверяя файлы ~/.gitlab-runner/config.toml. Это предотвращает случайное удаление Runner, которые используются другими проектами.
Собранная информация о зарегистрированных Runner используется для планирования последовательного удаления: сначала останавливаются активные процессы, затем удаляются конфигурации и связанные файлы.
Остановка работы GitLab Runner перед удалением
Перед удалением GitLab Runner необходимо корректно остановить все работающие процессы, чтобы избежать повреждения конфигурационных файлов и прерывания активных задач CI/CD.
Для систем на базе Linux или macOS выполните следующие шаги:
- Проверьте состояние Runner с помощью команды gitlab-runner status.
- Остановите сервис командой sudo gitlab-runner stop.
- Убедитесь, что процессы завершены, используя ps aux | grep gitlab-runner.
Для Windows используйте PowerShell:
- Проверка статуса сервиса: Get-Service gitlab-runner.
- Остановка сервиса: Stop-Service gitlab-runner.
- Проверка завершения процессов через Task Manager или команду Get-Process gitlab-runner.
Если Runner был установлен через Docker, остановите контейнер командой docker stop <container_id> и убедитесь в его полной остановке с помощью docker ps. Только после подтверждения завершения всех процессов можно переходить к удалению программного обеспечения и конфигурационных файлов.
Удаление GitLab Runner с помощью команды uninstall
После остановки всех процессов GitLab Runner удаление программного обеспечения выполняется через встроенную команду gitlab-runner uninstall. Эта команда удаляет сервисы и юниты, связанные с Runner, освобождая системные ресурсы.
Для Linux и macOS используйте терминал с правами администратора:
- Выполните sudo gitlab-runner uninstall для удаления сервиса.
- Проверьте, что юниты удалены, командой systemctl list-units | grep gitlab-runner.
На Windows процесс выглядит следующим образом:
- Откройте PowerShell с правами администратора.
- Выполните gitlab-runner uninstall для удаления сервиса.
- Убедитесь в отсутствии сервиса через Get-Service gitlab-runner.
Если Runner был установлен через Docker, команда gitlab-runner uninstall не удаляет контейнеры. В этом случае используйте docker rm <container_id> после остановки контейнера, чтобы полностью удалить Runner из системы.
Очистка конфигурационных файлов Runner
После удаления сервиса GitLab Runner необходимо удалить его конфигурационные файлы, чтобы предотвратить конфликт при будущих установках и освободить место на диске.
Для Linux и macOS основной конфигурационный файл находится по пути /etc/gitlab-runner/config.toml. Удаление выполняется командой:
- sudo rm /etc/gitlab-runner/config.toml
Если Runner был установлен на уровне пользователя, конфигурационные файлы могут находиться в директории ~/.gitlab-runner/. Для их удаления используйте:
- rm -rf ~/.gitlab-runner/
На Windows файлы конфигурации обычно хранятся в C:\GitLab-Runner\. Удалите их через проводник или командой PowerShell:
- Remove-Item -Recurse -Force C:\GitLab-Runner\
После удаления конфигурационных файлов рекомендуется проверить, что директории и файлы действительно отсутствуют, чтобы исключить остаточные настройки и данные Runner.
Удаление пользовательских данных и кеша Runner
GitLab Runner сохраняет временные файлы сборок и кеши, которые занимают значительное место на диске. После удаления сервиса важно очистить эти данные, чтобы избежать конфликта с новыми установками.
На Linux и macOS кеш и временные файлы обычно находятся в директориях /var/lib/gitlab-runner/ и /tmp/gitlab-runner/. Удаление выполняется командами:
- sudo rm -rf /var/lib/gitlab-runner/
- sudo rm -rf /tmp/gitlab-runner/
Если Runner запускался от имени конкретного пользователя, кеши могут находиться в ~/.cache/gitlab-runner/. Очистка производится через:
- rm -rf ~/.cache/gitlab-runner/
На Windows временные файлы и кеш располагаются в C:\Users\ИмяПользователя\AppData\Local\GitLab-Runner\. Для их удаления используйте PowerShell:
- Remove-Item -Recurse -Force «C:\Users\ИмяПользователя\AppData\Local\GitLab-Runner\»
После очистки всех пользовательских данных и кеша рекомендуется проверить свободное место на диске и убедиться, что директории полностью удалены.
Удаление системных сервисов и юнитов GitLab Runner
После удаления программного обеспечения необходимо удалить системные сервисы и юниты, чтобы исключить их автоматический запуск и освободить ресурсы ОС.
На Linux с systemd выполните следующие шаги:
- Проверьте наличие юнита: systemctl list-units | grep gitlab-runner
- Остановите сервис: sudo systemctl stop gitlab-runner
- Удалите юнит: sudo systemctl disable gitlab-runner и sudo rm /etc/systemd/system/gitlab-runner.service
- Перезагрузите daemon: sudo systemctl daemon-reload
На Windows сервис GitLab Runner удаляется через PowerShell:
- Остановите сервис: Stop-Service gitlab-runner
- Удалите сервис: sc.exe delete gitlab-runner
- Проверьте отсутствие сервиса: Get-Service gitlab-runner
Если Runner использовался через Docker, убедитесь, что все контейнеры удалены командой docker rm <container_id>, чтобы не оставалось активных служб в контейнерах.
Проверка успешного удаления GitLab Runner
После выполнения всех шагов удаления важно убедиться, что GitLab Runner полностью удалён и не оставил активных процессов или конфигураций на сервере.
Для проверки выполните следующие действия:
| Действие | Команда | Ожидаемый результат |
|---|---|---|
| Проверка сервисов на Linux | systemctl list-units | grep gitlab-runner | |
| Проверка процессов на Linux/macOS | ps aux | grep gitlab-runner | Нет активных процессов GitLab Runner |
| Проверка сервисов на Windows | Get-Service gitlab-runner | Сервис отсутствует в списке |
| Проверка конфигурационных файлов | ls /etc/gitlab-runner/ или dir C:\GitLab-Runner\ | Файлы config.toml и директории отсутствуют |
| Проверка пользовательских данных и кеша | ls ~/.cache/gitlab-runner/ или dir %LOCALAPPDATA%\GitLab-Runner\ | Директории и файлы отсутствуют |
Если все проверки показывают отсутствие процессов, сервисов и файлов, удаление GitLab Runner можно считать завершённым и полным.
Вопрос-ответ:
Какая команда позволяет увидеть все зарегистрированные GitLab Runner на сервере?
Чтобы определить, какие Runner зарегистрированы на сервере, используется команда gitlab-runner list. Она отображает идентификаторы, статусы и теги каждого Runner. Если Runner запускался через Docker, необходимо дополнительно проверить контейнеры командой docker ps -a | grep gitlab-runner, чтобы выявить все экземпляры, включая остановленные.
Как корректно остановить GitLab Runner перед удалением на Linux и Windows?
На Linux или macOS сначала проверяют статус Runner через gitlab-runner status, затем останавливают сервис командой sudo gitlab-runner stop и подтверждают отсутствие процессов через ps aux | grep gitlab-runner. На Windows выполняют Get-Service gitlab-runner для проверки статуса, Stop-Service gitlab-runner для остановки и проверяют процессы через PowerShell или Task Manager.
Что делает команда gitlab-runner uninstall и нужно ли что-то делать дополнительно?
Команда gitlab-runner uninstall удаляет сервисы и юниты Runner, освобождая ресурсы системы. На Linux это удаляет systemd-юниты, а на Windows — сервис. Если Runner запускался через Docker, команда не удаляет контейнеры, поэтому их нужно удалить отдельно командой docker rm <container_id>.
Какие действия выполняются для очистки конфигурационных файлов, пользовательских данных и кеша Runner?
Для Linux и macOS основной конфигурационный файл находится в /etc/gitlab-runner/config.toml, а пользовательские файлы — в ~/.gitlab-runner/ и ~/.cache/gitlab-runner/. Для удаления используют команды rm -rf. На Windows конфигурации и кеши располагаются в C:\GitLab-Runner\ и %LOCALAPPDATA%\GitLab-Runner\, их удаляют через PowerShell с командой Remove-Item -Recurse -Force. Проверка проводится после удаления, чтобы убедиться, что директории и файлы полностью отсутствуют.
Загрузка...
