l3d.gitea

ansible 角色 gitea/forgejo

这个角色用于安装和管理 gitea 或者 forgejo。这是一个轻松使用的自托管 Git 服务。Gitea 是一个社区管理的轻量代码托管解决方案，使用 Go 语言编写。Forgejo 是它的一个分支。源代码和截图 gitea。源代码 forgejo。这个角色也是 Ansible 集合 l3d.git 的一部分。。

镜像

该角色在以下位置有镜像：

Github: github.com/roles-ansible/ansible_role_gitea
Gitea: git.l3d.ch/ansible/ansible_role_gitea 更多信息请查看 ansible.l3d.space

在剧本中的示例用法

以下代码已在最新的 Debian Stable 上经过测试，也应该可以在 Ubuntu 和 RedHat 上运行。

# ansible-galaxy 角色安装 l3d.gitea

- name: "安装 gitea"
  hosts: git.example.com
  roles:
    - {role: l3d.gitea, tags: gitea}
  vars:
    # 这里假设我们在反向代理后面，该代理将为我们处理 https，因此我们使用 HTTP 绑定到 localhost:3000
    # 详见 https://docs.gitea.io/en-us/reverse-proxies/#nginx
    gitea_fqdn: 'git.example.com'
    gitea_root_url: 'https://git.example.com'
    gitea_protocol: http
    gitea_start_ssh: true

在 Gitea 内置 SSH 和主机 SSH 服务器之间的选择

Gitea 有一个内置的 SSH 服务器，运行在 2222 端口（以避免与通常运行在 22 端口的主机 SSH 服务器冲突）。在这个角色中，默认使用这个 SSH 服务器，生成的 SSH 克隆 URL 为 gitea@<fqdn>:2222:<user>/<repo>.git，因为 gitea 是默认的 RUN_AS 用户。

通常情况下，人们想要一个“干净”的 SSH URL，例如 git@<fqdn>:<user>/<repo>.git。要实现这一点，可以使用主机的 SSH 服务器，配置如下变量：

gitea_ssh_port: 22 # 假设主机 SSH 服务器在 22 端口运行
gitea_user: git # 否则将出现权限问题
gitea_start_ssh: false # 不启动内置 SSH 服务器

上述配置对于新安装的系统可以开箱即用。在现有 SSH 密钥从内置 SSH 服务器迁移到主机 SSH 服务器时，需确保主机 SSH 服务器正在运行，并且 gitea_user 有必要的权限以访问仓库数据和密钥（存储在 <gitea_home>/.ssh/ 中）。

注意：要使用 git@，如上所述，gitea_user 必须是 git，仅设置 gitea_ssh_user: git 是不够的。有关更多信息，请参见此问题。

变量

以下是此 gitea 角色的变量的更深入的见解。有关某些变量的确切功能和添加更多选项的可能性，建议查看此配置备忘单。

在 gitea 和 forgejo 之间的选择

有一个名为 forgejo 的 gitea 分支。为什么？阅读 forgejo FAQ。您可以通过修改 gitea_fork 变量选择 gitea 或 forgejo。

变量名	默认值	描述
`gitea_fork`	`gitea`	可选，设置此值为 `forgejo` 以安装 forgejo。

gitea 更新机制

要确定要安装的 gitea 版本，您可以选择两种变体。您可以精确指定要安装的版本，或者使用选项 latest 始终安装 gitea releases 上的最新版本。

Forgejo 更新机制

建议明确指定要安装的 Forgejo 版本。有关在 gitea_version 中使用的正确值，请参见 Forgejo releases，例如 v1.21.5。

这是因为 Forgejo 项目同时维护 stable 和 old stable 版本，而 latest 标签将引用 最新版本，无论其是 stable 还是 old stable。这可能会导致 latest 指向您已安装的版本 较旧的版本。

gitea 更新

