mirror of https://github.com/go-gitea/gitea
Remove upgrade from Gogs doc because the diverse has been 7 years and the code base changed totally (#27387)
The documentation becomes no help since that but make people confusing.pull/27386/head^2
Lunny Xiao
1 year ago
committed by
GitHub
parent
79e1f27eda
commit
4999d909a6
@ -1,112 +0,0 @@ |
||||
--- |
||||
date: "2016-12-01T16:00:00+02:00" |
||||
title: "Upgrade from Gogs" |
||||
slug: "upgrade-from-gogs" |
||||
sidebar_position: 101 |
||||
toc: false |
||||
draft: false |
||||
aliases: |
||||
- /en-us/upgrade-from-gogs |
||||
menu: |
||||
sidebar: |
||||
parent: "installation" |
||||
name: "Upgrade From Gogs" |
||||
sidebar_position: 101 |
||||
identifier: "upgrade-from-gogs" |
||||
--- |
||||
|
||||
# Upgrade from Gogs |
||||
|
||||
Gogs, version 0.9.146 and older, can be easily migrated to Gitea. |
||||
|
||||
There are some basic steps to follow. On a Linux system run as the Gogs user: |
||||
|
||||
* Create a Gogs backup with `gogs backup`. This creates `gogs-backup-[timestamp].zip` file |
||||
containing all important Gogs data. You would need it if you wanted to move to the `gogs` back later. |
||||
* Download the file matching the destination platform from the [downloads page](https://dl.gitea.com/gitea/). |
||||
It should be `1.0.x` version. Migrating from `gogs` to any other version is impossible. |
||||
* Put the binary at the desired install location. |
||||
* Copy `gogs/custom/conf/app.ini` to `gitea/custom/conf/app.ini`. |
||||
* Copy custom `templates, public` from `gogs/custom/` to `gitea/custom/`. |
||||
* For any other custom folders, such as `gitignore, label, license, locale, readme` in |
||||
`gogs/custom/conf`, copy them to `gitea/custom/options`. |
||||
* Copy `gogs/data/` to `gitea/data/`. It contains issue attachments and avatars. |
||||
* Verify by starting Gitea with `gitea web`. |
||||
* Enter Gitea admin panel on the UI, run `Rewrite '.ssh/authorized_keys' file`. |
||||
* Launch every major version of the binary ( `1.1.4` → `1.2.3` → `1.3.4` → `1.4.2` → etc ) to migrate database. |
||||
* If custom or config path was changed, run `Rewrite all update hook of repositories`. |
||||
|
||||
## Change gogs specific information |
||||
|
||||
* Rename `gogs-repositories/` to `gitea-repositories/` |
||||
* Rename `gogs-data/` to `gitea-data/` |
||||
* In `gitea/custom/conf/app.ini` change: |
||||
|
||||
FROM: |
||||
|
||||
```ini |
||||
[database] |
||||
PATH = /home/:USER/gogs/data/:DATABASE.db |
||||
[attachment] |
||||
PATH = /home/:USER/gogs-data/attachments |
||||
[picture] |
||||
AVATAR_UPLOAD_PATH = /home/:USER/gogs-data/avatars |
||||
[log] |
||||
ROOT_PATH = /home/:USER/gogs/log |
||||
``` |
||||
|
||||
TO: |
||||
|
||||
```ini |
||||
[database] |
||||
PATH = /home/:USER/gitea/data/:DATABASE.db |
||||
[attachment] |
||||
PATH = /home/:USER/gitea-data/attachments |
||||
[picture] |
||||
AVATAR_UPLOAD_PATH = /home/:USER/gitea-data/avatars |
||||
[log] |
||||
ROOT_PATH = /home/:USER/gitea/log |
||||
``` |
||||
|
||||
* Verify by starting Gitea with `gitea web` |
||||
|
||||
## Upgrading to most recent `gitea` version |
||||
|
||||
After successful migration from `gogs` to `gitea 1.0.x`, it is possible to upgrade `gitea` to a modern version |
||||
in a two steps process. |
||||
|
||||
Upgrade to [`gitea 1.6.4`](https://dl.gitea.com/gitea/1.6.4/) first. Download the file matching |
||||
the destination platform from the [downloads page](https://dl.gitea.com/gitea/1.6.4/) and replace the binary. |
||||
Run Gitea at least once and check that everything works as expected. |
||||
|
||||
Then repeat the procedure, but this time using the [latest release](https://dl.gitea.com/gitea/@version@/). |
||||
|
||||
## Upgrading from a more recent version of Gogs |
||||
|
||||
Upgrading from a more recent version of Gogs (up to `0.11.x`) may also be possible, but will require a bit more work. |
||||
See [#4286](https://github.com/go-gitea/gitea/issues/4286), which includes various Gogs `0.11.x` versions. |
||||
|
||||
Upgrading from Gogs `0.12.x` and above will be increasingly more difficult as the projects diverge further apart in configuration and schema. |
||||
|
||||
## Troubleshooting |
||||
|
||||
* If errors are encountered relating to custom templates in the `gitea/custom/templates` |
||||
folder, try moving the templates causing the errors away one by one. They may not be |
||||
compatible with Gitea or an update. |
||||
|
||||
## Add Gitea to startup on Unix |
||||
|
||||
Update the appropriate file from [gitea/contrib](https://github.com/go-gitea/gitea/tree/main/contrib) |
||||
with the right environment variables. |
||||
|
||||
For distros with systemd: |
||||
|
||||
* Copy the updated script to `/etc/systemd/system/gitea.service` |
||||
* Add the service to the startup with: `sudo systemctl enable gitea` |
||||
* Disable old gogs startup script: `sudo systemctl disable gogs` |
||||
|
||||
For distros with SysVinit: |
||||
|
||||
* Copy the updated script to `/etc/init.d/gitea` |
||||
* Add the service to the startup with: `sudo rc-update add gitea` |
||||
* Disable old gogs startup script: `sudo rc-update del gogs` |
||||
@ -1,85 +0,0 @@ |
||||
--- |
||||
date: "2017-08-23T09:00:00+02:00" |
||||
title: "Mise à jour depuis Gogs" |
||||
slug: "upgrade-from-gogs" |
||||
sidebar_position: 101 |
||||
toc: false |
||||
draft: false |
||||
aliases: |
||||
- /fr-fr/upgrade-from-gogs |
||||
menu: |
||||
sidebar: |
||||
parent: "installation" |
||||
name: "Depuis Gogs" |
||||
sidebar_position: 101 |
||||
identifier: "upgrade-from-gogs" |
||||
--- |
||||
|
||||
# Mise à jour depuis Gogs |
||||
|
||||
À partir de la version 0.9.146 (schéma de la base de données : version 15) de Gogs, Il est possible de migrer vers Gitea simplement et sans encombre. |
||||
|
||||
Veuillez suivre les étapes ci-dessous. Sur Unix, toute les commandes s'exécutent en tant que l'utilisateur utilisé pour votre installation de Gogs : |
||||
|
||||
* Crééer une sauvegarde de Gogs avec la commande `gogs dump`. Le fichier nouvellement créé `gogs-dump-[timestamp].zip` contient toutes les données de votre instance de Gogs. |
||||
* Téléchargez le fichier correspondant à votre plateforme à partir de la [page de téléchargements](https://dl.gitea.com/gitea). |
||||
* Mettez la binaire dans le répertoire d'installation souhaité. |
||||
* Copiez le fichier `gogs/custom/conf/app.ini` vers `gitea/custom/conf/app.ini`. |
||||
* Si vous avez personnalisé les répertoires `templates, public` dans `gogs/custom/`, copiez-les vers `gitea/custom/`. |
||||
* Si vous avez d'autres répertoires personnalisés comme `gitignore, label, license, locale, readme` dans `gogs/custom/conf` copiez-les vers `gitea/custom/options`. |
||||
* Copiez le répertoire `gogs/data/` vers `gitea/data/`. |
||||
* Vérifiez votre installation en exécutant Gitea avec la commande `gitea web`. |
||||
* Lancez le binaire de version majeure en version majeure ( `1.1.4` → `1.2.3` → `1.3.4` → `1.4.2` → etc ) afin de récupérer les migrations de base de données. |
||||
* Connectez vous au panel d'administration de Gitea et exécutez l'action `Rewrite '.ssh/authorized_keys' file`, puis l'action `Rewrite all update hook of repositories` (obligatoire si le chemin menant à votre configuration personnalisée à changé). |
||||
|
||||
## Modifier les informations spécifiques de gogs |
||||
|
||||
* Renommez `gogs-repositories/` vers `gitea-repositories/` |
||||
* Renommez `gogs-data/` to `gitea-data/` |
||||
* Dans votre fichier `gitea/custom/conf/app.ini`, modifiez les éléments suivants: |
||||
|
||||
DE : |
||||
|
||||
```ini |
||||
[database] |
||||
PATH = /home/:USER/gogs/data/:DATABASE.db |
||||
[attachment] |
||||
PATH = /home/:USER/gogs-data/attachments |
||||
[picture] |
||||
AVATAR_UPLOAD_PATH = /home/:USER/gogs-data/avatars |
||||
[log] |
||||
ROOT_PATH = /home/:USER/gogs/log |
||||
``` |
||||
|
||||
VERS : |
||||
|
||||
```ini |
||||
[database] |
||||
PATH = /home/:USER/gitea/data/:DATABASE.db |
||||
[attachment] |
||||
PATH = /home/:USER/gitea-data/attachments |
||||
[picture] |
||||
AVATAR_UPLOAD_PATH = /home/:USER/gitea-data/avatars |
||||
[log] |
||||
ROOT_PATH = /home/:USER/gitea/log |
||||
``` |
||||
|
||||
* Vérifiez votre installation en exécutant Gitea avec la commande `gitea web`. |
||||
|
||||
## Dépannage |
||||
|
||||
* Si vous rencontrez des erreurs relatives à des modèles personnalisés dans le dossier `gitea/custom/templates`, essayez de déplacer un par un les modèles provoquant les erreurs. Il est possible qu'ils ne soient pas compatibles avec Gitea. |
||||
|
||||
## Démarrer automatiquement Gitea (Unix) |
||||
|
||||
Distributions utilisant systemd: |
||||
|
||||
* Copiez le script mis à jour vers `/etc/systemd/system/gitea.service` |
||||
* Ajoutez le service avec la commande `sudo systemctl enable gitea` |
||||
* Désactivez Gogs avec la commande `sudo systemctl disable gogs` |
||||
|
||||
Distributions utilisant SysVinit: |
||||
|
||||
* Copiez le script mis à jour vers `/etc/init.d/gitea` |
||||
* Ajoutez le service avec la commande `sudo rc-update add gitea` |
||||
* Désactivez Gogs avec la commande `sudo rc-update del gogs` |
||||
@ -1,101 +0,0 @@ |
||||
--- |
||||
date: "2016-12-01T16:00:00+02:00" |
||||
title: "从 Gogs 升级" |
||||
slug: "upgrade-from-gogs" |
||||
sidebar_position: 101 |
||||
toc: false |
||||
draft: false |
||||
aliases: |
||||
- /zh-cn/upgrade-from-gogs |
||||
menu: |
||||
sidebar: |
||||
parent: "installation" |
||||
name: "从 Gogs 升级" |
||||
sidebar_position: 101 |
||||
identifier: "upgrade-from-gogs" |
||||
--- |
||||
|
||||
# 从 Gogs 升级 |
||||
|
||||
如果你正在运行Gogs 0.9.146以下版本，你可以平滑的升级到Gitea。该升级需要如下的步骤： |
||||
|
||||
* 使用 `gogs backup` 创建 Gogs 备份。这会创建一个名为 `gogs-backup-[时间戳].zip` 的文件，其中包含所有重要的 Gogs 数据。如果您将来想要返回到 `gogs`，您会需要这个备份文件。 |
||||
* 从 [下载页面](https://dl.gitea.com/gitea/) 下载适用于目标平台的文件。应该选择 `1.0.x` 版本。从 `gogs` 迁移到其他任何版本是不可能的。 |
||||
* 将二进制文件放置在所需的安装位置。 |
||||
* 将 `gogs/custom/conf/app.ini` 复制到 `gitea/custom/conf/app.ini`。 |
||||
* 将 `gogs/custom/` 中的自定义 `templates, public` 复制到 `gitea/custom/`。 |
||||
* 对于其他自定义文件夹，例如 `gogs/custom/conf` 中的 `gitignore, label, license, locale, readme`，将它们复制到 `gitea/custom/options`。 |
||||
* 将 `gogs/data/` 复制到 `gitea/data/`。其中包含问题附件和头像。 |
||||
* 使用 `gitea web` 启动 Gitea 进行验证。 |
||||
* 在 UI 上进入 Gitea 管理面板，运行 `Rewrite '.ssh/authorized_keys' file`。 |
||||
* 启动每个主要版本的二进制文件（例如 `1.1.4` → `1.2.3` → `1.3.4` → `1.4.2` → 等）以迁移数据库。 |
||||
* 如果自定义或配置路径已更改，请运行 `Rewrite all update hook of repositories`。 |
||||
|
||||
## 更改特定于 Gogs 的信息 |
||||
|
||||
* 将 `gogs-repositories/` 重命名为 `gitea-repositories/` |
||||
* 将 `gogs-data/` 重命名为 `gitea-data/` |
||||
* 在 `gitea/custom/conf/app.ini` 中进行更改： |
||||
从: |
||||
|
||||
```ini |
||||
[database] |
||||
PATH = /home/:USER/gogs/data/:DATABASE.db |
||||
[attachment] |
||||
PATH = /home/:USER/gogs-data/attachments |
||||
[picture] |
||||
AVATAR_UPLOAD_PATH = /home/:USER/gogs-data/avatars |
||||
[log] |
||||
ROOT_PATH = /home/:USER/gogs/log |
||||
``` |
||||
|
||||
到: |
||||
|
||||
```ini |
||||
[database] |
||||
PATH = /home/:USER/gitea/data/:DATABASE.db |
||||
[attachment] |
||||
PATH = /home/:USER/gitea-data/attachments |
||||
[picture] |
||||
AVATAR_UPLOAD_PATH = /home/:USER/gitea-data/avatars |
||||
[log] |
||||
ROOT_PATH = /home/:USER/gitea/log |
||||
``` |
||||
|
||||
* 使用 `gitea web` 启动 Gitea 进行验证 |
||||
|
||||
## 升级到最新版本的 `gitea` |
||||
|
||||
在成功从 `gogs` 迁移到 `gitea 1.0.x` 之后，可以通过两步过程将 `gitea` 升级到现代版本。 |
||||
|
||||
首先升级到 [`gitea 1.6.4`](https://dl.gitea.com/gitea/1.6.4/)。从 [下载页面](https://dl.gitea.com/gitea/1.6.4/) 下载适用于目标平台的文件，并替换二进制文件。至少运行一次 Gitea 并检查是否一切正常。 |
||||
|
||||
然后重复这个过程，但这次使用 [最新版本](https://dl.gitea.com/gitea/@version@/)。 |
||||
|
||||
## 从较新的 Gogs 版本升级 |
||||
|
||||
从较新的 Gogs 版本（最高到 `0.11.x`）可能也是可能的，但需要更多的工作。 |
||||
请参见 [#4286](https://github.com/go-gitea/gitea/issues/4286)，其中包括各种 Gogs `0.11.x` 版本。 |
||||
|
||||
从 Gogs `0.12.x` 及更高版本升级将变得越来越困难，因为项目在配置和架构上逐渐分歧。 |
||||
|
||||
## 故障排除 |
||||
|
||||
* 如果在 `gitea/custom/templates` 文件夹中遇到与自定义模板相关的错误，请尝试逐个移除引发错误的模板。 |
||||
它们可能与 Gitea 或更新不兼容。 |
||||
|
||||
## 将 Gitea 添加到 Unix 的启动项 |
||||
|
||||
从 [gitea/contrib](https://github.com/go-gitea/gitea/tree/main/contrib) 更新适当的文件，确保正确的环境变量。 |
||||
|
||||
对于使用 systemd 的发行版： |
||||
|
||||
* 将更新后的脚本复制到 `/etc/systemd/system/gitea.service` |
||||
* 使用以下命令将服务添加到启动项：`sudo systemctl enable gitea` |
||||
* 禁用旧的 gogs 启动脚本：`sudo systemctl disable gogs` |
||||
|
||||
对于使用 SysVinit 的发行版： |
||||
|
||||
* 将更新后的脚本复制到 `/etc/init.d/gitea` |
||||
* 使用以下命令将服务添加到启动项：`sudo rc-update add gitea` |
||||
* 禁用旧的 gogs 启动脚本：`sudo rc-update del gogs` |
||||
@ -1,107 +0,0 @@ |
||||
--- |
||||
date: "2016-12-01T16:00:00+02:00" |
||||
title: "從 Gogs 升級" |
||||
slug: "upgrade-from-gogs" |
||||
sidebar_position: 101 |
||||
toc: false |
||||
draft: false |
||||
aliases: |
||||
- /zh-tw/upgrade-from-gogs |
||||
menu: |
||||
sidebar: |
||||
parent: "installation" |
||||
name: "從 Gogs 升級" |
||||
sidebar_position: 101 |
||||
identifier: "upgrade-from-gogs" |
||||
--- |
||||
|
||||
# 從 Gogs 升級 |
||||
|
||||
**目錄** |
||||
|
||||
若您正在執行 Gogs 0.9.146 以下版本，您可以很簡單地遷移到 Gitea。 |
||||
|
||||
請參考下列步驟。在 Linux 系統上請以 Gogs 的使用者身份執行： |
||||
|
||||
- 使用 `gogs backup` 建立 Gogs 的備份。這會建立檔案 `gogs-backup-[timestamp].zip` 包含所有重要的 Gogs 資料。 |
||||
如果稍後您要恢復到 `gogs` 時會用到它。 |
||||
- 從[下載頁](https://dl.gitea.com/gitea/)下載對應您平臺的檔案。請下載 `1.0.x` 版，從 `gogs` 遷移到其它版本是不可行的。 |
||||
- 將二進位檔放到適當的安裝位置。 |
||||
- 複製 `gogs/custom/conf/app.ini` 到 `gitea/custom/conf/app.ini`。 |
||||
- 從 `gogs/custom/` 複製自訂 `templates, public` 到 `gitea/custom/`。 |
||||
- `gogs/custom/conf` 中的其它自訂資料夾如： `gitignore, label, license, locale, readme`， |
||||
請複製到 `gitea/custom/options`。 |
||||
- 複製 `gogs/data/` 到 `gitea/data/`。它包含了問題附件和大頭貼。 |
||||
- 以指令 `gitea web` 啟動 Gitea 驗證上列設定是否正確。 |
||||
- 從網頁 UI 進入 Gitea 管理員面板, 執行 `Rewrite '.ssh/authorized_keys' file`。 |
||||
- 執行每個主要版本的二進位檔 ( `1.1.4` → `1.2.3` → `1.3.4` → `1.4.2` → 等等 ) 以遷移資料庫。 |
||||
- 如果變更了自訂檔、設定檔路徑，請執行 `Rewrite all update hook of repositories`。 |
||||
|
||||
## 修改指定的 gogs 資訊 |
||||
|
||||
- 重新命名 `gogs-repositories/` 為 `gitea-repositories/` |
||||
- 重新命名 `gogs-data/` 為 `gitea-data/` |
||||
- 在 `gitea/custom/conf/app.ini` 中修改： |
||||
|
||||
修改前： |
||||
|
||||
```ini |
||||
[database] |
||||
PATH = /home/:USER/gogs/data/:DATABASE.db |
||||
[attachment] |
||||
PATH = /home/:USER/gogs-data/attachments |
||||
[picture] |
||||
AVATAR_UPLOAD_PATH = /home/:USER/gogs-data/avatars |
||||
[log] |
||||
ROOT_PATH = /home/:USER/gogs/log |
||||
``` |
||||
|
||||
修改後： |
||||
|
||||
```ini |
||||
[database] |
||||
PATH = /home/:USER/gitea/data/:DATABASE.db |
||||
[attachment] |
||||
PATH = /home/:USER/gitea-data/attachments |
||||
[picture] |
||||
AVATAR_UPLOAD_PATH = /home/:USER/gitea-data/avatars |
||||
[log] |
||||
ROOT_PATH = /home/:USER/gitea/log |
||||
``` |
||||
|
||||
- 執行 `gitea web` 啟動 Gitea 檢查是否正確執行 |
||||
|
||||
## 升級到最新版的 `gitea` |
||||
|
||||
成功從 `gogs` 升級到 `gitea 1.0.x` 後再用 2 個步驟即可升級到最新版的 `gitea`。 |
||||
|
||||
請先升級到 [`gitea 1.6.4`](https://dl.gitea.com/gitea/1.6.4/)，先從[下載頁](https://dl.gitea.com/gitea/1.6.4/)下載 |
||||
您平臺的二進位檔取代既有的。至少執行一次 Gitea 並確認一切符合預期。 |
||||
|
||||
接著重複上述步驟，但這次請使用[最新發行版本](https://dl.gitea.com/gitea/@version@/)。 |
||||
|
||||
## 從更新版本的 Gogs 升級 |
||||
|
||||
您也可以從更新版本的 Gogs 升級，但需要更多步驟。 |
||||
請參考 [#4286](https://github.com/go-gitea/gitea/issues/4286)。 |
||||
|
||||
## 疑難排解 |
||||
|
||||
- 如果錯誤和 `gitea/custom/templates` 中 的自訂樣板有關，請試著逐一移除它們。 |
||||
它們可能和 Gitea 或更新不相容。 |
||||
|
||||
## 在 Unix 啟動時執行 Gitea |
||||
|
||||
從 [gitea/contrib](https://github.com/go-gitea/gitea/tree/master/contrib) 更新必要的檔案以取得正確的環境變數。 |
||||
|
||||
使用 systemd 的發行版： |
||||
|
||||
- 複製新的腳本到 `/etc/systemd/system/gitea.service` |
||||
- 啟動系統時執行服務： `sudo systemctl enable gitea` |
||||
- 停用舊的 gogs 腳本： `sudo systemctl disable gogs` |
||||
|
||||
使用 SysVinit 的發行版： |
||||
|
||||
- 複製新的腳本到 `/etc/init.d/gitea` |
||||
- 啟動系統時執行服務： `sudo rc-update add gitea` |
||||
- 停用舊的 gogs 腳本： `sudo rc-update del gogs` |
||||
Loading…
Reference in new issue