Metadata-Version: 2.1
Name: idem-vultr
Version: 1.5
Summary: States and execution modules for the vultr cloud provider
Home-page: https://gitlab.com/saltstack/pop/idem-vultr
Author: Tyler Johnson
Author-email: tjohnson@saltstack.com
License: UNKNOWN
Description: ==========
        IDEM_VULTR
        ==========
        Vultr Cloud Provider for Idem
        
        ============
        INSTALLATION
        ============
        
        The vultr idem provider can be installed via pip:
        `pip install idem-vultr`
        
        ============================
        INSTALLATION FOR DEVELOPMENT
        ============================
        
        1. Clone the `idem_provider_vultr` repository and install with pip:
        `pip install -r requirements.txt`
        2. Run `pip install -e <path to provider>` from your project's root directory
        
        You are now fully set up to begin developing additional functionality for this provider.
        
        =========
        EXECUTION
        =========
        
        After installation the Vultr Idem Provider execution and state modules will be accessible to the hub.
        
        To authenticate, first create a profile set up like so::
        
            vultr:
                default:
                    api_key: XXXXXXXXXXXXXXXXXXXX
                    location: New Jersey
        
        encrypt this file using the `acct` plugin::
        
            acct acct_profile.yml
        
        It will create a file called acct_profile.yml.fernet and give you a key for decrypting it.
        Put these in the appropriate environment variables::
        
            export ACCT_FILE="vultr.yml.fernet"
            export ACCT_key="gAAAAAAbjlkjsdkj_lkjlkfsjoj023h_jiosajdf="
        
        You can now safely delete the plaintext file containing your api key.
        idem knows how to get the credentials it needs.
        
        The following example uses an vultr state module to ensure the existence of a resource group::
        
            VM exists:
              vultr.server.vm.present:
                - name: instance_name
                - vps_plan: 16384 MB RAM,320 GB SSD,5.00 TB BW
                - os: Ubuntu 20.04 x64
        
        Use the command line to run vultr specific execution modules::
        
            idem exec vultr.list full=True
        
Platform: UNKNOWN
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Development Status :: 5 - Production/Stable
Requires-Python: >=3.6
Description-Content-Type: text/x-rst
