1
0
mirror of https://github.com/CMiksche/gitea-auto-update synced 2025-12-10 16:07:23 +01:00
Files
gitea-auto-update/README.md
Christoph Miksche c52491ae2e ci: switch to drone
Switch the CI system from travis to drone

Closes #19
2021-04-20 18:33:52 +02:00

89 lines
2.8 KiB
Markdown

# Gitea Auto Update
[![Build Status](https://cloud.drone.io/api/badges/CMiksche/gitea-auto-update/status.svg)](https://cloud.drone.io/CMiksche/gitea-auto-update)
[![PyPI version](https://badge.fury.io/py/gitea-auto-update.svg)](https://badge.fury.io/py/gitea-auto-update)
[![Downloads](https://pepy.tech/badge/gitea-auto-update)](https://pepy.tech/project/gitea-auto-update)
Script for a automatic update of gitea. Should be run locally on the gitea server. Has options for updating via new binary file or build from source.
## Procedure
* Get Gitea Version from the Gitea CLI and if that fails from the Gitea API
* Get latest Release via GitHub API
* Check if there is a newer Version
* If there is a newer Version:
* If binary file was selected:
* Download new version
* Check sha256
* Overwrite old version
* If build from source is active:
* Checkout new release branch
* Build binary
* Overwrite old binary
## General Information
License: GNU General Public License
Author: Christoph Daniel Miksche (m5e.de)
Uses python version 3
## Installation
Create a settings.ini file on your system. Example:
````
[Gitea]
site=https://your-gitea-instance.com/api/v1/version
apiUrl=https://api.github.com/repos/go-gitea/gitea/releases/latest
system=linux-amd64
file=/usr/local/bin/gitea
tmpDir=/tmp/
buildFromSource=
sourceDir=
logFile=update.log
````
Use the following command to install gitea-auto-update.
```
sudo pip3 install gitea-auto-update
```
Enter the command `gite-auto-update --settings=/path/to/settings.ini` in your commandline.
If you want to schedule your updates, edit your /etc/crontab file.
## Tutorials
* English: http://blog.m5e.de/gitea/update/upgrade/bash/script/2018/11/26/gitea-auto-update-script.html
* German: https://blog.wronnay.net/automatische-gitea-updates/
## Development
The following instructions help you for developing.
* Check out the [Contribution Guidelines](CONTRIBUTING.md).
* Clone this git repo
* Install pipenv: `pip install pipenv`
* Install all dependencies: `pipenv install`
* Install git pre-commit hooks (for pylint and gitlint) with `pre-commit install`
* You can run the tests with `python -m unittest`
* After pushing, you should check the build status which currently checks the tests, pylint and the commit message format.
### Notes
The following steps are automatically executed via pre-commit hooks.
* You can run pylint with `pylint gitea_auto_update`
* After changes and commit, you can check if your commit message follows the contribution guidelines with `gitlint`. If there is a problem, gitlint will show you a error message.
## Contributors
- [@Eideen](https://github.com/Eideen)
- [@iwalton3](https://github.com/iwalton3)
Thank you for your support!
Interested in contributing to this project? Check out the [Contribution Guidelines](CONTRIBUTING.md).