0
0
Fork 0
mirror of https://github.com/go-gitea/gitea synced 2024-12-16 15:14:01 +01:00
gitea/docs/content/administration/backup-and-restore.zh-cn.md
me2seeks 470a3e3f89
Update some translations and fix markdown formatting (#29099)
Update `docs/content/administration/backup-and-restore.zh-cn.md` 
`docs/content/contributing/guidelines-frontend.zh-cn.md`
`docs/content/help/support.zh-cn.md`
`docs/content/installation/database-preparation.zh-cn.md`
`docs/content/installation/windows-service.zh-cn.md`
`docs/content/usage/profile-readme.zh-cn.md` to be consistent with the
English document
2024-02-11 19:03:49 +02:00

5.9 KiB
Raw Blame History

date title slug sidebar_position toc draft aliases menu
2018-06-06T09:33:00+08:00 备份与恢复 backup-and-restore 11 false false
/zh-cn/backup-and-restore
sidebar
parent name sidebar_position identifier
administration 备份与恢复 11 backup-and-restore

备份与恢复

Gitea 已经实现了 dump 命令可以用来备份所有需要的文件到一个zip压缩文件。该压缩文件可以被用来进行数据恢复。

备份一致性

为了确保 Gitea 实例的一致性,在备份期间必须关闭它。

Gitea 包括数据库、文件和 Git 仓库,当它被使用时所有这些都会发生变化。例如,当迁移正在进行时,在数据库中创建一个事务,而 Git 仓库正在被复制。如果备份发生在迁移的中间Git 仓库可能是不完整的,尽管数据库声称它是完整的,因为它是在之后被转储的。避免这种竞争条件的唯一方法是在备份期间停止 Gitea 实例。

备份命令 (dump)

先转到git用户的权限: su git. 再Gitea目录运行 ./gitea dump。一般会显示类似如下的输出:

2016/12/27 22:32:09 Creating tmp work dir: /tmp/gitea-dump-417443001
2016/12/27 22:32:09 Dumping local repositories.../home/git/gitea-repositories
2016/12/27 22:32:22 Dumping database...
2016/12/27 22:32:22 Packing dump files...
2016/12/27 22:32:34 Removing tmp work dir: /tmp/gitea-dump-417443001
2016/12/27 22:32:34 Finish dumping in file gitea-dump-1482906742.zip

最后生成的 gitea-dump-1482906742.zip 文件将会包含如下内容:

  • app.ini - 如果原先存储在默认的 custom/ 目录之外,则是配置文件的可选副本
  • custom/ - 所有保存在 custom/ 目录下的配置和自定义的文件。
  • data/ - 数据目录APP_DATA_PATH如果使用文件会话则不包括会话。该目录包括 attachmentsavatarslfsindexers、如果使用 SQLite 则包括 SQLite 文件。
  • repos/ - 仓库目录的完整副本。
  • gitea-db.sql - 数据库dump出来的 SQL。
  • log/ - Logs文件如果用作迁移不是必须的。

中间备份文件将会在临时目录进行创建,如果您要重新指定临时目录,可以用 --tempdir 参数,或者用 TMPDIR 环境变量。

备份数据库

gitea dump 创建的 SQL 转储使用 XORMGitea 管理员可能更喜欢使用本地的 MySQL 和 PostgreSQL 转储工具。使用 XORM 转储数据库时仍然存在一些问题,可能会导致在尝试恢复时出现问题。

# mysql
mysqldump -u$USER -p$PASS --database $DATABASE > gitea-db.sql
# postgres
pg_dump -U $USER $DATABASE > gitea-db.sql

使用Docker dump

在使用 Docker 时,使用 dump 命令有一些注意事项。

必须以 gitea/conf/app.ini 中指定的 RUN_USER = <OS_USERNAME> 执行该命令;并且,为了让备份文件夹的压缩过程能够顺利执行,docker exec 命令必须在 --tempdir 内部执行。

示例:

docker exec -u <OS_USERNAME> -it -w <--tempdir> $(docker ps -qf 'name=^<NAME_OF_DOCKER_CONTAINER>$') bash -c '/usr/local/bin/gitea dump -c </path/to/app.ini>'

*注意:--tempdir 指的是 Gitea 使用的 Docker 环境的临时目录;如果您没有指定自定义的 --tempdir,那么 Gitea 将使用 /tmp 或 Docker 容器的 TMPDIR 环境变量。对于 --tempdir,请相应调整您的 docker exec 命令选项。

结果应该是一个文件,存储在指定的 --tempdir 中,类似于:gitea-dump-1482906742.zip

恢复命令 (restore)

当前还没有恢复命令,恢复需要人工进行。主要是把文件和数据库进行恢复。

例如:

unzip gitea-dump-1610949662.zip
cd gitea-dump-1610949662
mv app.ini /etc/gitea/conf/app.ini
mv data/* /var/lib/gitea/data/
mv log/* /var/lib/gitea/log/
mv repos/* /var/lib/gitea/gitea-repositories/
chown -R gitea:gitea /etc/gitea/conf/app.ini /var/lib/gitea

# mysql
mysql --default-character-set=utf8mb4 -u$USER -p$PASS $DATABASE <gitea-db.sql
# sqlite3
sqlite3 $DATABASE_PATH <gitea-db.sql
# postgres
psql -U $USER -d $DATABASE < gitea-db.sql

service gitea restart

如果安装方式发生了变化(例如 二进制 -> Docker或者 Gitea 安装到了与之前安装不同的目录,则需要重新生成仓库 Git 钩子。

在 Gitea 运行时,并从 Gitea 二进制文件所在的目录执行:./gitea admin regenerate hooks

这样可以确保仓库 Git 钩子中的应用程序和配置文件路径与当前安装一致。如果这些路径没有更新,仓库的 push 操作将失败。

使用 Docker (restore)

在基于 Docker 的 Gitea 实例中,也没有恢复命令的支持。恢复过程与前面描述的步骤相同,但路径不同。

示例:

# 在容器中打开 bash 会话
docker exec --user git -it 2a83b293548e bash
# 在容器内解压您的备份文件
unzip gitea-dump-1610949662.zip
cd gitea-dump-1610949662
# 恢复 Gitea 数据
mv data/* /data/gitea
# 恢复仓库本身
mv repos/* /data/git/gitea-repositories/
# 调整文件权限
chown -R git:git /data
# 重新生成 Git 钩子
/usr/local/bin/gitea -c '/data/gitea/conf/app.ini' admin regenerate hooks

Gitea 容器中的默认用户是 git1000:1000。请用您的 Gitea 容器 ID 或名称替换 2a83b293548e

使用 Docker-rootless (restore)

在 Docker-rootless 容器中的恢复工作流程只是要使用的目录不同:

# 在容器中打开 bash 会话
docker exec --user git -it 2a83b293548e bash
# 在容器内解压您的备份文件
unzip gitea-dump-1610949662.zip
cd gitea-dump-1610949662
# 恢复 app.ini
mv data/conf/app.ini /etc/gitea/app.ini
# 恢复 Gitea 数据
mv data/* /var/lib/gitea
# 恢复仓库本身
mv repos/* /var/lib/gitea/git/gitea-repositories
# 调整文件权限
chown -R git:git /etc/gitea/app.ini /var/lib/gitea
# 重新生成 Git 钩子
/usr/local/bin/gitea -c '/etc/gitea/app.ini' admin regenerate hooks