manage_pip_packages/README.md
Bertrand Lanson b782bb1509
All checks were successful
test / Linting (push) Successful in 8s
test / Molecule tests (default, debian12) (push) Successful in 1m16s
test / Molecule tests (default, debian11) (push) Successful in 1m21s
test / Molecule tests (default, ubuntu2004) (push) Successful in 1m22s
test / Molecule tests (default, ubuntu2204) (push) Successful in 59s
test / Molecule tests (with_custom_packages, debian11) (push) Successful in 54s
test / Molecule tests (with_custom_packages, debian12) (push) Successful in 59s
test / Molecule tests (with_custom_packages, ubuntu2004) (push) Successful in 1m22s
test / Molecule tests (with_custom_packages, ubuntu2204) (push) Successful in 1m25s
added ansible verify stage and gitea actions
2023-07-11 20:05:36 +02:00

2.1 KiB

manage_pip_packages

This repository is only a mirror. Development and testing is done on a private gitlab server.

This role enables you to manage python packages on debian-based distributions. It can be used on its own , or be called by other roles the install/remove packages on demand.

Requirements

None.

Role Variables

Available variables are listed below, along with default values. A sample file for the default values is available in default/manage_pip_packages.yml.sample in case you need it for any group_vars or host_vars configuration.

manage_pip_packages_install_prereqs: true # by default, set to true
manage_pip_packages_list: # by default, not defined
  - name: nginx
    version_constraint: latest # Leaving empty or setting '' will be considered as latest
    state: absent
  - name: ...

This variable is a list of packages, with their name, desired version and state. version_constraint can be multiple constraints,separated by commas (example: >1.10, >1.10,<1.15,!=1.12,==1.13).

Dependencies

This role has a task that installs its own dependencies located in task/prerequisites.yml, so that you don't need to manage them. This role requires ednxzu.manage_apt_packages to install python3 and pip. If you already installed python and pip, you can skip dependencies by setting manage_pip_packages_install_prereqs to false.

Example Playbook

# calling the role inside a playbook with either the default or group_vars/host_vars
- hosts: servers
  roles:
    - ednxzu.manage_pip_packages
# calling the role inside a playbook and injecting variables (in another role for example)
- hosts: servers
  tasks:
    - name: "Install ansible with pip"
      ansible.builtin.include_role:
        name: ednxzu.manage_pip_packages
      vars:
        manage_pip_packages_install_prereqs: false
        manage_pip_packages_list:
          - name: ansible-core
            version_constraint: latest
            state: present

License

MIT / BSD

Author Information

This role was created by Bertrand Lanson in 2023.