变量名	默认值	描述
`gitea_version`	`latest`	定义要安装的确切版本 (例如 `1.16.0`) 或使用 `latest` (默认) 安装最新版本。
`gitea_version_check`	`true`	在下载二进制文件之前检查安装的版本是否不等于 `gitea_version`
`gitea_gpg_key`	`7C9E68152594688862D62AF62D9AE806EC1592E2`	gitea 二进制文件的 gpg 密钥
`gitea_forgejo_gpg_key`	`EB114F5E6C0DC2BCDD183550A4B61A2DC5923710`	forgejo 二进制文件的 gpg 密钥
`gitea_gpg_server`	`hkps://keys.openpgp.org`	gpg 密钥服务器，角色可以从中下载 gpg 密钥
`gitea_backup_on_upgrade`	`false`	在每次更新 gitea 时可选创建备份。
`gitea_backup_location`	`{{ gitea_home }}/backups/`	如果使用此角色创建备份，应存储的 gitea 备份位置。
`submodules_versioncheck`	`false`	可防止您不小心运行此角色的较旧版本的简单版本检查。 (推荐)

gitea 在 Linux 世界中的表现

变量名	默认值	描述
`gitea_group`	`gitea`	Gitea 使用的主要 UNIX 组
`gitea_groups`	null	可选，Gitea 使用的次要 UNIX 组列表
`gitea_home`	`/var/lib/gitea`	工作的基本目录
`gitea_user_home`	`{{ gitea_home }}`	gitea 用户的主目录
`gitea_executable_path`	`/usr/local/bin/gitea`	gitea 可执行文件的路径
`gitea_forgejo_executable_path`	`/usr/local/bin/forgejo`	forgejo 可执行文件的路径
`gitea_configuration_path`	`/etc/gitea`	gitea.ini 配置文件的位置
`gitea_shell`	`/bin/false`	gitea 使用的 UNIX shell。如果不使用 gitea 内置 SSH 服务器，请将其设置为 `/bin/bash`。
`gitea_systemd_cap_net_bind_service`	`false`	向 systemd 服务文件添加 `AmbientCapabilities=CAP_NET_BIND_SERVICE`

总体 (DEFAULT)

变量名	默认值	描述
`gitea_app_name`	`Gitea`	显示的应用程序名称
`gitea_user`	`gitea`	Gitea 使用的 UNIX 用户
`gitea_run_mode`	`prod`	应用程序运行模式，影响性能和调试。可以是“dev”、“prod”或“test”。
`gitea_fqdn`	`localhost`	安装的基本 FQDN，用作其他变量的默认值。将其设置为可以访问您的 gitea 服务器的 FQDN

仓库 (repository)

变量名	默认值	描述
`gitea_default_branch`	`main`	所有仓库的默认分支名称
`gitea_default_private`	`last`	创建新仓库时的默认私有状态。[`last`、`private`、`public`]
`gitea_default_repo_units`	(见默认设置)	默认仓库单元的以逗号分隔的列表。有关更多信息，请查看官方文档
`gitea_disabled_repo_units`		全局禁用的仓库单元的以逗号分隔的列表。
`gitea_disable_http_git`	`false`	禁用通过 HTTP 协议与仓库交互的能力。 (true/false)
`gitea_disable_stars`	`false`	禁用 stars 功能。
`gitea_enable_push_create_org`	`false`	允许用户将本地仓库推送到 Gitea，并自动为组织创建它们。
`gitea_enable_push_create_user`	`false`	允许用户将本地仓库推送到 Gitea，并自动为用户创建它们。
`gitea_force_private`	`false`	强制所有新仓库为私有。
`gitea_user_repo_limit`	`-1`	限制用户可以拥有的仓库数量 (`-1`表示无限制)
`gitea_repository_root`	`{{ gitea_home }}/repos`	存储所有仓库数据的根路径。必须是绝对路径。
`gitea_repository_extra_config`		您可以使用此变量在配置的 `[repository]` 部分传递额外的配置参数。

仓库 - 上传 (repository.upload)

变量名	默认值	描述
`gitea_repository_upload_enabled`	`true`	是否启用仓库文件上传
`gitea_repository_upload_max_size`	`4`	每个文件的最大大小（以 MB 为单位）。
`gitea_repository_upload_extra_config`		您可以使用此变量在配置的 `[repository.upload]` 部分传递额外的配置参数。

仓库 - 签名 (repository.signing)

