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

ipynb (1) Versions 1.1.0

Installs/Configures IPython Notebook

Policyfile
Berkshelf
Knife
cookbook 'ipynb', '~> 1.1.0', :supermarket
cookbook 'ipynb', '~> 1.1.0'
knife supermarket install ipynb
knife supermarket download ipynb
README
Dependencies
Quality 17%

IPython Notebook Cookbook

Sets up an IPython Notebook server using Chef.

This cookbook targets IPython 1.0.0 and will not deploy 0.x releases.

Requirements

This cookbook uses Chef 11. Additionally, Berkshelf is recommended but not required.

Requirements for Vagrant

  • Berkshelf: gem install berks
  • Vagrant 1.2.4 or higher
  • Berkshelf plugin for Vagrant: vagrant plugin install vagrant-berkshelf
  • Omnibus plugin for Vagrant: vagrant plugin install vagrant-omnibus

Usage

Include this cookbook

This cookbook isn't on opscode (yet), so for now you'll have to use Berkshelf and point to it in your Berksfile

cookbook 'ipynb',
  :git => 'https://github.com/rgbkrk/ipynb-cookbook'

Bootstrap VirtualBox

You can also try it out using Vagrant with VirtualBox.

vagrant up

Once finished, the IPython notebook can be accessed from your host machine (through port forwarding) on 127.0.0.1:9999.

Attributes

See attributes/default.rb for default values. Most values including :linux_user, :linux_group, and :service_name default to 'ipynb'.

Particularly important parameters for configuration of the notebook are located in node[:ipynb][:NotebookApp].

  • node[:ipynb][:NotebookApp][:password] - Password to use when accessing the notebook. (Please use an encrypted data bag to set this attribute in a real deployment).

If you're using the virtualenv recipe, you can either install more to the same virtualenv (node[:ipynb][:virtenv]) or add additional packages to node[:ipynb][:extra_packages].

Recipes

The default recipe simply installs (using system packages) IPython Notebook, numpy, Pandas, matplotlib, and all the dependencies for these.

The virtenv_launch recipe creates user and group ipynb, creates a spot to store notebooks, and sets up ipython notebook as a service using supervisord.

The proxy recipe adds an nginx proxy to the notebook and requires you to set the certificate and key attributes.

  • node[:ipynb][:ssl_certificate] - Location to install the SSL certificate (e.g. /etc/nginx/ssl.crt)
  • node[:ipynb][:ssl_certificate_text] - Text for the SSL Certificate
  • node[:ipynb][:ssl_certificate_key] - Location to install the SSL private key (e.g. /etc/nginx/ssl.key)
  • node[:ipynb][:ssl_certificate_key_text] - Text for the SSL private key

On a real deployment, these should be set using an encrypted data bag.

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b feature1)
  3. Commit your changes (git commit -am 'Added new provider to ...')
  4. Push to the branch (git push origin feature1)
  5. Create a new Pull Request

Author

Author:: Kyle Kelley (kyle.kelley@rackspace.com)

Copyright 2013, 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

python >= 0.0.0
yum >= 2.3.0
apt >= 2.0.0
supervisor >= 0.4.5
nginx >= 1.7.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

Collaborator Number Metric
            

1.1.0 failed this metric

Failure: Cookbook has 1 collaborators. A cookbook must have at least 2 collaborators to pass this metric.

Contributing File Metric
            

1.1.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.1.0 failed this metric

FC009: Resource attribute not recognised: ipynb/recipes/default.rb:41
FC064: Ensure issues_url is set in metadata: ipynb/metadata.rb:1
FC065: Ensure source_url is set in metadata: ipynb/metadata.rb:1
FC066: Ensure chef_version is set in metadata: ipynb/metadata.rb:1
FC069: Ensure standardized license defined in metadata: ipynb/metadata.rb:1
FC074: LWRP should use DSL to define resource's default action: ipynb/resources/mathjax.rb:1
FC074: LWRP should use DSL to define resource's default action: ipynb/resources/profile.rb:1
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any

No Binaries Metric
            

1.1.0 passed this metric

Testing File Metric
            

1.1.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.1.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