ansible-role-gitea/README.md
Adrien Waksberg bfb7daa541 first version
2018-06-09 23:07:33 +02:00

58 lines
2 KiB
Markdown

# Ansible role: Gitea
[![Version](https://img.shields.io/badge/latest_version-1.0.0-green.svg)](https://git.yaegashi.fr/nishiki/ansible-role-gitea/releases)
[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](https://git.yaegashi.fr/nishiki/ansible-role-gitea/src/branch/master/LICENSE)
Install gitea (a self-hosted git service) from the binary
## Requirements
None
## Role variables
* `gitea_version` - the gitea version to install (see: https://github.com/go-gitea/gitea/releases)
* `gitea_architecture` - the binary architecture to install (default: `linux-amd64`)
* `gitea_port` - the gitea bind port (default: `3000`)
* `gitea_user` - the user name for gitea user (default: `gitea`)
* `gitea_group` - the group name for gitea user (default: `gitea`)
* `gitea_uid` - the user id for gitea user (default: `990`)
* `gitea_gid` - the group id for gitea user (default: `990`)
* `gitea_home` - the home directory for gitea user (default: `/home/{{ gitea_user }}`)
* `gitea_repository_directory` - the git repositories directory (default: `'{{ gitea_home }}/data/repositories'`)
* `gitea_log_directory` - the gitea log directory (default: `{{ gitea_home }}/log`)
## How to use
* Install:
```
- hosts: git-server
roles:
- gitea
```
## Development
### Tests with docker
* install [docker](https://docs.docker.com/engine/installation/)
* install ruby
* install bundler `gem install bundler`
* install dependencies `bundle install`
* run the tests `kitchen test`
## License
```
Copyright (c) 2018 Adrien Waksberg
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
```