变量名	默认值	描述
`gitea_enable_repo_signing_options`	`false`	允许配置仓库签名选项
`gitea_repo_signing_key`	`default`	用于签名的密钥。
`gitea_repo_signing_name`		如果提供了 KEYID 作为 `gitea_repo_signing_key`，则将其用作签名者的名称和电子邮件地址。
`gitea_repo_signing_email`		如果提供了 KEYID 作为 `gitea_repo_signing_key`，则将其用作签名者的名称和电子邮件地址。
`gitea_repo_initial_commit`	`always`	签名初始提交。
`gitea_repo_default_trust_model`	`collaborator`	用于验证提交的默认信任模型。
`gitea_repo_wiki`	`never`	签名维基的提交。
`gitea_repo_crud_actions`	(见默认设置)	签名 CRUD 操作。
`gitea_repo_merges`	(见默认设置)	签名合并。
`gitea_enable_repo_signing_extra`		您可以使用此变量在配置的 `[repository.signing]` 部分传递额外的配置参数。

CORS (cors)

变量名	默认值	描述
`gitea_enable_cors`	`false`	启用 CORS 头（默认禁用）
`gitea_cors_scheme`	`http`	允许请求的协议
`gitea_cors_allow_domain`	`*`	列出允许的请求域名
`gitea_cors_allow_subdomain`	`false`	允许列出的头的子域进行请求
`gitea_cors_methods`	(见默认设置)	允许请求的方法列表
`gitea_cors_max_age`	`10m`	响应的最大缓存时间
`gitea_cors_allow_credentials`	`false`	允许携带凭证的请求
`gitea_cors_headers`	`Content-Type,User-Agent`	允许请求的附加头
`gitea_cors_x_frame_options`	`SAMEORIGIN`	设置 `X-Frame-Options` 头值
`gitea_cors_extra`		您可以使用此变量在配置的 `[cors]` 部分传递额外的配置参数。

UI (ui)

变量名	默认值	描述
`gitea_show_user_email`	`false`	是否希望显示电子邮件地址？ (true/false)
`gitea_theme_default`	`gitea-auto` 或 `forgejo-auto`	默认主题
`gitea_themes`	(见 `defaults/gitea.yml` 或 `defaults/forgejo.yml`)	启用主题列表
`gitea_ui_extra_config`		您可以使用此变量在配置的 `[ui]` 部分传递额外的配置参数。

UI - 元数据 (ui.meta)

变量名	默认值	描述
`gitea_ui_author`	(见默认设置)	首页的作者 meta 标签
`gitea_ui_description`	(见默认设置)	首页的描述 meta 标签
`gitea_ui_keywords`	(见默认设置)	首页的关键词 meta 标签
`gitea_ui_meta_extra_config`		您可以使用此变量在配置的 `[ui.meta]` 部分传递额外的配置参数。

服务器 (server)

变量名	默认值	描述
`gitea_protocol`	`http`	监听协议 [http、https、fcgi、unix、fcgi+unix]
`gitea_http_domain`	`{{ gitea_fqdn }}` （即 `localhost`）	本服务器的域名。
`gitea_root_url`	`http://{{ gitea_fqdn }}:3000`	访问您的 web 应用程序的根 URL（完整 URL）
`gitea_http_listen`	`127.0.0.1`	HTTP 监听地址
`gitea_http_port`	`3000`	绑定端口 (如果值为 `443`，将激活从 `80` 的重定向)
`gitea_start_ssh`	`true`	启用后，使用内置 SSH 服务器。
`gitea_ssh_domain`	`{{ gitea_fqdn }}`	本服务器的域名，用于显示克隆 URL
`gitea_ssh_port`	`2222`	显示在克隆 URL 中的 SSH 端口。
`gitea_ssh_listen`	`0.0.0.0`	内置 SSH 服务器的监听地址
`gitea_offline_mode`	`true`	禁用 CDN 用于静态文件和 Gravatar 用于个人资料图片。(true/false)
`gitea_landing_page`	`home`	未验证用户的着陆页
`gitea_lfs_server_enabled`	`false`	启用 GIT-LFS 支持 *(大文件存储：git-lfs)。
`gitea_lfs_jwt_secret`		LFS 认证密钥。可以通过 `gitea generate secret JWT_SECRET` 生成。未定义时将自动生成
`gitea_redirect_other_port`	`false`	如果为 true 且 `gitea_protocol` 为 https，则允许将 http 请求重定向到 Gitea 监听的 https 端口。
`gitea_port_to_redirect`	`80`	如果启用，重定向服务监听的 http 端口
`gitea_enable_tls_certs`	`false`	将 TLS 证书和密钥路径写入配置文件
`gitea_tls_cert_file`	`https/cert.pem`	用于 HTTPS 的证书文件路径
`gitea_tls_key_file`	`https/key.pem`	用于 HTTPS 的密钥文件路径
`gitea_enable_acme`	`false`	通过支持 ACME 的 CA 服务器启用自动证书管理的标志。 (默认是 letsencrypt)
`gitea_acme_url`		CA 的 ACME 目录 URL
`gitea_acme_accepttos`	`false`	明确检查您接受 ACME 提供商的服务条款。
`gitea_acme_directory`	`https`	证书管理器使用的目录，用于缓存证书和私钥等信息。
`gitea_acme_email`		用于 ACME 注册的电子邮件
`gitea_acme_ca_root`		CA 的根证书。如果留空，则默认使用系统的信任链。
`gitea_server_extra_config`		您可以使用此变量在配置的 `[server]` 部分传递额外的配置参数。

