No project description provided
Project description
First, install pop-create-idem this is an extension of pop-create that is designed to easily create boilerplate code for idem-cloud projects.
pip3 install pop-create-idemYou now have access to the pop-create command with the idem-cloud subcommand.
To create a new idem-cloud project, run:
pop-create idem-cloud --directory /path/to/new/project --project-name=idem-{my_cloud} --simple-cloud-name={my_cloud}A new project will have been created with all the boilerplate code needed to get started with idem-cloud: The directory tree should now look something like this:
.
├── build.conf
├── cicd
│ └── upload-code-coverage.sh
├── {project_name}
│ ├── acct
│ │ ├── contracts
│ │ └── {simple_cloud_name}
│ │ └── basic_auth.py
│ ├── conf.py
│ ├── exec
│ │ ├── contracts
│ │ └── {simple_cloud_name}
│ │ └── init.py
│ ├── states
│ │ ├── contracts
│ │ └── {simple_cloud_name}
│ │ └── init.py
│ ├── tool
│ │ └── contracts
│ └── version.py
├── LICENSE
├── noxfile.py
├── README.rst
├── requirements
│ ├── base.txt
│ └── tests.in
├── setup.py
└── tests
├── __init__.py
├── integration
│ ├── acct
│ ├── conftest.py
│ ├── exec
│ ├── __init__.py
│ ├── states
│ └── tool
└── unit
├── acct
├── conftest.py
├── exec
├── __init__.py
├── states
└── tool
Installation
Install your new project with pip, it needs to be added to the python environment.
pip install -e {project_root}After installation the new Idem Cloud Provider execution and state modules will be accessible to the pop hub.
You can verify with pop-tree
pip install pop-tree
# Show the exec modules that properly app-merged onto the hub
pop-tree exec --add-sub idemoutput:
exec:
----------
{simple_cloud_name}:
----------
init:
|_
|_
test:
|_
- ctx
- ping
|_
Authenticating with idem-cloud
Edit the file at {project_name}/acct/{simple_cloud_name}/basic_auth.py This is where you can customize authentication to your cloud. You can create other plugins in this directory that authenticate in different ways to the same cloud.
After installing idem with pip, acct, exe 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 credentials. The default profile will be used automatically by idem unless you specify one with –acct-profile=profile_name on the idem cli.
There are many ways providers/profiles can be stored. See acct backends for more information.
credentials.yaml
{simple_cloud_name}.basic_auth:
default:
username: my_user
password: my_passNow encrypt the credentials file and add the encryption key and encrypted file path to the ENVIRONMENT.
The acct command should be available as it is a requisite of idem. Encrypt the the credential file.
acct encrypt credentials.yamloutput:
-A9ZkiCSOjWYG_lbGmmkVh4jKLFDyOFH4e4S1HNtNwI=
Add these to your environment:
export ACCT_KEY="-A9ZkiCSOjWYG_lbGmmkVh4jKLFDyOFH4e4S1HNtNwI="
export ACCT_FILE=$PWD/credentials.yaml.fernetIdem will now be able to read these credentials for authentication to your cloud!
Exec modules
functions placed in {project_name}/exec/{simple_cloud_name}/ will appear on the hub under. hub.exec.{simple_cloud_name}.*. The directory structure under exec is arbitrary to idem, so use it to keep your functions organized. Do NOT put all your functions in one giant file. That is not very pop.
The directory structure affects where functions are placed on the hub, and how they are referenced on the CLI.
If you create a function called get in {project_name}/exec/{simple_cloud_name}/instance, it can be called from the hub within code like so:
hub.exec.simple_cloud_name.instance.get("instance_name")It could be called from the idem cli like this:
idem exec {simple_cloud_name}.instance.get instance_nameThe profile you want to use from your encrypted credentials file can be specified on the command line when calling an exec module directly. The default is to use the profile named “default”.
idem exec --acct-profile my-staging-env {simple_cloud_name}.instance.listStates
A profile can be specified for use with a specific state. If no profile is specified, the profile called “default”, if one exists, will be used:
ensure_user_exists:
{simple_cloud_name}.user.present:
- acct_profile: my-staging-env
- name: a_user_name
- kwarg1: val1It can also be specified from the command line when executing states.
idem state --acct-profile my-staging-env my_state.slsRelease history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file pop-create-idem-0.2.tar.gz.
File metadata
- Download URL: pop-create-idem-0.2.tar.gz
- Upload date:
- Size: 14.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.4.1 importlib_metadata/3.7.3 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.9.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | de061ca36ed1939c4a40af23cb3580258b3243731497664e07837db2e04bc432 |
|
| MD5 | f91148ee69e5c30f769b2613734232c5 |
|
| BLAKE2b-256 | 353b48e7ab400b4909e4bdce844f2649e81631f579995ff08af04f408572310e |
File details
Details for the file pop_create_idem-0.2-py3-none-any.whl.
File metadata
- Download URL: pop_create_idem-0.2-py3-none-any.whl
- Upload date:
- Size: 10.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.4.1 importlib_metadata/3.7.3 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.9.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | ee8d31814a4233ac66150487016ea8c45c0c5ce1926f0c837044eb043ef32244 |
|
| MD5 | cd61046898b2d28dd651c0dd9efb0bb1 |
|
| BLAKE2b-256 | f0388fad07675780f86cc26104355fb847f9af404f831f7703ae99f6d77388c0 |
