idem-vmware-alb 0.9.3

VMware ALB Provider for Idem

About

avilb Cloud Provider for Idem

• idem_vmware_alb source code

• idem_vmware_alb documentation

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

Getting Started

Prerequisites

• Python 3.8+

• git (if installing from source, or contributing to the project)

Installation

Note

If wanting to contribute to the project, and setup your local development environment, see the CONTRIBUTING.rst document in the source repository for this project.

You can install idem_vmware_alb either from PyPI or from source.

Install from PyPI

pip install "idem_vmware_alb"

Install from source

Clone the idem_vmware_alb repository and install with pip.

# clone repo
git clone git@<your-project-path>/idem_vmware_alb.git
cd idem_vmware_alb

# Setup venv
python3 -m venv .venv
source .venv/bin/activate
pip install -e idem_vmware_alb

Setup

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

Create a new file called credentials.yaml and populate it with profiles. The default profile will be used automatically by idem unless you specify one with –acct-profile=profile_name on the cli.

credentials.yaml

avilb:
  default:
    username: my_user
    password: my_good_password
    endpoint_url: https://console.avilb.com/api

Now encrypt the credentials file and add the encryption key and encrypted file path to the ENVIRONMENT.

idem encrypt credentials.yaml

output:

-A9ZkiCSOjWYG_lbGmmkVh4jKLFDyOFH4e4S1HNtNwI=

Add these to your environment:

export ACCT_KEY="-A9ZkiCSOjWYG_lbGmmkVh4jKLFDyOFH4e4S1HNtNwI="
export ACCT_FILE=$PWD/credentials.yaml.fernet

You are ready to use idem_vmware_alb!

State Example

Example of using avilb state in SLS:

my_state.sls:

ensure_sample_exists:
  avilb.sample.present:
    - name: a_sample_name
    - description: Managed by Idem

Create sample state:

idem state my_state.sls

Delete sample state:

idem state my_state.sls --invert