Ansible Role - Pip (for Python)
Go to file
Jeff Geerling 211bb244f0 PR #11: Add documentation for virtualenv option. 2018-05-01 10:26:17 -05:00
defaults Fixes #7, Fixes #6: Allow customization of pip_package name. 2017-12-19 23:58:00 -06:00
meta Initial commit. 2017-05-26 23:09:47 -04:00
tasks Support Virtualenv (Fix #10) 2018-04-30 16:37:41 +02:00
tests Some additional work on role tests. All blind on an airplane, wheeee. 2017-05-26 23:22:04 -04:00
.gitignore Initial commit. 2017-05-26 23:09:47 -04:00
.travis.yml Test Fedora 27 instead of Fedora 24. 2018-02-17 17:23:03 -06:00
LICENSE Initial commit. 2017-05-26 23:09:47 -04:00
README.md PR #11: Add documentation for virtualenv option. 2018-05-01 10:26:17 -05:00

README.md

Ansible Role: Pip (for Python)

Build Status

An Ansible Role that installs Pip on Linux.

Requirements

On RedHat/CentOS, you may need to have EPEL installed before running this role. You can use the geerlingguy.repo-epel role if you need a simple way to ensure it's installed.

Role Variables

Available variables are listed below, along with default values (see defaults/main.yml):

pip_package: python-pip

The name of the packge to install to get pip on the system. You can set to python3-pip, for example, when using Python 3 on Ubuntu.

pip_install_packages: []

A list of packages to install with pip. Examples below:

pip_install_packages:
  # Specify names and versions.
  - name: docker
    version: "1.2.3"
  - name: awscli
    version: "1.11.91"

  # Or specify bare packages to get the latest release.
  - docker
  - awscli

  # Or uninstall a package.
  - name: docker
    state: absent

  # Or update a package ot the latest version.
  - name: docker
    state: latest

  # Or force a reinstall.
  - name: docker
    state: forcereinstall

  # Or install a package in a particular virtualenv.
  - name: docker
    virtualenv: /my_app/venv

Dependencies

None.

Example Playbook

- hosts: all

  vars:
    pip_install_packages:
      - name: docker
      - name: awscli

  roles:
    - geerlingguy.pip

License

MIT / BSD

Author Information

This role was created in 2017 by Jeff Geerling, author of Ansible for DevOps.