Модуль community.general.gitlab_project_access_token — управление токенами доступа к проектам GitLab

Примечание

Этот модуль входит в коллекцию community.general (версия 12.6.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install community.general. Для использования этого модуля могут потребоваться дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: community.general.gitlab_project_access_token.

Добавлено в community.general 8.4.0

Краткое описание
Требования
Параметры
Атрибуты
Примечания
Примеры
Возвращаемые значения

Краткое описание

Создаёт и отзывает токены доступа к проектам.

Требования

Следующие требования должны быть выполнены на узле, который выполняет этот модуль.

python-gitlab >= 3.1.0
requests (библиотека Python https://pypi.org/project/requests/)

Параметры

Параметр	Комментарии
access_level string	Уровень доступа токена доступа. Значение `planner` добавлено в community.general 11.3.0. Варианты: `"guest"` `"planner"` `"reporter"` `"developer"` `"maintainer"` ← (по умолчанию) `"owner"`
api_job_token string добавлено в community.general 4.2.0	Токен задания GitLab CI для входа в систему.
api_oauth_token string добавлено в community.general 4.2.0	Токен OAuth GitLab для входа в систему.
api_password string	Пароль для аутентификации в API.
api_token string	Токен доступа GitLab с разрешениями API.
api_url string	Адрес конечной точки API, доступный для разрешения имени.
api_username string	Имя пользователя для аутентификации в API.
ca_path string добавлено в community.general 8.1.0	Пакет сертификатов CA для проверки сертификата сервера GitLab.
expires_at string / обязательный	Дата истечения срока действия токена доступа в формате `YYYY-MM-DD`. Обязательно заключите это значение в кавычки в YAML, чтобы оно осталось строкой и не было интерпретировано как дата YAML.
name string / обязательный	Имя токена доступа.
project string / обязательный	Идентификатор или полный путь проекта в формате group/name.
recreate string	Следует ли пересоздавать токен доступа, если он уже существует. Если задано `never`, токен никогда не пересоздаётся. Если задано `always`, токен пересоздаётся всегда. Если задано `state_change`, токен пересоздаётся, если желаемое состояние отличается от фактического. Варианты: `"never"` ← (по умолчанию) `"always"` `"state_change"`
scopes псевдонимы: scope list / элементы=string / обязательный	Область действия токена доступа. Значения `manage_runner` и `self_rotate` добавлены в community.general 11.3.0. Варианты: `"api"` `"read_api"` `"read_registry"` `"write_registry"` `"read_repository"` `"write_repository"` `"create_runner"` `"manage_runner"` `"ai_features"` `"k8s_proxy"` `"self_rotate"`
state string	Если задано `present`, токен доступа добавляется в проект, если он ещё не существует. Если задано `absent`, токен удаляется из проекта, если он существует. Варианты: `"present"` ← (по умолчанию) `"absent"`
validate_certs boolean	Проверять ли сертификаты SSL при указании конечной точки HTTPS. Варианты: `false` `true` ← (по умолчанию)

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Может работать в режиме `check_mode` и возвращать прогноз изменения состояния, не изменяя целевой объект.
diff_mode	Поддержка: отсутствует	В режиме сравнения возвращает сведения об изменениях (или о возможных изменениях в `check_mode`).

Примечания

Примечание

Токены доступа нельзя изменить. Если необходимо изменить параметр, токен доступа нужно пересоздать. Пересоздание токенов регулируется параметром recreate, значение которого по умолчанию — never.
Строка токена содержится в результате только при создании или пересоздании токена доступа. После этого получить её невозможно.
Сопоставление токенов выполняется по параметру name.

Примеры

- name: "Creating a project access token"
  community.general.gitlab_project_access_token:
    api_url: https://gitlab.example.com/
    api_token: "somegitlabapitoken"
    project: "my_group/my_project"
    name: "project_token"
    expires_at: "2024-12-31"
    access_level: developer
    scopes:
      - api
      - read_api
      - read_repository
      - write_repository
    state: present

- name: "Revoking a project access token"
  community.general.gitlab_project_access_token:
    api_url: https://gitlab.example.com/
    api_token: "somegitlabapitoken"
    project: "my_group/my_project"
    name: "project_token"
    expires_at: "2024-12-31"
    scopes:
      - api
      - read_api
      - read_repository
      - write_repository
    state: absent

- name: "Change (recreate) existing token if its actual state is different than desired state"
  community.general.gitlab_project_access_token:
    api_url: https://gitlab.example.com/
    api_token: "somegitlabapitoken"
    project: "my_group/my_project"
    name: "project_token"
    expires_at: "2024-12-31"
    scopes:
      - api
      - read_api
      - read_repository
      - write_repository
    recreate: state_change
    state: present

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ	Описание
access_token dictionary	Объект API. Содержит значение токена только в том случае, если токен был создан или пересоздан. Возвращается: при успешном выполнении и `state=present`

Авторы

Zoran Krleza (@pixslx)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/general/gitlab_project_access_token_module.html