Сервисный аккаунт — это учётная запись, предназначенная для использования в автоматизированных скриптах. Такие аккаунты применяются в CI/CD-пайплайнах и интеграциях. Сервисный аккаунт нельзя использовать для аутентификации в веб-интерфейсе, а также для выполнения действий от его имени через имперсонацию.
Создание сервисного аккаунта
Сервисный аккаунт инстанса создаёт администратор в веб-интерфейсе, через REST API или в Rails-консоли. Сервисные аккаунты группы и проекта создают владелец группы и Maintainer проекта в настройках группы или проекта.
В веб-интерфейсе
- Выберите «Admin» → «Настройки» → «Сервисные аккаунты».
- Нажмите «Добавить сервисный аккаунт».
- Заполните поле «Имя». Поля «Имя пользователя» и «Электронная почта» необязательные.
- Нажмите «Создать».
Через REST API
Отправьте запрос POST /api/v4/service_accounts с токеном администратора. Необязательные параметры name, username и email задают имя, имя пользователя и адрес электронной почты аккаунта.
В Rails-консоли
Откройте Rails-консоль для используемого типа установки:
- Пакет для ОС Linux
- Omnibus Docker
- Helm-чарт
- Модуль Deckhouse Platform
sudo gitlab-rails consoledocker exec -it code gitlab-rails consolecode — имя контейнера из команды docker run в разделе «Быстрый старт».
d8 k -n code exec -it deploy/code-toolbox -- gitlab-rails console -e productionКонсоль входит в набор служебных инструментов Toolbox:
d8 k -n d8-code exec -it -c toolbox deploy/toolbox -- gitlab-rails console -e productionСоздание аккаунта
Используя Rails-консоль, подготовьте параметры с описанием создаваемого аккаунта. Заполните поля
name,username,emailиadminи задайте остальные параметры на основе следующего примера:user_args = { name: 'kaiten_sa', username: 'kaiten_sa', email: 'kaiten_sa@flant.com', admin: false, user_type: :service_account, organization_id: Organizations::Organization.default_organization.id, password_automatically_set: true, force_random_password: true, skip_confirmation: true }Выберите пользователя, от имени которого будет создан сервисный аккаунт, после чего выполните создание пользователя:
user = User.find_by_username('root') Users::CreateService.new(user, user_args).execute
Генерация токена доступа
Чтобы создать токен доступа в веб-интерфейсе:
- Выберите «Admin» → «Настройки» → «Сервисные аккаунты».
- Откройте меню ⋮ в строке аккаунта и выберите «Управление токенами доступа».
- Нажмите «Добавить новый токен».
- Заполните поля «Имя токена» и «Срок действия» и выберите области действия токена.
- Нажмите «Создать токен».
Чтобы создать токен через REST API, используйте Personal access tokens API от GitLab.