数据库 (database)

变量名	默认值	描述
`gitea_db_type`	`sqlite3`	使用的数据库类型 `[mysql、postgres、mssql、sqlite3]`
`gitea_db_host`	`127.0.0.0:3306`	数据库主机地址和端口或 unix socket 的绝对路径 [mysql、postgres]（例如：`/var/run/mysqld/mysqld.sock`）。
`gitea_db_name`	`root`	数据库名称
`gitea_db_user`	`gitea`	数据库用户名
`gitea_db_password`	`lel`	数据库密码。请更改
`gitea_db_ssl`	`disable`	仅在您的数据库类型支持时配置 SSL。在 config-cheat-sheet 中检查更多详细信息
`gitea_db_path`	`{{ gitea_home }}/data/gitea.db`	数据库路径，如果您使用 `sqlite3`。
`gitea_db_log_sql`	`false`	记录执行的 SQL。
`gitea_database_extra_config`		您可以使用此变量在配置的 `[database]` 部分传递额外的配置参数。

索引器 (indexer)

变量名	默认值	描述
`gitea_repo_indexer_enabled`	`false`	启用代码搜索 (使用大量磁盘空间，大约是仓库大小的 6 倍)。
`gitea_repo_indexer_include`		要包含在索引中的全局模式 (以逗号分隔的列表)。空列表意味着包括所有文件。
`gitea_repo_indexer_exclude`		要排除在索引中的全局模式 (以逗号分隔的列表)。
`gitea_repo_exclude_vendored`	`true`	从索引中排除供应文件。
`gitea_repo_indexer_max_file_size`	`1048576`	要索引的文件的最大大小（以字节为单位）。
`gitea_indexer_extra_config`		您可以使用此变量在配置的 `[indexer]` 部分传递额外的配置参数。
`gitea_queue_issue_indexer_extra_config`		您可以使用此变量在配置的 `[queue.issue_indexer]` 部分传递额外的配置参数。

安全 (security)

变量名	默认值	描述
`gitea_secret_key`		全局秘密密钥。未定义时将自动生成。应该是唯一的。
`gitea_disable_git_hooks`	`true`	设置为 false 以允许具有 git hook 权限的用户创建自定义 git hook。可能会很危险。
`gitea_disable_webhooks`	`false`	设置为 true 以禁用 webhooks 功能。
`gitea_internal_token`		内部 API 令牌。未定义时将自动生成。应该是唯一的。
`gitea_password_check_pwn`	`false`	检查 HaveIBeenPwned 以查看密码是否被泄露。
`gitea_security_extra_config`		您可以使用此变量在配置的 `[security]` 部分传递额外的配置参数。

服务 (service)

