ansible-gitea

Overview

- hosts: all
  vars:
    gitea_database_name: gitea
    gitea_database_user: gitea
    gitea_database_password: "{{ vault_crypted_gitea_database_pass }}"
    gitea_salt: "{{ vault_crypted_gitea_salt }}"
    gitea_domain: git.example.com
    gitea_database_uri: mysql.example.com:3306
  roles:
    - alvaroaleman.gitea

Purpose

This role is designed to install the Gogs git server.

Requirements

• silpion.lib

Role Variables

• gitea_domain: The main URL for link generation (required)
• gitea_database_password: The password for the gitea database (required)
• gitea_salt: The salt used for storing passwords (required)
• gitea_database_uri: The URI for database connection (default: localhost:3306)
• gitea_database_name: The name of the database that gitea will use (default: gitea)
• gitea_database_user: The database user that gitea will use (default: gitea)
• gitea_database_type: The type of database for gitea (default: mysql)
• gitea_http_port: The HTTP port for gitea (default: 3000)
• gitea_ssh_port: The SSH port for gitea (default: 2222)
• gitea_http_proto: Whether to use http or https for links (default: http)
• gitea_logdir: The directory for log files (default: /var/run/gitea)
• gitea_appini_template: The template for the gitea app.ini configuration file (default: builtin_app.ini.j2)
• gitea_home: The folder for gitea data (default: /srv/gitea)
• gitea_username: The user for running gitea. Must be root to bind ports < 1024 (default: gitea)
• gitea_install_dir: The installation folder for gitea (default: /opts/gitea)
• gitea_config_dir: The folder for gitea configuration files (default: /etc/gitea)
• gitea_version: The version of gitea to install (default: 1.1.0)
• gitea_http_listen_addr: The address for listening to HTTP requests (default: '')

How to Contribute

If you want to contribute, please fork this repository, create a branch from the master branch, and submit a pull request back to the master branch.

License

AGPLv3

Testing Integration

This role includes integration tests using Ruby RSpec/serverspec framework. Note that some setup is required.

To run integration tests, install the necessary dependencies. Since the role uses Ruby RSpec, make sure you have Ruby with rake and bundler.

# Install role-specific dependencies using bundler
bundle install

# Run all tests using Docker
rake suite

# Run all tests using Vagrant
source envvars-vagrant.sample
rake suite

# Run all tests with Vagrant without cleaning the box afterward
source envvars-vagrant.sample
RAKE_ANSIBLE_VAGRANT_DONT_CLEANUP=1 rake suite

Author

• Alvaro Aleman