IPython Notebooks Deployment Role

The dareko.ipython role deploys the IPython software on a target host.

The IPython notebook users and groups are created by the role if they don't exist.

Requirements

This role requires Ansible 1.4 or higher. Platform requirements are listed in the Supported Platforms section of the role details. The rhel-epel yum repository must be enabled on the server.

Role Variables

The variables that can be passed to this role with default values are as follows.

# ipython notebooks configuration
# provide a list of { profile, port, user, group, sha1_password, notebook_dir } items
# sha1_password can be empty or generated via:
#     python -c 'from IPython.lib import passwd; print(passwd("<password>"))'
ipython_notebooks:
  - profile:
    port:
    user:
    group:      
    sha1_password:
    notebook_dir:

# list of dependencies
ipython_packages:
  - gcc
  - gcc-c++
  - gcc-gfortran
  - libpng-devel
  - freetype-devel
  - python-devel
  - blas-devel
  - lapack-devel
  - pandoc

# list of pip packages
ipython_pip_packages:
  - pyzmq
  - tornado
  - jinja2
  - pygments
  - numpy
  - matplotlib
  - pandas
  - lxml
  - openpyxl
  - xlrd
  - twitter
  - oauth2
  - pypandoc
  - ipython
  - scipy
  - patsy
  - statsmodels
  - scikit-learn
  - bokeh

# http and https proxy if needed
proxy_env:
  http_proxy:
  https_proxy:

Dependencies

None

Example Playbook

1. Add a group to the hosts inventory file

    [ipython]
    host.domain
   

2. Add variables to the group_vars/all file

    ipython_notebooks:
      - profile: profile_name
        port: 8888
        user: user_name
        group: group_name
        sha1_password:
        notebook_dir: /home/user_name/notebooks
    
    proxy_env:
      http_proxy: http://proxy.domain:8080
      https_proxy: http://proxy.domain:8080
   

3. Add role to the site.yml file

    - hosts: ipython
      sudo: true
      roles:
      - role: dareko.ipython
   

4. Run the site.yml playbook

    ansible-playbook -i hosts site.yml
   

License

MIT License

Author Information

Darek Owczarek