变量名	默认值	描述
`gitea_disable_registration`	`false`	是否要禁用用户注册？ (true/false)
`gitea_register_email_confirm`	`false`	启用此功能以要求注册时电子邮件确认。需要启用 `gitea_mailer_enabled`。
`gitea_require_signin`	`true`	是否要求登录才能查看仓库（即使是公开的）？ (true/false)
`gitea_default_keep_mail_private`	`true`	默认情况下，设置用户保留其电子邮件地址为私有
`gitea_enable_captcha`	`true`	是否要启用验证码？ (true/false)
`gitea_show_registration_button`	`true`	在此处可以隐藏注册按钮。这不会禁用注册！ (true/false)
`gitea_only_allow_external_registration`	`false`	设置为 true 以强制仅使用第三方服务进行注册 (true/false)
`gitea_enable_notify_mail`	`false`	启用此功能以在发生某些事件时向仓库的观察者发送电子邮件，例如创建问题 (true/false)
`gitea_auto_watch_new_repos`	`true`	启用此功能以让所有组织用户在创建时自动观察新仓库 (true/false)
`gitea_autowatch_on_change`	`true`	启用此功能以在用户首次提交到仓库后使其观察该仓库 (true/false)
`gitea_register_manual_confirm`	`false`	启用此功能以手动确认新注册。需要禁用 REGISTER_EMAIL_CONFIRM。
`gitea_default_allow_create_organization`	`false`	默认允许新用户创建组织 (true/false)
`gitea_email_domain_allowlist`		如果非空，逗号分隔的域名列表，仅允许在此实例上注册。支持通配符。
`gitea_default_user_visibility`	`public`	设置用户的默认可见模式，可以是 "public"、"limited" 或 "private"。
`gitea_default_org_visibility`	`public`	设置组织的默认可见模式，可以是 "public"、"limited" 或 "private"。
`gitea_allow_only_internal_registration`	`false`	设置为 true 以强制仅通过 Gitea 注册。
`gitea_allow_only_external_registration`	`false`	设置为 true 以强制仅使用第三方服务进行注册。
`gitea_show_milestones_dashboard_page`	`true`	启用此功能以显示里程碑仪表板页面 - 显示所有用户的里程碑视图
`gitea_default_user_is_restricted`	`false`	默认为新用户分配限制权限 (true/false)
`gitea_service_extra_config`		您可以使用此变量在配置的 `[service]` 部分传递额外的配置参数。

邮件管理 (mailer)

变量名	默认值	描述
`gitea_mailer_enabled`	`false`	是否启用邮件功能。
`gitea_mailer_protocol`	`dummy`	邮件服务器协议。可以是“smtp”、“smtps”、“smtp+starttls”、“smtp+unix”、“sendmail”、“dummy”。
`gitea_mailer_smtp_addr`		邮件服务器地址。例如 smtp.gmail.com。对于 smtp+unix，这应该是一个 unix 套接字的路径。
`gitea_mailer_smtp_port`		邮件服务器端口
`gitea_mailer_use_client_cert`	`false`	是否对 TLS/SSL 使用客户端证书。
`gitea_mailer_client_cert_file`		客户端证书文件。
`gitea_mailer_client_key_file`		客户端密钥文件。
`gitea_mailer_force_trust_server_cert`	`false`	完全忽略服务器证书验证错误。此选项不安全。考虑将证书添加到系统信任存储中。
`gitea_mailer_user`		邮件发送用户的用户名（通常是发件人的电子邮件地址）。
`gitea_mailer_password`		邮件发送用户的密码。如果您的密码中有特殊字符，请使用 `your password` 进行引号引住。
`gitea_mailer_enable_helo`	`true`	启用 HELO 操作。
`gitea_mailer_from`	`noreply@{{ gitea_http_domain }}`	邮件发送地址，RFC 5322。
`gitea_subject_prefix`		放置在邮件主题行前面的前缀。
`gitea_mailer_send_as_plaintext`	`false`	仅以纯文本形式发送邮件，不使用 HTML 替代。
`gitea_mailer_extra_config`		您可以使用此变量在配置的 `[mailer]` 部分传递额外的配置参数。

会话 (session)

变量名	默认值	描述
`gitea_session_provider`	`file`	会话引擎提供程序
`gitea_session_extra_config`		您可以使用此变量在配置的 `[session]` 部分传递额外的配置参数。

图片 (picture)

变量名	默认值	描述
`gitea_picture_extra_config`		您可以使用此变量在配置的 `[picture]` 部分传递额外的配置参数。

问题和拉取请求附件 (attachment)

变量名	默认值	描述
`attachment_enabled`	`true`	是否启用问题和拉取请求附件。
`gitea_attachment_types`	见文档	允许的文件扩展名（`.zip,.txt`）、mime 类型（`text/plain`）或通配符类型（`image/`、`audio/`、`video/`）。空值或 `/*` 允许所有类型。
`gitea_attachment_max_size`	`4`	最大大小（MB）。
`gitea_attachment_extra_config`		您可以使用此变量在配置的 `[attachment]` 部分传递额外的配置参数。

