| commit | author | age | ||
| 791ee8 | 1 | # Ansible Role: Gogs |
| JP | 2 | |
| 3 | [](https://travis-ci.org/geerlingguy/ansible-role-gogs) | |
| 4 | ||
| 5 | Installs [Gogs](https://github.com/gogits/gogs), a Go-based front-end to Git, on RedHat or Debian-based linux systems. | |
| 6 | ||
| 7 | After the playbook is finished, visit the gogs server (on port 3000 by default), and you will be redirected to the /install page, where you can configure an administrator account and other default options. | |
| 8 | ||
| 9 | ## Requirements | |
| 10 | ||
| 11 | Requires git (via `geerlingguy.git`), and at least the Gogs HTTP port (3000 by default) open on your system's firewall. Install MySQL (e.g. via `geerlingguy.mysql`) prior to installing Gogs if you would like to use MySQL instead of built-in SQLite support. | |
| 12 | ||
| 13 | ## Role Variables | |
| 14 | ||
| 15 | Available variables are listed below, along with default values (see `defaults/main.yml`): | |
| 16 | ||
| 17 | gogs_user: git | |
| 18 | gogs_user_home: /home/git | |
| 19 | ||
| 20 | The user and home under which Gogs will run and be installed. | |
| 21 | ||
| 22 | gogs_binary_url: https://github.com/gogits/gogs/releases/download/v0.3.1/linux_amd64.zip | |
| 23 | ||
| 24 | Download URL for the Gogs binary. | |
| 25 | ||
| 26 | gogs_http_port: "3000" | |
| 27 | ||
| 28 | HTTP port over which Gogs will be accessed. | |
| 29 | ||
| 30 | gogs_use_mysql: false | |
| 31 | gogs_db_name: gogs | |
| 32 | gogs_db_username: gogs | |
| 33 | gogs_db_password: root | |
| 34 | ||
| 35 | MySQL database support. Set `gogs_use_mysql` to `true` to configure MySQL for gogs, using the database name, username, and password defined by the respective variables. | |
| 36 | ||
| 37 | ## Dependencies | |
| 38 | ||
| 39 | - geerlingguy.git | |
| 40 | ||
| 41 | ## Example Playbook | |
| 42 | ||
| 43 | - hosts: servers | |
| ae6f44 | 44 | vars_files: |
| 791ee8 | 45 | - vars/main.yml |
| JP | 46 | roles: |
| 47 | - geerlingguy.gogs | |
| 48 | ||
| 49 | *Inside `vars/main.yml`*: | |
| 50 | ||
| 51 | gogs_http_port: "8080" | |
| 52 | ||
| 53 | ## License | |
| 54 | ||
| 55 | MIT / BSD | |
| 56 | ||
| 57 | ## Author Information | |
| 58 | ||
| 59 | This role was created in 2014 by [Jeff Geerling](https://www.jeffgeerling.com/), author of [Ansible for DevOps](https://www.ansiblefordevops.com/). | |
