Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms

RSS

git-ssh-server (7) Versions 0.3.0

Set up a basic git repository container to be accesed via SSH.

Berkshelf/Librarian
Policyfile
Knife
cookbook 'git-ssh-server', '= 0.3.0'
cookbook 'git-ssh-server', '= 0.3.0', :supermarket
knife cookbook site install git-ssh-server
knife cookbook site download git-ssh-server
README
Dependencies
Changelog
Quality

Description

Cookbook Version Dependency Status Build Status

Set up a basic git repository container to be accessed via ssh.

Requirements

Supported Platforms

This cookbook has been tested on the following platforms:

  • Amazon
  • Arch
  • CentOS
  • Debian
  • Fedora
  • FreeBSD
  • RedHat
  • Scientific
  • Ubuntu

Please, let us know if you use it successfully on any other platform.

Required Cookbooks

Attributes

<table> <tr> <th>Attribute</th> <th>Description</th> <th>Default</th> </tr> <tr> <td><code>node['git-ssh-server']['base_path']</code></td> <td>Git repository base path</td> <td><em>calculated</em></td> </tr> <tr> <td><code>node['git-ssh-server']['user']</code></td> <td>System user used to manage the repositories</td> <td><code>"git"</code></td> </tr> <tr> <td><code>node['git-ssh-server']['group']</code></td> <td>System group used to manage the repositories</td> <td><code>"git"</code></td> </tr> <tr> <td><code>node['git-ssh-server']['shell']</code></td> <td>Git user shell</td> <td><code>"/usr/bin/git-shell"</code></td> </tr> <tr> <td><code>node['git-ssh-server']['hostname']</code></td> <td>Machine hostname, used only in the README template</td> <td><em>calculated</em></td> </tr> </table>

Recipes

git-ssh-server::default

Configures a git repository container

Resources

git_ssh_server_bare[name]

Creates a new bare repository.

git_ssh_server_bare Actions

  • create: Creates a bare repository (default).

git_ssh_server_bare Properties

<table> <tr> <th>Properties</th> <th>Description</th> <th>Default</th> </tr> <tr> <td>name</td> <td>Repository name</td> <td><em>resource name</em></td> </tr> <tr> <td>base_path</td> <td>Git repository base path</td> <td><code>node['git-ssh-server']['base_path']</code></td> </tr> <tr> <td>add_update_server_hook</td> <td>Create the post-update-hook with <code>exec git update-server-info</code> [true/false]</td> <td>false</td> </tr> </table>

git_ssh_server_bare Example

git_ssh_server_bare 'library1'

git_ssh_server_bare 'webapp1' do
  add_update_server_hook true
end

git_ssh_server_ssh_key[keyname]

Grant access to an SSH key to all the repositories.

git_ssh_server_ssh_key Actions

  • add: adds an SSH key (default).

git_ssh_server_ssh_key Properties

<table> <tr> <thProperties</th> <th>Description</th> <th>Default</th> </tr> <tr> <td>keyname</td> <td>SSH key name</td> <td><em>resource name</em></td> </tr> <tr> <td>key</td> <td>SSH RSA public key value</td> <td><em>required</em></td> </tr> <tr> <td>keytype</td> <td>SSH RSA key type</td> <td><code>"ssh-rsa"</code></td> </tr> <tr> <td>base_path</td> <td>Git repository base path</td> <td><code>node['git-ssh-server']['base_path']</code></td> </tr> </table>

git_ssh_server_ssh_key Example

# the SSH public key from your ~/.ssh/*.pub file
git_ssh_server_ssh_key 'battle-laptop' do
  key 'AAAAB3NzaC1yc2EAAAABIwAAAQEA[...]'
end

Usage Example

Including in a Cookbook Recipe

include_recipe 'git-ssh-server::default' # or put it in your run_list

git_ssh_server_bare 'my-library-one'
git_ssh_server_bare 'my-library-two'
git_ssh_server_bare 'my-webapp'

