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.
This commit is contained in:
Lunny Xiao
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