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

Select Status

RSS

jenkinsstack (4) Versions 1.3.0

Installs/Configures jenkinsstack

Policyfile
Berkshelf
Knife
cookbook 'jenkinsstack', '= 1.3.0', :supermarket
cookbook 'jenkinsstack', '= 1.3.0'
knife supermarket install jenkinsstack
knife supermarket download jenkinsstack
README
Dependencies
Changelog
Quality 0%

jenkinsstack

Stack used to configure a jenkins master and any number of jenkins slaves. By default, the stack uses SSH slaves (master initiated) as opposed to JNLP slaves (slave initiated). The master generates a private key that is used for jenkins authentication as well as passwordless SSH from master to slaves.

Disclaimers

Changing of Jenkins SSH key pairs should be considered unsupported. If a specific SSH key is desired, please add this before the initial buildout. It is possible to manually change this, but it does require manual changes on the server.

[Changelog](CHANGELOG.md)

See CHANGELOG.md for additional information about changes to this stack over time.

Supported Platforms

Ubuntu 12.04, Ubuntu 14.04, CentOS 6.5

Attributes

Here are attributes exposed by this stack. Please note that you may also override many attributes from the upstream cookbook.

<table>
<tr>
<th>Key</th>
<th>Type</th>
<th>Description</th>
<th>Default</th>
</tr>
<tr>
<td><tt>['jenkinsstack']['nginx_proxy']</tt></td>
<td>Boolean</td>
<td>whether to configure a locked-down nginx proxy in front of jenkins (mostly for testing. real customers will want specific security.)</td>
<td><tt>true</tt></td>
</tr>
<tr>
<td><tt>['jenkinsstack']['site_name']</tt></td>
<td>String</td>
<td>the server name to use for the nginx proxy</td>
<td><tt>jenkins</tt></td>
</tr>
<tr>
<td><tt>['jenkinsstack']['rax_theme']</tt></td>
<td>Boolean</td>
<td>whether to include install the Rackspace theme</td>
<td><tt>true</tt></td>
</tr>
<tr>
<td><tt>['jenkinsstack']['slave']['executors']</tt></td>
<td>integer</td>
<td>How many executors to configure on each slave</td>
<td><tt>6</tt></td>
</tr>
<tr>
<td><tt>['jenkinsstack']['plugins']</tt></td>
<td>Array of strings</td>
<td>Additional Jenkins plugins to install</td>
<td>See [default.rb](attributes/default.rb)</td>
</tr>
<tr>
<td><tt>['jenkinsstack']['packages']</tt></td>
<td>Array of strings</td>
<td>Additional OS packages to install</td>
<td>See [default.rb](attributes/default.rb)</td>
</tr>
<tr>
<td><tt>['jenkinsstack']['server_ruby']</tt></td>
<td>String</td>
<td>Version of ruby to install and configure for jenkins user</td>
<td>1.9.3-p484</td>
</tr>
<tr>
<td><tt>['jenkinsstack']['ruby_gems']</tt></td>
<td>Array of strings</td>
<td>Additional Ruby gems packages to install</td>
<td>['bundler', 'test-kitchen']</td>
</tr>
</table>

Usage

jenkinsstack::default

Nothing. This recipe is empty.

jenkinsstack::java

Calls the jenkins cookbook's java recipe.

jenkinsstack::master

Configures a Jenkins master. Configures any slaves found using Chef search (slaves are found based on tags used in jenkinsstack::slave).

jenkinsstack::slave

Configures a Jenkins slave.

jenkinsstack::ruby

Configures ruby with version node['jenkinsstack']['server_ruby'] and gems from ['jenkinsstack']['ruby_gems']. This recipe must be included separately, and is intended to help configure a build environment that uses bundler to run things like rake or test-kitchen.

jenkinsstack::find_all

Used to populate ['jenkinsstack']['all'] for wrapper cookbooks. Aids in writing IP tables rules for SSH (22), HTTP (80), and HTTPS (443).

jenkinsstack::_nginx

Normally, there wouldn't be a call out for recipes just used within in the cookbook, but this one bears specific notes. It configures an nginx reverse proxy with basic auth over a self-signed SSL certificate. You will almost certainly want to configure something specific to an app cookbook or customer to listen on 80/443 and proxy to :8080 with appropriate SSL certificates and configuring appropriate authentication for jenkins (these are defaults). Note that by default, jenkins does not secure itself. You should immediately login to a new jenkins master and turn on a specific authentication method, even if it is simply the builtin. This recipe prevents needing to do that for most testing and development work with test-kitchen.

Contributing

See CONTRIBUTING.

Authors

Author:: Rackspace (devops-chef@rackspace.com)

License

# Copyright 2014, Rackspace Hosting
#
# 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

chef-sugar >= 0.0.0
jenkins = 2.1.2
build-essential >= 0.0.0
apt >= 0.0.0
user >= 0.0.0
curl >= 0.0.0
rbenv >= 0.0.0
nginx-proxy >= 0.0.0
openssl >= 0.0.0
htpasswd >= 0.0.0
line >= 0.0.0
platformstack >= 0.0.0
logstash_commons >= 0.0.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

1.3.0

Allow server name to be set (#34).

1.2.0

Add elkstack logging for Jenkins logs if ELK available.

1.1.0

Serverspec update, slave fixes/simplifications

1.0.1

Refactor auth to prevent a problem during convergence. Now, the chef user and
credentials are created but not passed to jenkins::* recipes on the first chef
run, and at the very end, Jenkins is restarted. The credentials are only passed
on subsequent runs which require them after the restart.

1.0.0

Java behavior has been extracted into its own recipe. Call the java recipe here
to use a wrapper from jenkins::java. Otherwise, you must ensure java is installed
before using the master or slave recipes in this cookbook.

0.1.0

Initial release of jenkinsstack

Foodcritic Metric
            

1.3.0 failed this metric

FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/2f4e6b18c0f6662614daa77b/jenkinsstack/recipes/_prep_keys.rb:64
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/2f4e6b18c0f6662614daa77b/jenkinsstack/recipes/_prep_keys.rb:65