Rôle Ansible gitea/forgejo

Ce rôle installe et gère gitea ou forgejo. Un service Git auto-hébergé sans douleur. Gitea est une solution de gestion de code légère et communautaire écrite en Go. Forgejo est un fork de cela.

Mirroirs

Le rôle est également disponible sur :

• Github : github.com/roles-ansible/ansible_role_gitea
• Gitea : git.l3d.ch/ansible/ansible_role_gitea

Exemples d'utilisation dans un playbook

Le code suivant a été testé avec la dernière version stable de Debian. Il devrait également fonctionner sur Ubuntu et RedHat.

# Installation du rôle ansible-galaxy l3d.gitea

- name: "Installer gitea"
  hosts: git.example.com
  roles:
    - {role: l3d.gitea, tags: gitea}
  vars:
    gitea_fqdn: 'git.example.com'
    gitea_root_url: 'https://git.example.com'
    gitea_protocol: http
    gitea_start_ssh: true

Choisir entre le serveur SSH intégré de Gitea et un serveur SSH hôte

Gitea a un serveur SSH intégré qui fonctionne sur le port 2222. Ce serveur est utilisé par défaut dans ce rôle et permet d'obtenir une URL de clonage SSH de gitea@<fqdn>:2222:<user>/<repo>.git.

Souvent, on veut avoir une URL SSH "propre" comme git@<fqdn>:<user>/<repo>.git. Cela est possible en utilisant le serveur SSH hôte avec la configuration suivante :

gitea_ssh_port: 22
gitea_user: git
gitea_start_ssh: false

Variables

Voici un aperçu des variables de ce rôle gitea. Pour des informations plus détaillées sur certaines variables, veuillez consulter ce résumé de configuration.

Mise à jour de Gitea

Exigences

Ce rôle utilise les collections Ansible ansible.builtin et community.general. Pour télécharger la dernière version de forgejo/gitea, nous utilisons json_query, ce qui nécessite que jmespath soit disponible.

Packages Python

• jmespath

Exemples d'installation des exigences

ansible-galaxy collection install --update --role-file requirements.yml
pip3 install --update jmespath

Contribuer

N'hésitez pas à créer une demande de tirage ou à me contacter au Mastodon @[email protected]. Je serai ravi de résoudre les problèmes que vous soulevez ou même mieux, d'examiner vos demandes de tirage :)