cookbook 'gogs', '~> 1.0.0'
gogs (4) Versions 1.0.0 Follow0
Installs and Configures a Go Git Service Server
cookbook 'gogs', '~> 1.0.0', :supermarket
knife supermarket install gogs
knife supermarket download gogs
gogs
Installs gogs (Go Git Service), An open source Git Service.
This cookbook installs gogs on port 8080 with sqllite3 by default. It skips the installer
meaning that everything is set to go; however, you will need to create an admin account
on your own. Do this by just going to the web ui and filling out the form or by inserting into
the database. LWRP for that to come at some point.
Requirements
-
apt
cookbook -
systemd
cookbook -
ark
cookbook -
chef-sugar
cookbook
Attributes
Install Attributes
-
node['gogs']['install_dir']
default:'/opt'
The path to install gogs to, note that there will be a gogs
subfolder created where everything will live.
By default the executable and configuration lives in /opt/gogs/
.
-
node['gogs']['version']
default'0.6.1'
The Release version to install. See https://github.com/gogits/gogs/releases
Config Attributes
The node['gogs']['config']
tree gets parsed into the gogs app.ini.
Note that the attributes are split into sections then into their individual settings.
For Documentation on what each setting does please refer to the app.ini
An excerpt of attributes/default.rb
to give you an idea of how these options work:
default['gogs']['config']['global']['APP_NAME'] = 'Gogs: Go Git Service' default['gogs']['config']['global']['RUN_USER'] = 'git' default['gogs']['config']['global']['RUN_MODE'] = 'prod' default['gogs']['config']['repository']['ROOT'] = '/ops/gogs/repos' default['gogs']['config']['repository']['SCRIPT_TYPE'] = 'bash' default['gogs']['config']['server']['PROTOCOL'] = 'http' default['gogs']['config']['server']['DOMAIN'] = 'localhost' default['gogs']['config']['server']['ROOT_URL'] = '%(PROTOCOL)s://%(DOMAIN)s:%(HTTP_PORT)s/' default['gogs']['config']['server']['HTTP_ADDR'] = '0.0.0.0' default['gogs']['config']['server']['HTTP_PORT'] = 8080
Recipes
default
This recipe installs and configures gogs
- Set up & updates apt using
apt::default
- Installs Git and Supervisord
- Downloads and installs gogs from Github
- Configures gogs according to
node['gogs']['config']
Usage
Include this recipe in a wrapper cookbook:
depends 'gogs', '~> 1.0'
include_recipe 'gogs::default'
Contributing
- Fork the repository on Github
- Create a named feature branch (like
add_component_x
) - Write your change
- Write tests for your change (if applicable)
- Run the tests with
kitchen test
, ensuring they all pass - Submit a Pull Request using Github
License and Authors
Author:: Eddie Hurtig (eddie@hurtigtechnologies.com)
Dependent cookbooks
chef-sugar >= 0.0.0 |
ark >= 0.0.0 |
apt >= 0.0.0 |
supervisord ~> 1.0.0 |
Contingent cookbooks
There are no cookbooks that are contingent upon this one.
Change Log for gogs
All notable changes to this project will be documented in this file.
This project adheres to Semantic Versioning.
Unreleased
Changed
- Improve argument against commit logs.
0.0.2 - YYY-MM-DD
Added
- Explanation of the recommended reverse chronological release ordering.
Changed
- Refer to a "change log" instead of a "CHANGELOG" throughout the site to differentiate between the file and the purpose of the file — the logging of changes.
Removed
- Remove empty sections from CHANGELOG, they occupy too much space and create too much noise in the file. People will have to assume that the missing sections were intentionally left out because they contained no notable changes.
0.0.1 - YYYY-MM-DD
Added
- This CHANGELOG file to hopefully serve as an evolving example of a standardized open source project CHANGELOG.
- CNAME file to enable GitHub Pages custom domain
- README now contains answers to common questions about CHANGELOGs
- Good examples and basic guidelines, including proper date formatting.
- Counter-examples: "What makes unicorns cry?"
Collaborator Number Metric
1.0.0 failed this metric
Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.
Contributing File Metric
1.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file
Foodcritic Metric
1.0.0 passed this metric
No Binaries Metric
1.0.0 passed this metric
Testing File Metric
1.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
1.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
1.0.0 failed this metric
1.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file
Foodcritic Metric
1.0.0 passed this metric
No Binaries Metric
1.0.0 passed this metric
Testing File Metric
1.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
1.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
1.0.0 passed this metric
1.0.0 passed this metric
Testing File Metric
1.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
1.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
1.0.0 failed this metric
1.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number