puppet-gitea

Puppet module to configure gitea

• Setup
• Example configurations
• Parameter reference
• Tests
• Contributions
• License and Author

Setup

This module installs gitea from upstream binary

Example configurations

Install a gitea with default settings

class {'gitea':
}

Install gitea with postgresql backend, needs an installed

class {'gitea':
  database_type     => 'postgresql',
  database_host     => '127.0.0.1:5432',
  database_name     => 'gitea',
  database_user     => 'gitea',
  database_password => 'someultrasecretstuff',
}

Parameter reference

All parameters are documented with puppet-strings. You can view the markdown-rendered result at REFERENCE.md.

Tests

This module has several unit tests and linters configured. You can execute them by running:

bundle exec rake test

Contributions

Contribution is fairly easy:

• Fork the module into your namespace
• Create a new branch
• Commit your bugfix or enhancement
• Write a test for it (maybe start with the test first)
• Create a pull request

Or simply open an issue, maybe someone will have a look into it!

Hacktoberfest

This project is participating at hacktoberfest

License and Author

This module was originally written by Sebastian Rakel and reviewed by my personal puppet guru Tim Meusel. It's licensed with AGPL version 3.

Reference

Table of Contents

Classes

• gitea: manages gitea installation
• gitea::config
• gitea::database
• gitea::install
• gitea::service

Classes

gitea

manages gitea installation

Parameters

The following parameters are available in the gitea class:

• version
• home
• user
• group
• repository_path
• app_name
• domain
• run_mode
• database_type
• database_host
• database_name
• database_user
• database_password
• http_protocol
• http_addr
• root_url
• disable_registration
• disable_git_hooks
• lfs_enabled
• lfs_data_path
• http_port

version

Data type: String[1]

Gitlab Version to install

home

Data type: String[1]

home path of the gitea user

user

Data type: String[1]

gitea user

group

Data type: String[1]

gitea user group

repository_path

Data type: String[1]

where repository should be stored

app_name

Data type: String[1]

name for your gitea instance

domain

Data type: String[1]

domain where your instance is

run_mode

Data type: Enum['dev', 'prod']

in which mode gitea should be run (dev, prod)

database_type

Data type: Enum['postgresql', 'sqlite']

which database should be configured (postgresql, sqlite)

database_host

Data type: String

host of the database (currently only for postgresql)

database_name

Data type: String

name of the database (currently only for postgresql)

database_user

Data type: String

user of the database (currently only for postgresql)

database_password

Data type: String

password of the database (currently only for postgresql)

http_protocol

Data type: Enum['http','unix']

which protocol should be used (unix, http)

http_addr

Data type: String[1]

listen address

root_url

Data type: String[1]

root url of the gitea instance e.g '%(PROTOCOL)s://%(DOMAIN)s:%(HTTP_PORT)s/'

disable_registration

Data type: Boolean

disables registration

disable_git_hooks

Data type: Boolean

disables git hooks in the webui

lfs_enabled

Data type: Boolean

enables git LFS for repositories

lfs_data_path

Data type: Stdlib::Absolutepath

where should lfs data be stored

http_port

Data type: Integer

gitea::config

The gitea::config class.

gitea::database

The gitea::database class.

gitea::install

The gitea::install class.

gitea::service

The gitea::service class.

Changelog

All notable changes to this project will be documented in this file. Each new release typically also includes the latest modulesync defaults. These should not affect the functionality of the module.

v0.3.3 (2022-10-02)

Full Changelog

Merged pull requests:

• Fix double quoted string #18 (sebastianrakel)
• modulesync 5.3.0 #16 (sebastianrakel)

v0.3.2 (2022-10-02)

Full Changelog

Merged pull requests:

• Rename in metadata #13 (sebastianrakel)

v0.3.1 (2022-10-02)

Full Changelog

Merged pull requests:

• Use new release workflow #11 (sebastianrakel)

v0.3.0 (2022-10-02)

Full Changelog

v0.2.6 (2022-10-02)

Full Changelog

Merged pull requests:

• Update gemfile to current version from voxpupuli #8 (sebastianrakel)
• Update gitea to version 1.17.2 #7 (sebastianrakel)
• Add first changelog #6 (sebastianrakel)

0.2.6 (2022-05-05)

Full Changelog

0.2.5 (2022-05-05)

Full Changelog

0.2.4 (2022-05-05)

Full Changelog

Merged pull requests:

• code cleanup and improvements #5 (aba-rechsteiner)

0.2.3 (2021-10-02)

Full Changelog

Merged pull requests:

• Update to gitea version 1.15.3 #4 (sebastianrakel)

0.2.2 (2021-08-24)

Full Changelog

Merged pull requests:

• Update README and prepare release #3 (sebastianrakel)
• Enable unit tests and fix broken code and apply linters #2 (bastelfreak)
• Fix installation #1 (sebastianrakel)

* This Changelog was automatically generated by github_changelog_generator