日志 (log)

变量名	默认值	描述
`gitea_log_systemd`	`false`	禁用记录到 `file`，使用 systemd-journald
`gitea_log_level`	`Warn`	一般日志级别。`[Trace, Debug, Info, Warn, Error, Critical, Fatal, None]`
`gitea_log_extra_config`		您可以使用此变量在配置的 `[log]` 部分传递额外的配置参数。

指标 (metrics)

变量名	默认值	描述
`gitea_metrics_enabled`	`false`	启用指标端点
`gitea_metrics_token`		Prometheus 抓取作业的 Bearer 令牌
`gitea_metrics_extra`		您可以使用此变量在配置的 `[metrics]` 部分传递额外的配置参数。

OAuth2 (oauth2)

变量名	默认值	描述
`gitea_oauth2_enabled`	`true`	启用 Oauth2 提供程序 (true/false)
`gitea_oauth2_jwt_secret`		Oauth2 JWT 密钥。可以通过 `gitea generate secret JWT_SECRET` 生成。未定义时将自动生成
`gitea_oauth2_extra_config`		您可以使用此变量在配置的 `[oauth2]` 部分传递额外的配置参数。

联邦 (federation)

变量名	默认值	描述
`gitea_federation_enabled`	`false`	启用/禁用联邦功能
`gitea_federation_share_user_stats`	`false`	启用/禁用节点信息的用户统计（如果启用联邦）
`gitea_federation_extra`		您可以使用此变量在配置的 `[federation]` 部分传递额外的配置参数。

软件包 (packages)

变量名	默认值	描述
`gitea_packages_enabled`	`true`	启用/禁用包注册功能
`gitea_packages_extra`		您可以使用此变量在配置的 `[packages]` 部分传递额外的配置参数。

LFS (lfs)

变量名	默认值	描述
`gitea_lfs_storage_type`	`local`	lfs 的存储类型
`gitea_lfs_serve_direct`	`false`	允许存储驱动程序重定向到经过身份验证的 URL 以直接提供文件。 (仅限 Minio/S3)
`gitea_lfs_content_path`	`{{ gitea_home }}/data/lfs`	存储 LFS 文件的位置
`gitea_lfs_extra`		您可以使用此变量在配置的 `[lfs]` 部分传递额外的配置参数。

操作 (actions)

变量名	默认值	描述
`gitea_actions_enabled`	`false`	全局启用/禁用操作功能。可能需要将 `repo.actions` 添加到 `gitea_default_repo_units` 以在所有新仓库上启用操作。
`gitea_actions_default_actions_url`	`github`	默认地址以获取操作插件，例如，默认值意味着从 `https://github.com/actions/checkout` 下载 `uses: actions/checkout@v3`。
`gitea_actions_extra`		您可以使用此变量在配置的 `[actions]` 部分传递额外的配置参数。

其他 (other)

变量名	默认值	描述
`gitea_other_show_footer_version`	`true`	在页脚中显示 Gitea 和 Go 版本信息。
`gitea_other_show_footer_template_load_time`	`true`	在页脚中显示模板执行时间。
`gitea_other_enable_sitemap`	`true`	生成网站地图。
`gitea_other_enable_feed`	`true`	启用/禁用 RSS/Atom 订阅。

其他 gitea 配置

变量名	默认值	描述
`gitea_extra_config`		额外的 gitea 配置。在使用之前，请查看 config-cheat-sheet。

Fail2Ban 配置

如果启用，这将为 Gitea 部署 fail2ban 过滤器和监狱配置，如 Gitea 文档中所述。

由于这仅部署配置文件，因此 fail2ban 必须已经安装，否则角色将失败。

变量名	默认值	描述
`gitea_fail2ban_enabled`	`false`	是否部署 fail2ban 配置
`gitea_fail2ban_jail_maxretry`	`10`	fail2ban 监狱 `maxretry` 设置。
`gitea_fail2ban_jail_findtime`	`3600`	fail2ban 监狱 `findtime` 设置。
`gitea_fail2ban_jail_bantime`	`900`	fail2ban 监狱 `bantime` 设置。
`gitea_fail2ban_jail_action`	`iptables-allports`	fail2ban 监狱 `action` 设置。

