puppet-gitea

Description

A Puppet module for managing Gitea (Git with a cup of tea) settings. This module allows you to install and configure Gitea using pre-built binaries and does not need external package repositories. You can chose to install Gitea with default settings, or customize all settings to your liking.

Setup

What Gitea affects

• puppet-gitea depends on
  • puppetlabs-stdlib,
  • puppetlabs-inifile,
  • lwf-remote_file,
• it install dependencies for gitea: curl, git and tar
• it manages a user and group git
• it manages the gitea directory (/opt/gitea) and the repositories (/var/git)
• it install a gitea service listening on port 3000

Beginning with Gitea

The simplest use case is to rely on defaults. This can be done by simply including the class:

include ::gitea

Reference

Class: gitea

class { 'gitea':
    package_ensure => 'present',
    dependencies_ensure => 'present',
    dependencies => ['curl', 'git', 'tar'],
    manage_user => true,
    manage_group => true,
    manage_home => true,
    owner => 'git',
    group => 'git',
    home => '/home/git',
    version => '1.1.0',
    checksum => '59cd3fb52292712bd374a215613d6588122d93ab19d812b8393786172b51d556',
    checksum_type => 'sha256',
    installation_directory => '/opt/gitea',
    repository_root => '/var/git',
    log_directory => '/var/log/gitea',
    attachment_directory => '/opt/gitea/data/attachments',
    configuration_sections => {},
    manage_service => true,
    service_template => 'gitea/systemd.erb',
    service_path => '/lib/systemd/system/gitea.service',
    service_provider => 'systemd',
    service_mode => '0644',
}

Class: gitea::packages

class { 'gitea::packages':
    dependencies_ensure => 'present',
    dependencies => ['curl', 'git', 'tar'],
}

Class: gitea::user

class { 'gitea::user':
    manage_user => true,
    manage_group => true,
    manage_home => true,
    owner => 'git',
    group => 'git',
    home => '/home/git',
}

Class: gitea::install

class { 'gitea::install':
    package_ensure => 'present',
    owner => 'git',
    group => 'git',
    version => '1.1.0',
    checksum => '59cd3fb52292712bd374a215613d6588122d93ab19d812b8393786172b51d556',
    checksum_type => 'sha256',
    installation_directory => '/opt/gitea',
    repository_root => '/var/git',
    log_directory => '/var/log/gitea',
    attachment_directory => '/opt/gitea/data/attachments',
    manage_service => true,
    service_template => 'gitea/systemd.erb',
    service_path => '/lib/systemd/system/gitea.service',
    service_provider => 'systemd',
    service_mode => '0644',
}

Class: gitea::service

class { 'gitea::service':
    manage_service => true,
    service_provider => 'systemd',
    installation_directory => '/opt/gitea',
    log_directory => '/var/log/gitea',
}

Class: gitea::config

class { 'gitea::config':
    configuration_sections => {},
    owner => 'git',
    group => 'git',
    installation_directory => '/opt/gitea',
    repository_root => '/var/git',
    attachment_directory => '/opt/gitea/data/attachments',
}

Limitations

See metadata.json for supported platforms.

Development

Running tests

This project contains tests for rspec-puppet.

Quickstart:

gem install bundler
bundle install
bundle exec rake test

When submitting pull requests, please make sure that module documentation, test cases and syntax checks pass.

Changelog

All notable changes to this project will be documented in this file.

Release 1.0.4 (2017-11-13)

With this release, ownership of this module is transfered to Kogito UG, a DevOps / Infrastructure services business in Berlin, Germany.

Features

• Base URL for Gitea downloads can now be pointed to a custom location
• Converted module to be Puppet Development Kit compatible
• Added support for Debian 9 (Stretch)
• Updated Puppet requirements to be in line with PE lifecycle

Release 1.0.3 (2017-07-13)

Features

• Added gitea::attachment_directory to allow customized issue attachment paths
• Switched to using proper resource types in all places
• Updated module documentation

Bugfixes

• Added missing file logging mode

Release 1.0.2 (2017-05-04)

Features

• Added gitea::log_directory to allow customized log paths

Release 1.0.1 (2017-05-02)

Bugfixes

• Updated Travis CI build settings enabling automated module builds

Release 1.0.0 (2017-05-02)

Initial release of Gitea management module. Hello, World!

Known Issues

• Travis CI build not (yet) working.