ghost-automation/ds_gitea
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 3 Wiki Activity

Updated the readme for more clarity.

Browse Source
This commit is contained in:
Tom
2026-02-09 16:56:29 +01:00
parent c088b18b49
commit f0aecb43dd
1 changed files with 16 additions and 16 deletions
Download Patch File Download Diff File Expand all files Collapse all files

32
README.org
View File

@@ -4,20 +4,21 @@
* ds-gitea * ds-gitea
This role installs and configures a basic [[https://docs.gitea.com/][Gitea]] server. This role installs and configures a [[https://docs.gitea.com/][Gitea]] server.
Currently it uses SQLite as its database service. It uses SQLite as its default database service.
Use the =ds-ufw= role to set up the firewall. Use the =ds-ufw= role to configure the firewall.
* Features * Role Workflow
- Download and install the Gitea binary 1. Download and install the Gitea binary
- Set up the user and group for the service 2. Set up the user and group for the service
- Create the required directory structure 3. Create the required directory structure
- Deploy the Gitea configuration 4. Wait for the secret creation and storage in SOPS - if secrets are not present
- Deploy the Gitea service file 5. Deploy the Gitea configuration
- Enable and start the service 6. Deploy the Gitea service file
7. Enable and start the service
* Defaults * Defaults
@@ -26,8 +27,6 @@ gitea_user: git
gitea_group: git gitea_group: git
#+end_src #+end_src
The remaining variables must be declared in the inventory.
* Requirements * Requirements
- Ansible >= 2.12 - Ansible >= 2.12
@@ -44,12 +43,12 @@ The remaining variables must be declared in the inventory.
| gitea_group | string | Gitea group | | gitea_group | string | Gitea group |
| gitea_binary_url | string | Download URL of Gitea | | gitea_binary_url | string | Download URL of Gitea |
| gitea_checksum_url | string | Checksum URL of the binary | | gitea_checksum_url | string | Checksum URL of the binary |
| gitea_app_name | string | Gitea application title | | gitea_app_name | string | Gitea server title |
| gitea_ssh_domain | string | SSH domain | | gitea_ssh_domain | string | SSH domain |
| gitea_domain | string | Domain to reach Gitea | | gitea_domain | string | Domain to reach Gitea |
| gitea_http_port | int | Gitea HTTP port | | gitea_http_port | int | HTTP port |
| gitea_ssh_port | int | Gitea SSH port | | gitea_ssh_port | int | SSH port |
| gitea_root_url | string | Protocol + FQDN | | gitea_root_url | string | Protocol + FQDN + port |
| gitea_lfs_jwt_secret | string | LFS storage secret | | gitea_lfs_jwt_secret | string | LFS storage secret |
| gitea_internal_token | string | Internal token | | gitea_internal_token | string | Internal token |
| gitea_jwt_secret | string | JWT secret | | gitea_jwt_secret | string | JWT secret |
@@ -91,6 +90,7 @@ Then re-run the playbook to finish the installation.
gitea_domain: gitea.tomsitcafe.com gitea_domain: gitea.tomsitcafe.com
gitea_http_port: 3000 gitea_http_port: 3000
gitea_root_url: http://gitea.tomsitcafe.com:3000 gitea_root_url: http://gitea.tomsitcafe.com:3000
# In prod put these secrets in SOPS: # In prod put these secrets in SOPS:
gitea_lfs_jwt_secret: G9bZrRHMhRQ8w4R0KkH2VLnx2rzq81ROQ951IQjlMs4 gitea_lfs_jwt_secret: G9bZrRHMhRQ8w4R0KkH2VLnx2rzq81ROQ951IQjlMs4
gitea_internal_token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYmYiOjE3NzA2Mzk1Njh9.ybbaeNLFiLbyvxfj4vkqhXSAXKRGpwvP8jIm9YLPgXw gitea_internal_token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYmYiOjE3NzA2Mzk1Njh9.ybbaeNLFiLbyvxfj4vkqhXSAXKRGpwvP8jIm9YLPgXw