community.general.gitlab_protected_branch 模块 – 管理现有分支的保护

注意

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

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

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

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

community.general 3.4.0 中的新增功能

概要 

(取消)标记现有分支以进行保护。

要求 

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

python-gitlab >= 2.3.0
requests (Python 库 https://pypi.ac.cn/project/requests/)

参数 

参数	注释
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 证书包。
merge_access_levels 字符串	允许合并的访问级别。选项 `"maintainer"` ← (默认) `"developer"` `"nobody"`
name 字符串 / 必填	需要保护的分支的名称。可以使用通配符，例如 `production/*`，或者只使用 `main` 或 `develop` 作为值。
project 字符串 / 必填	项目的路径和名称。
push_access_level 字符串	允许推送的访问级别。选项 `"maintainer"` ← (默认) `"developer"` `"nobody"`
state 字符串	创建或删除受保护的分支。选项 `"present"` ← (默认) `"absent"`
validate_certs 布尔值	是否在提供 HTTPS 端点时验证 SSL 证书。选项 `false` `true` ← (默认)

属性 

属性	支持	描述
check_mode	支持：完全支持	可以在 `check_mode` 中运行，并在不修改目标的情况下返回更改状态预测。
diff_mode	支持：不支持	在差异模式下，将返回有关已更改内容（或可能需要在 `check_mode` 中更改）的详细信息。

示例 

- name: Create protected branch on main
  community.general.gitlab_protected_branch:
    api_url: https://gitlab.com
    api_token: secret_access_token
    project: "dj-wasabi/collection.general"
    name: main
    merge_access_levels: maintainer
    push_access_level: nobody

作者

Werner Dijkerman (@dj-wasabi)