community.general.gitlab_group_access_token 模块 – 管理 GitLab 组访问令牌

注意

此模块是 community.general 集合 (版本 10.1.0) 的一部分。

如果您使用的是 ansible 包，则可能已安装此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install community.general。您需要满足其他要求才能使用此模块，有关详细信息，请参阅 要求。

要在 playbook 中使用它，请指定：community.general.gitlab_group_access_token。

community.general 8.4.0 中的新增功能

概要

  • 创建和撤销组访问令牌。

要求

在执行此模块的主机上需要以下要求。

参数

参数

注释

access_level

字符串

访问令牌的访问级别。

选项

  • "访客"

  • "报告者"

  • "开发者"

  • "维护者" ← (默认)

  • "所有者"

api_job_token

字符串

在 community.general 4.2.0 中添加

用于登录的 GitLab CI 作业令牌。

api_oauth_token

字符串

在 community.general 4.2.0 中添加

用于登录的 GitLab OAuth 令牌。

api_password

字符串

用于对 API 进行身份验证的密码。

api_token

字符串

具有 API 权限的 GitLab 访问令牌。

api_url

字符串

API 的可解析端点。

api_username

字符串

用于对 API 进行身份验证的用户名。

ca_path

字符串

在 community.general 8.1.0 中添加

用于验证 GitLab 服务器证书的 CA 证书包。

expires_at

字符串 / 必需

访问令牌的过期日期，格式为 YYYY-MM-DD。

确保在 YAML 中用引号引起来此值，以确保将其保留为字符串，而不是解释为 YAML 日期。

group

字符串 / 必需

组的 ID 或完整路径，格式为 group/subgroup。

name

字符串 / 必需

访问令牌的名称。

recreate

字符串

如果访问令牌已存在，是否会重新创建它。

当 never 时，令牌将永远不会被重新创建。

当 always 时，令牌将始终被重新创建。

当 state_change 时，如果期望状态和实际状态之间存在差异，则会重新创建令牌。

选项

  • "never" ← (默认)

  • "always"

  • "state_change"

scopes

别名：scope

列表 / 元素=字符串 / 必需

访问令牌的范围。

选项

  • "api"

  • "read_api"

  • "read_registry"

  • "write_registry"

  • "read_repository"

  • "write_repository"

  • "create_runner"

  • "ai_features"

  • "k8s_proxy"

state

字符串

当 present 时，如果访问令牌不存在，则将其添加到组。

当 absent 时，如果它存在，则将其从组中删除。

选项

  • "present" ← (默认)

  • "absent"

validate_certs

布尔值

是否在提供 HTTPS 端点时验证 SSL 证书。

选项

  • false

  • true ← (默认)

属性

属性

支持

描述

check_mode

支持：完全支持

可以在 check_mode 下运行，并在不修改目标的情况下返回更改状态预测。

diff_mode

支持：不支持

在差异模式下，将返回关于已更改内容（或可能需要在check_mode中更改的内容）的详细信息。

备注

注意

  • 访问令牌无法更改。如果需要更改参数，则必须重新创建访问令牌。是否重新创建令牌由recreate选项控制，默认为never。

  • 只有在创建或重新创建访问令牌时，令牌字符串才会包含在结果中。之后无法获取。

  • 令牌匹配是通过比较name选项来完成的。

示例

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

- name: "Revoking a group access token"
  community.general.gitlab_group_access_token:
    api_url: https://gitlab.example.com/
    api_token: "somegitlabapitoken"
    group: "my_group/my_group"
    name: "group_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_group_access_token:
    api_url: https://gitlab.example.com/
    api_token: "somegitlabapitoken"
    group: "my_group/my_group"
    name: "group_token"
    expires_at: "2024-12-31"
    scopes:
      - api
      - read_api
      - read_repository
      - write_repository
    recreate: state_change
    state: present

返回值

常见的返回值已在此处记录，以下是此模块特有的字段

键

描述

access_token

字典

API 对象。

只有在创建或重新创建令牌时才包含令牌的值。

返回：成功且state=present

作者

  • Zoran Krleza (@pixslx)