在Docker上部署Gitea

# 1. 介绍Docker和Gitea

#### 1.1 什么是Docker？

Docker是一种开源的容器化平台，用于将应用程序和其相关依赖项打包成一个可移植的容器。每个容器都可以在不同的环境中运行，不受环境差异的影响。Docker的核心理念是“构建一次，到处运行”，使应用程序的部署和管理更加便捷和高效。

#### 1.2 什么是Gitea？

Gitea是一个轻量级的自助Git服务，类似于GitHub或GitLab，它提供了仓库管理、问题跟踪、代码审查、Wiki等功能。Gitea具有简单易用、易于扩展、高度可定制的特点，适合个人项目或小型团队的代码管理和协作。

#### 1.3 Docker和Gitea的应用场景

Docker和Gitea的结合可以为开发人员和团队提供便捷的代码管理和部署环境。使用Docker部署Gitea可以实现快速搭建、可重复部署和扩展的优势。一些常见的应用场景包括：

- 个人项目的代码管理：开发人员可以在自己的机器上利用Docker快速部署一个Gitea实例，方便管理自己的代码，并可随时迁移到其他环境中。
- 小型团队的协作开发：团队成员可以共享Gitea实例，共同管理仓库、实施版本控制、进行代码审查以及协同开发，提高工作效率。
- 自托管的代码仓库服务：Docker化的Gitea可以轻松部署在自己的服务器上，将代码仓库完全控制在自己手中，确保数据安全和源代码的保密性。

通过本文的指导，你将了解如何在Docker上部署Gitea，为你的项目提供便捷且可靠的代码管理和协作环境。下面，我们将开始准备所需的工作。

# 2. 准备工作

在部署Gitea之前，我们需要先进行一些准备工作，包括安装Docker、了解Docker基础知识，并下载Gitea镜像。

### 2.1 安装Docker

Docker是一种容器化平台，可以将应用程序及其依赖项打包成容器，并在任何环境中运行。安装Docker的步骤如下：

#### 2.1.1 在Ubuntu上安装Docker

在Ubuntu上安装Docker十分简单。打开终端，并执行以下命令：

$ sudo apt-get update
$ sudo apt-get install docker.io

安装完成后，可以通过以下命令验证Docker是否成功安装：

$ docker --version

#### 2.1.2 在Windows上安装Docker

在Windows上安装Docker需要下载Docker Desktop安装程序，并按照提示进行安装。安装完成后，可以在命令行中执行以下命令验证Docker是否成功安装：

$ docker --version

### 2.2 Docker基础知识

在使用Docker之前，我们需要了解一些基础知识：

- 镜像(Image): Docker镜像是一个只读的模板，用于创建Docker容器。可以将镜像看作是一个包含了应用程序及其依赖的文件系统。

- 容器(Container): Docker容器是从镜像创建的运行实例。容器之间是相互隔离的，每个容器都有自己的文件系统、进程和网络空间。

- 仓库(Repository): Docker仓库是用来存放Docker镜像的地方。

### 2.3 下载Gitea镜像

Docker Hub是一个存储和分享Docker镜像的公共平台。我们可以通过Docker Hub来下载Gitea镜像。

在命令行中执行以下命令来下载Gitea镜像：

$ docker pull gitea/gitea

下载完成后，我们可以使用以下命令来查看已下载的镜像：

$ docker images

至此，我们已经完成了Gitea部署前的准备工作。下一步将会在第三章中进行Gitea的配置。

注：以上为安装Docker和下载Gitea镜像的基本步骤，具体操作可能会因不同操作系统和网络环境而有所差异，请根据自己的实际情况进行操作。

# 3. 配置Gitea

在前面的章节中，我们已经介绍了Docker和Gitea的基本概念。接下来，我们将详细讲解如何配置Gitea。

#### 3.1 创建Gitea数据卷

在部署Gitea之前，我们首先需要创建一个数据卷来存储Gitea的数据。数据卷是一个持久化存储的目录，它可以在容器之间共享和重用。

