Gitea Docker镜像文档

1. 镜像概述和主要用途

Gitea是一款轻量级代码托管解决方案，采用Go语言开发，具有资源消耗低、易于升级和支持多种数据库等特点。Bitnami Gitea镜像提供了一种简单、可靠的方式来部署和运行Gitea服务，适用于个人开发者、小型团队和企业内部使用。

Gitea官方网站

商标说明：本软件列表由Bitnami打包。所提及的各个商标分别归各自公司所有，使用这些商标并不意味着任何关联或认可。

2. 核心功能和特性

• 轻量级设计：资源消耗低，适合在各种环境中部署
• 完整功能集：提供Git代码仓库管理、用户管理、权限控制等功能
• 多数据库支持：可与PostgreSQL、MySQL等主流数据库集成
• 易于升级：简化的版本升级流程
• 安全可靠：遵循最佳安全实践，定期更新以修复漏洞
• 可扩展性：支持多种插件和扩展，满足不同需求
• Web界面：直观的Web管理界面，便于操作

3. 使用场景和适用范围

• 个人代码托管：为个人开发者提供私有的Git仓库服务
• 小型团队协作：支持团队成员间的代码共享和协作开发
• 企业内部代码管理：在企业内部部署私有的代码托管平台
• 开发测试环境：快速搭建用于开发和测试的代码仓库
• 教育和培训：用于教学环境中的版本控制演示和实践

4. 快速开始

使用Helm快速部署（Kubernetes环境）

helm install my-release oci://registry-1.docker.io/bitnamicharts/gitea

注意：如需在生产环境使用Gitea，建议尝试VMware Tanzu Application Catalog，即Bitnami目录的商业版本。

5. 详细使用方法

5.1 前提条件

• Kubernetes 1.23+
• Helm 3.8.0+
• 底层基础设施支持PV供应

5.2 使用Helm安装Chart

使用发布名称my-release安装Chart：

helm install my-release oci://REGISTRY_NAME/REPOSITORY_NAME/gitea

注意：需要将占位符REGISTRY_NAME和REPOSITORY_NAME替换为Helm Chart仓库和存储库的引用。例如，对于Bitnami，需使用REGISTRY_NAME=registry-1.docker.io和REPOSITORY_NAME=bitnamicharts。

此命令使用默认配置在Kubernetes集群上部署Gitea。可在安装过程中配置的参数详见参数部分。

提示：使用helm list命令列出所有发布

5.3 Docker Compose配置示例

以下是一个基本的Docker Compose配置示例：

version: '3'

services:
  gitea:
    image: docker.io/bitnami/gitea:latest
    ports:
      - "3000:3000"
      - "22:22"
    environment:
      - GITEA_ADMIN_USERNAME=admin
      - GITEA_ADMIN_PASSWORD=your_password
      - GITEA_ADMIN_EMAIL=***
      - GITEA_DATABASE_TYPE=postgres
      - GITEA_DATABASE_HOST=postgresql
      - GITEA_DATABASE_NAME=gitea
      - GITEA_DATABASE_USER=gitea
      - GITEA_DATABASE_PASSWORD=gitea_password
    volumes:
      - gitea_data:/bitnami/gitea
    depends_on:
      - postgresql

  postgresql:
    image: docker.io/bitnami/postgresql:14
    environment:
      - POSTGRESQL_USERNAME=gitea
      - POSTGRESQL_PASSWORD=gitea_password
      - POSTGRESQL_DATABASE=gitea
    volumes:
      - postgresql_data:/bitnami/postgresql

volumes:
  gitea_data:
  postgresql_data:

5.4 Docker Run命令示例

使用PostgreSQL数据库运行Gitea：

# 首先启动PostgreSQL
docker run -d \
  --name postgresql \
  -e POSTGRESQL_USERNAME=gitea \
  -e POSTGRESQL_PASSWORD=gitea_password \
  -e POSTGRESQL_DATABASE=gitea \
  -v postgresql_data:/bitnami/postgresql \
  docker.io/bitnami/postgresql:14