本地 gitea 用户

变量	选项	描述
`gitea_users`		字典以创建本地 gitea 或 forgejo 用户
	`name`	本地 gitea/forgejo 用户的名称
	`password`	本地 git 用户的密码
	`email`	本地 git 用户的电子邮件
	`admin`	给予用户管理员权限
	`must_change_password`	用户在第一次登录后应更改密码
	`state`	设置为 `absent` 以删除用户

可选自定义

您可以使用此 ansible 角色可选地自定义您的 gitea。有关自定义的信息，我们来自 docs.gitea.io/en-us/customizing-gitea。为了部署多个文件，我们创建了 gitea_custom_search 变量，指向您存放自定义 gitea 文件的路径 *(默认 "files/host_files/{{ inventory_hostname }}/gitea")*。

LOGO:
- 设置 gitea_customize_logo 为 true
- 我们搜索：
  - logo.svg - 用于网站图标，应用图标
  - logo.png - 用于 Open Graph
  - favicon.png - 作为不支持 SVG favicon 的浏览器的后备
  - apple-touch-icon.png - 在 iOS 设备上用于书签
- 我们在以下位置搜索 (使用 first_found):
  - {{ gitea_custom_search }}/gitea_logo/
  - files/{{ inventory_hostname }}/gitea_logo/
  - files/{{ gitea_http_domain }}/gitea_logo/
  - files/gitea_logo/
FOOTER:
- 设置 gitea_customize_footer 为 true
- 使用 first_found 搜索以下路径：
  - "{{ gitea_custom_search }}/gitea_footer/extra_links_footer.tmpl"
  - "files/{{ inventory_hostname }}/gitea_footer/extra_links_footer.tmpl"
  - "files/{{ gitea_http_domain }}/gitea_footer/extra_links_footer.tmpl"
  - 'files/gitea_footer/extra_links_footer.tmpl'
  - 'files/extra_links_footer.tmpl'
CUSTOM FILES:
- 设置 gitea_customize_files 为 true
- 创建您想要部署的文件目录。
- 将 gitea_customize_files_path 指向此目录。 *(默认 {{ gitea_custom_search }}/gitea_files/)*。
CUSTOM THEMES:
- 将 gitea_custom_themes 设置为包含自定义主题 CSS 文件的 URL 的列表。您通常希望每个主题有三个单独的文件。例如：
```
gitea_custom_themes:
  - https://example.com/theme-custom-auto.css
  - https://example.com/theme-custom-dark.css
  - https://example.com/theme-custom-light.css
```
- 设置变量 gitea_themes 并包含新主题的名称。要保留现有主题，您需要传递所有主题名称，例如 auto,gitea,arc-green,<custom-auto>,<custom-light>,<custom-dark>。

需求

此角色使用 ansible.builtin 和 community.general ansible 集合。要下载最新的 forgejo/gitea 版本，我们使用 json_query。这需要 jmespath 可用。

Python 包

jmespath

Galaxy 集合

community.general

示例需求安装

ansible-galaxy collection install --update --role-file requirements.yml
pip3 install --update jmespath

贡献

欢迎创建 pull 请求，如果有疑问可以通过 Mastodon 联系我 @[email protected]。

我会乐意修复您提出的任何问题，或者更好的是，审查您的 pull 请求 :)

此角色的历史

这个 ansible 角色最初开发在 github.com/thomas-maurice/ansible-role-gitea。由于那里的角色存在一些问题，比如 gitea 仓库位置的默认值和合并 pull 请求通常需要几个月的问题，因此创建了一个角色的分支，提供同样的功能。只是更加整洁并有意迅速响应问题和 pull 请求。现在它也是 l3d.git 集合的一部分。

关于项目

Ansible role to configure and deploy gitea and forgejo, a painless self-hosted Git service.

role gitea forgejo git system development sourcecontrol selfhosted gitserver gogs linux

安装

ansible-galaxy install l3d.gitea

GitHub 仓库

68 星标

36 分叉

9 未解决问题

许可证

bsd-3-clause

下载

151k

拥有者

Ansible Roles

Ansible roles provide a framework for fully independent, or interdependent collections of variables,tasks,files,templates &modules. Here we maintain some. enjoy