使用下面的命令来创建Gitea数据卷：

$ docker volume create gitea-data

这将在Docker中创建一个名为"gitea-data"的数据卷，用于存储Gitea的数据。

#### 3.2 设置Gitea配置

接下来，我们需要设置Gitea的配置，包括数据库连接信息、仓库存储路径等。

创建一个名为"gitea.env"的配置文件，并填写以下内容：

# 数据库设置
DB_TYPE=sqlite3
DB_HOST=/data/gitea/gitea.db
DB_NAME=gitea
DB_USER=root
DB_PASSWD=

# 仓库存储路径
REPO_ROOT=/data/git

# 应用URL
RUN_MODE=prod
APP_URL=http://your-gitea-domain.com

请根据实际情况修改上述配置内容。

#### 3.3 初始化Gitea数据库

配置完成后，我们需要初始化Gitea的数据库。运行下面的命令来初始化：

$ docker run --rm -ti --name=gitea-db -v gitea-data:/data busybox:latest /bin/sh -c 'cd /data && touch gitea.db && chown 1000 gitea.db'

这个命令会在数据卷中创建一个空的数据库文件，并将文件的所有者设置为Gitea容器的用户。

至此，我们已经完成了Gitea的配置工作。在下一章中，我们将启动Gitea容器并访问Web界面。

# 4. 启动Gitea容器

在这一章中，我们将学习如何启动Gitea容器并进行相关的操作。

#### 4.1 使用Docker Compose启动

首先，我们需要创建一个名为`docker-compose.yml`的文件，该文件用于配置Gitea容器的启动参数。以下是一个示例的`docker-compose.yml`文件内容：

version: '3'
services:
  gitea:
    image: gitea/gitea:latest
    container_name: gitea
    environment:
      - USER_UID=1000
      - USER_GID=1000
    ports:
      - "3000:3000"
      - "22:22"
    volumes:
      - ./gitea:/data
    restart: always

然后，在终端中切换到包含`docker-compose.yml`文件的目录，并执行以下命令启动Gitea容器：

docker-compose up -d

#### 4.2 检查Gitea容器状态

启动后，可以使用以下命令来查看容器的运行状态：

docker ps

如果容器状态正常，说明Gitea容器已经成功启动。

#### 4.3 访问Gitea Web界面

在浏览器中输入`http://localhost:3000`即可访问Gitea的Web界面。在这里，您可以进行用户注册、创建代码仓库以及管理团队和权限等操作。

这就是如何使用Docker Compose启动Gitea容器，以及如何检查容器状态和访问Web界面的方式。

接下来，让我们深入了解如何在Gitea上进行一些常见操作。

# 5. 使用Gitea

Gitea是一个开源的自助Git服务，可以帮助团队轻松管理代码仓库、团队和权限。在本章中，我们将介绍如何使用Gitea进行用户注册、创建代码仓库以及管理团队和权限。

### 5.1 注册用户

使用Gitea前，我们首先需要注册一个用户账号。以下是在Gitea中注册用户的步骤：

1. 打开Gitea的Web界面，通常可以通过访问 http://localhost:3000 进入。
2. 点击界面右上角的"Register"按钮。
3. 填写需要的用户信息，包括用户名、邮箱和密码等。
4. 点击"Register"按钮完成注册。

### 5.2 创建代码仓库

注册完用户后，我们就可以创建自己的代码仓库了。以下是创建代码仓库的步骤：

1. 登录Gitea，使用注册时填写的用户名和密码登录。
2. 在界面左侧导航栏中点击"New Repository"按钮。
3. 填写仓库信息，包括仓库名称、仓库描述、仓库可见性等。
4. 点击"Create Repository"按钮完成创建。

### 5.3 管理团队和权限

在Gitea中，我们可以创建团队并设置不同的权限来管理代码仓库。以下是管理团队和权限的步骤：

