Ansibleロール: Pip (Python用)

LinuxにPipをインストールするためのAnsibleロールです。

要件

RedHat/CentOSでは、このロールを実行する前にEPELをインストールしておく必要があります。シンプルにインストールを確実にする方法が必要な場合は、geerlingguy.repo-epelロールを使用できます。

ロール変数

使用可能な変数は以下にリストされており、デフォルト値も記載されています（defaults/main.ymlを参照）：

pip_package: python3-pip

システムにpipをインストールするためのパッケージ名です。Python 3が利用できない古いシステムの場合は、これをpython-pipに設定できます。

pip_executable: pip3

このロールは、pip_packageに基づいてpip実行可能ファイルを自動検出しようとします（例: Python 2用のpip、Python 3用のpip3）。明示的に上書きすることも可能です（例: pip_executable: pip3.6）。

pip_install_packages: []

pipでインストールするパッケージのリストです。以下の例を参照してください：

pip_install_packages:
  # 名前とバージョンを指定します。
  - name: docker
    version: "1.2.3"
  - name: awscli
    version: "1.11.91"

  # または、最新のリリースを取得するためにパッケージの名前だけを指定します。
  - docker
  - awscli

  # または、パッケージをアンインストールします。
  - name: docker
    state: absent

  # または、パッケージを最新バージョンに更新します。
  - name: docker
    state: latest

  # または、強制的に再インストールします。
  - name: docker
    state: forcereinstall

  # または、特定のvirtualenvにパッケージをインストールします。
  - name: docker
    virtualenv: /my_app/venv

  # または、追加の引数を渡します。
  - name: my_special_package_from_my_special_repo
    extra_args: --extra-index-url https://my-domain/pypi/pypi-master/simple

依存関係

なし。

サンプルプレイブック

- hosts: all

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

  roles:
    - geerlingguy.pip

ライセンス

MIT / BSD

著者情報

このロールは、Jeff Geerlingによって2017年に作成されました。彼はAnsible for DevOpsの著者です。