idem-posix

Grains, execution modules, and state modules common to all posix systems

About

idem-posix helps executing commands on a posix system idem.

• idem-posix source code

• idem-posix documentation

What is POP?

This project is built with pop, a Python-based implementation of Plugin Oriented Programming (POP). POP seeks to bring together concepts and wisdom from the history of computing in new ways to solve modern computing problems.

For more information:

• Intro to Plugin Oriented Programming (POP)

• pop-awesome

• pop-create

What is Idem?

This project is built with idem, an idempotent, imperatively executed, declarative programming language written in Python. This project extends idem!

For more information:

• Idem Project Website

• Idem Project docs portal

Installation

Install with pip:

pip install idem-posix

Development Installation

Clone the idem-posix repo and install with pip:

git clone https://gitlab.com/vmware/idem/idem-posix idem_posix
pip install -e idem_posix

Execution

After installation the Idem Posix Provider execution and state modules will be accessible to the pop hub. In order to use them we need to set up our credentials.

Example of using cmd.run state in SLS:

# Execute "ls -l" command
my_state_name:
  cmd.run:
    cmd: ls -l
    cwd: /
    shell: False
    env:
      ENV_VAR_1: ENV_VAL_1
      ENV_VAR_2: ENV_VAL_2
    timeout: 100
    render_pipe:
    kwargs:

Example of using cmd.run with Idem CLI:

idem exec cmd.run "shell command --with-flags" cwd=/home render_pipe=json timeout=10