1. 登录Gitea，进入所创建的代码仓库。
2. 在界面上方导航栏中点击"Settings"按钮。
3. 在左侧菜单栏中选择"Collaboration"选项。
4. 点击"New Team"按钮创建一个团队，并设置团队的名称和描述等信息。
5. 在"Teams"选项下，选择要设置权限的团队。
6. 在团队页面中，可以设置团队的成员、权限和代码仓库等。

以上是使用Gitea的基本操作，希望对你有帮助！在日常工作中，只要能熟练使用Gitea来管理代码仓库，团队的协作效率将会大大提升！

# 6. 常见问题解决

在使用Docker部署Gitea过程中，可能会遇到一些常见的问题。本章将会介绍如何解决这些问题，并提供一些建议和注意事项。

### 6.1 如何备份和恢复Gitea数据

在部署Gitea过程中，备份数据是非常重要的。下面介绍一种简单的方法来备份和恢复Gitea数据。

首先，我们需要创建一个数据卷来存储Gitea的数据。在启动Gitea容器时，将数据卷挂载到容器中。这样可以保证数据在容器重启和升级时不会丢失。

现在，我们可以使用以下命令来备份Gitea数据：

docker run --rm -v <gitea_data_volume>:/tmp/backup -v <local_backup_path>:/tmp/backup_backup gitea/gitea:<gitea_version> gitea dump -c /etc/gitea/app.ini -f /tmp/backup/gitea-dump.zip

上述命令将使用Gitea容器中的`/etc/gitea/app.ini`配置文件和`/tmp/backup/gitea-dump.zip`备份文件路径。你需要将`<gitea_data_volume>`替换为你的Gitea数据卷路径，将`<local_backup_path>`替换为你的本地备份文件路径，将`<gitea_version>`替换为你的Gitea版本。

要恢复Gitea数据，可以使用以下命令：

docker run --rm -v <gitea_data_volume>:/data -v <local_backup_path>:/backup:ro gitea/gitea:<gitea_version> gitea restore -c /etc/gitea/app.ini -f /backup/gitea-dump.zip

上述命令将使用`/data`目录作为Gitea容器中的数据卷路径，使用`/backup/gitea-dump.zip`作为备份文件路径。你需要将`<gitea_data_volume>`替换为你的Gitea数据卷路径，将`<local_backup_path>`替换为你的本地备份文件路径，将`<gitea_version>`替换为你的Gitea版本。

现在，你已经学会了如何备份和恢复Gitea数据。记得定期备份数据以保证数据安全。

### 6.2 如何升级Gitea版本

Gitea社区经常发布新的版本来修复漏洞和提供新的功能。了解如何升级Gitea版本是很重要的。

首先，我们需要停止当前运行的Gitea容器：

docker-compose down

接下来，我们需要更新Gitea镜像到最新版本：

docker pull gitea/gitea:<latest_version>

将`<latest_version>`替换为最新的Gitea版本号。

现在，我们可以使用Docker Compose重新启动Gitea容器：

docker-compose up -d

此时，新的Gitea版本已经部署成功。请确保在升级之前备份好数据。

### 6.3 容器化部署的优势和注意事项

容器化部署的Gitea具有以下优势：

- 简单快速：使用Docker部署Gitea非常简单和快速，只需要几个命令即可完成。
- 环境隔离：每个Gitea容器都是相互隔离的，不会相互影响。
- 可移植性：Gitea容器可以在不同的环境中运行，只需要安装Docker即可。
- 可扩展性：可以通过增加更多的容器实例来实现横向扩展。

在部署Gitea时，还需要注意以下事项：

- 定期备份数据：为了保证数据的安全，建议定期备份Gitea的数据。
- 定期更新Gitea版本：及时更新Gitea版本可以获得更好的安全性和性能。
- 配置合理的资源限制：根据实际情况，合理配置Gitea容器的资源限制，以免影响其他应用程序的运行。

以上是常见问题的解决方法和容器化部署的优势以及注意事项。希望对你部署Gitea有所帮助！