# 然后启动Gitea
docker run -d \
  --name gitea \
  -p 3000:3000 \
  -p 22:22 \
  --link postgresql:postgresql \
  -e GITEA_ADMIN_USERNAME=admin \
  -e GITEA_ADMIN_PASSWORD=your_password \
  -e GITEA_ADMIN_EMAIL=*** \
  -e GITEA_DATABASE_TYPE=postgres \
  -e GITEA_DATABASE_HOST=postgresql \
  -e GITEA_DATABASE_NAME=gitea \
  -e GITEA_DATABASE_USER=gitea \
  -e GITEA_DATABASE_PASSWORD=gitea_password \
  -v gitea_data:/bitnami/gitea \
  docker.io/bitnami/gitea:latest

6. 配置参数

6.1 全局参数

6.2 通用参数

6.3 Gitea参数

7. 高级配置

7.1 资源请求和限制

Bitnami图表允许为图表部署内的所有容器设置资源请求和限制。这些设置位于resources值内（参见参数表）。设置请求对于生产工作负载至关重要，应根据具体用例进行调整。

为简化此过程，图表包含resourcesPreset值，可根据不同预设自动设置resources部分。但在生产工作负载中，不建议使用resourcesPreset，因为它可能无法完全适应您的特定需求。

7.2 持久化存储

Bitnami Gitea镜像将Gitea数据和配置存储在容器的/bitnami/gitea路径下。

持久卷声明用于跨部署保留数据。这在GCE、AWS和minikube上已测试可行。

使用现有PersistentVolumeClaim

1. 创建PersistentVolume
2. 创建PersistentVolumeClaim
3. 安装图表：

helm install my-release --set persistence.existingClaim=PVC_NAME oci://REGISTRY_NAME/REPOSITORY_NAME/gitea

使用主机路径

指定的hostPath目录必须已存在（如果不存在，请创建一个）。

安装图表：

helm install my-release --set persistence.hostPath=/PATH/TO/HOST/MOUNT oci://REGISTRY_NAME/REPOSITORY_NAME/gitea

由于容器无法控制主机的目录权限，您必须自己设置Gitea文件目录权限。

7.3 私有仓库配置

如果将image值配置为私有仓库中的镜像，您需要指定镜像拉取密钥：

1. 在命名空间中手动创建镜像拉取密钥
2. 使用values.yaml文件提供这些密钥：

imagePullSecrets:
  - name: SECRET_NAME

3. 安装图表

7.4 更新凭据

Bitnami图表在首次启动时配置凭据。后续对密钥或凭据的任何更改都需要手动干预：

• 按照上游文档更新用户密码
• 使用新值更新密码密钥：

kubectl create secret generic SECRET_NAME --from-literal=admin-password=PASSWORD --from-literal=smtp-password=SMTP_PASSWORD --dry-run -o yaml | kubectl apply -f -

7.5 设置Pod亲和性

此图表允许使用affinity参数设置自定义亲和性。作为替代方案，您可以使用bitnami/common图表中提供的预设配置。

7.6 备份和恢复

要在Kubernetes上备份和恢复Helm图表部署，您需要备份源部署的持久卷，并使用Velero（Kubernetes备份/恢复工具）将它们附加到新部署。

8. 重要注意事项：Bitnami目录即将发生的变化

自2025年8月28日起，Bitnami将改进其公共目录，在新的Bitnami Secure Images计划下提供精选的强化、安全聚焦的镜像。作为此过渡的一部分：

• 首次向社区用户提供流行容器镜像的安全优化版本
• Bitnami将开始在其免费层级中弃用对非强化、基于Debian的软件镜像的支持，并将逐步从公共目录中删除非最新标签
• 从8月28日开始，在两周内，所有现有容器镜像，包括旧版本或版本化标签（例如2.50.0、10.6），将从公共目录（docker.io/bitnami）迁移到"Bitnami Legacy"仓库（docker.io/bitnamilegacy），在那里它们将不再接收更新
• 对于生产工作负载和长期支持，建议用户采用Bitnami Secure Images，其中包括强化容器、更小的攻击面、CVE透明度等

完整README可在[***]