git_ssh_server_ssh_key 'my-laptop-key' do
  key 'AAAAB3NzaC1yc2EAAAABIwAAAQEAv8lgaVb1BtGTLZG2cwc8WQF/X2Mxcuu/UPxN3yT6VQuFa6zl/LbSMND9OADS6ULw6p0hnWPnRDA8rSJvdcYO7pTSJOclScEuIMm4Nx8c3uhfePF/o39QPhH3WAyee/SFDay430Y11W5ZuOXuZ7Wb2PQEPUaQxs9k/MUHjIIcNLS7qG/FP5IGAb0df9KkAnSGXTgZ/Z9Xh+4mAkoBkXIr99oZsphF/PcxcVQfq4V6dTg81LUPLfaSj6U8gXmjRpRYNgk5uEdci7loKDmv1EPKhzwsJIEp9wxpAJqel5sezHaYN5w3zplbr7UY1+YuEBn2jnYhzbdBZcVDmL1D5F/G+Q=='
end

git_ssh_server_ssh_key 'another-developer' do
  key 'AAAAB3NzaC1yc2EAAAABIwAAAQEAqFEaEEv9Fx+6Qv8LPoY+e9rsvaARGJJbvc7y2Tl73zoA6rB7VTxqoyV6mhG+ozRiB4i5g5andBCSDjDXPS0ycUQmiR2OrLZDUpf3uUhaeOO1SFjIbUyFdqy1MBkcmkDzBtXJ/qgn/ydUX59lT00AoPY4URVMt13uaI6GCWrsxRFX+Hxk5prVjoUqJQ7iSidXJ9CHksKTamgn3Ywc9w1MMYcegB+NVg0GsHDZMyq1PxFKGtqNS2PriQfoUrva76rolTej2rbnyH9drZZNi8lsxZ/Xi8ObjT68gc3OfswA64DRhQuN+aQT4bBK1xU+2AE88P9L2LSEYkekTzt7CElqrw=='
end

Don't forget to include the git-ssh-server cookbook as a dependency in the metadata.

# metadata.rb
[...]

depends 'git-ssh-server'

Including in the Run List

Another alternative is to include the default recipe in your Run List.

{
  "name": "git.onddo.com",
  [...]
  "run_list": [
    [...]
    "recipe[git-ssh-server]"
  ]
}

Testing

See TESTING.md.

Contributing

Please do not hesitate to open an issue with any questions or problems.

See CONTRIBUTING.md.

License and Author

Author: Raúl Rodríguez (raul@onddo.com)
Author: Xabier de Zuazo (xabier@onddo.com)
Contributor: Arnold Krille
Copyright: Copyright (c) 2013 Onddo Labs, SL. (www.onddo.com)
License: Apache License, Version 2.0
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.

Dependent cookbooks

git >= 2.2.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

CHANGELOG for git-ssh-server

This file is used to list changes made in each version of git-ssh-server cookbook.

v0.3.0 (2014-11-16)

  • Activate the post-update hook when the param is true (issue #3, thanks Arnold Krille).
  • git_ssh_server_bare: change user/group in shell_out command.
  • Add FreeBSD support.
  • Add ChefSpec tests for git-ssh-server::default recipe.
  • Enable ChefSpec coverage.
  • providers/bare: ignore FC023 rule.
  • Gemfile:
    • Move test-kitchen gems to :integration group.
    • Fix Illformed requirement in "berkshelf".
  • Add travis.yml file.
  • Test for the update-hook (issue #2, thanks Arnold Krille).
  • Update tests: add Gemfile, Berksfile and Rakefile templates.
  • Update kitchen.yml file.
  • Move test/kitchen/cookbooks to test/cookbooks.
  • README:
    • Split in multiple files.
    • Add multiple badges.
    • Fixes and improvements.

v0.2.0 (2014-01-18)

v0.1.3 (2013-11-17)

  • Fix: bare repositories do not have .git dir.
  • git_ssh_server_bare LWRP notify only when the action is executed.

v0.1.2 (2013-10-28)

  • metadata: provides without square brackets to avoid CHEF-3976.

v0.1.1 (2013-08-15)

  • metadata: Add minimum git cookbook version in depends.
  • Fix git_ssh_server_ssh_key LWRP default action (:add).

v0.1.0 (2013-06-08)

  • Initial release of git-ssh-server.

Foodcritic Metric
            

0.3.0 failed this metric

FC023: Prefer conditional attributes: /tmp/cook/493c381849bfe14336b17f64/git-ssh-server/providers/bare.rb:13