idem-cloud 1.0.1

USAGE and INSTALLATION

./idem-cloud --help

pip install idem-cloud

DEVELOPMENT

Clone the idem-cloud repository and install with pip.

git clone git@gitlab.com:saltstack/pop/idem-cloud.git
pip install -e idem_cloud

TESTING

• Install docker-compose and enable the docker service

• Install the testing requirements:

  pip install -r requirements-test.txt

• Run the tests:

  pytest tests

Set UP

After installation the Idem Bootstrap execution and state modules will be accessible to the pop hub.

EXECUTION MODULES

Once everything has been set up properly, execution modules can be called directly by idem. Execution modules can be accessed by reference relative to their location in the exec directory in idem-cloud/cloud For example, idem-cloud/cloud/exec/bootstrap/salt.py contains a function called create() This function can be accessed from the command line with:

idem exec bootstrap.salt.create user=root host=127.0.0.1

Filters can be used when calling list functions from any cloud list function from the command line, such as idem-aws, so that the output isn’t so verbose:

idem exec aws.ec2.vpc.list --filter vpc_id

STATES

States are also accessed by their relative location in idem-aws/idem_aws/states. For example, idem-aws/idem_aws/states/aws/ec2/vpc.py contains a function absent(). In my state file I can create a state that uses the absent function like so.

my_state.sls:

idem_cloud_boostrap:
  bootstrap.salt.absent:
    - user: root
    - host: 127.0.0.1

I can execute this state with:

idem state my_state.sls

idem state also has some flags that can significantly boost the scalability and performance of the run. Let’s use this new state which verifies that 100 vpcs are absent:

{% for i in range(100) %}
idem_cloud_boostrap_minion_{{i}}:
  bootstrap.salt.absent:
    - host: "idem_cloud_test_minion_{{i}}"
    - user: root
{% endfor -%}

I can execute this state with –runtime parallel to make full use of idem’s async execution calls:

idem state --runtime parallel my_state.sls