Connecting Idem to providers#

To connect Idem to cloud endpoints such as Amazon Web Services (AWS) or Microsoft Azure, install the cloud plug-in for the endpoint.

About plug-ins#

Idem plug-ins aren’t only for public cloud providers such as AWS, Azure, or Google Cloud. Idem can interface with anything that has an API. For example, you might use Idem to describe and enforce a configuration on a site such as GitLab.

As an alternative to direct installation, some users choose to create and run a container image bundle that includes Idem and a selected plug-in. A container can help work around any system dependency issues.

The rest of this section describes two plug-in examples: AWS and Microsoft Azure. Like Idem itself, plug-ins are hosted on pypi.org and are installable with PIP.

Prerequisites#

Installing the AWS plug-in#

The AWS plug-in requires Python 3.7 or later, and Idem 17.0.1 or later. To install the AWS plug-in, follow these steps.

  1. Use PIP to install the plug-in.

    pip install idem-aws
    

    Alternatively, install a specific plug-in version.

    pip install idem-aws==0.34.0
    
  2. Verify installation.

    pip list | grep idem-aws
    
  3. Verify details such as version and required dependencies.

    pip show idem-aws
    

Supported AWS resources#

Idem manages AWS resources as listed in the idem-aws open source documentation.

Installing the Azure plug-in#

The Microsoft Azure plug-in requires Python 3.7 or later, and Idem 16.0.0 or later. To install the Azure plugin, follow these steps.

  1. Use PIP to install the plug-in.

    pip install idem-azure-auto
    

    Alternatively, install a specific plug-in version.

    pip install idem-azure-auto==0.0.3
    
  2. Verify installation.

    pip list | grep idem-azure-auto
    
  3. Verify details such as version and required dependencies.

    pip show idem-azure-auto
    

Supported Azure resources#

Idem manages Azure resources as listed in the idem-azure-auto open source documentation.

What to do next#

Give Idem the credentials to log in to infrastructure. See Authenticating Idem with providers.