Generic DuploClient for Python apps.
Project description
Duplocloud Py Client
duploctl
is a cli and package to work with a Duplocloud portal. It is a CLI for interacting with Duplocloud resources, such as Tenants, and is designed to work seamlessly within CLI-based CI/CD pipelines. It is a fully extensible package and can be used as both a Python module and a CLI.
Installation
From PyPi:
pip install duplocloud-client
From Homebrew:
brew tap duplocloud/homebrew-tap
brew install duploctl
Usage
Use duploctl
as a CLI or as a standalone Python module called by your custom script.
Configuration
Use the following syntax for these global arguments:
Arg | Env Var | Description | Default | Required |
---|---|---|---|---|
--host, -H | DUPLO_HOST | The host to connect to | Yes | |
--token, -T | DUPLO_TOKEN | The token to use for auth | Yes | |
--tenant, -t | DUPLO_TENANT | The tenant to use for auth | default | No |
CLI
CLI command syntax for invoking duploctl
duploctl <resource> <command> <args...>
Example Usages
Full documentation is in the Wiki section.
Configure duploctl
access with environment variables:
export DUPLO_HOST=https://example.duplocloud.net
export DUPLO_TOKEN=AQAAA...
export DUPLO_TENANT=dev01
List the services in a tenant:
duploctl service list
Register Profile for AWS:
duploctl jit update_aws_config myportal
Open AWS Web Console:
duploctl jit web
Get Kubernetes config:
duploctl jit update_kubeconfig myinfra
Python Module
Spawn your client from a Python script using the DuploClient.from_env()
method and arguments. The second return value are the unparsed arguments from the command line. This example uses the client as a callable using command like syntax.
duplo, args = DuploClient.from_env()
t = duplo("tenant", "find", "mytenant")
print(t)
Spawn a client with a custom host and token from a Python script. This example loads a resource and runs a method manually.
duplo = DuploClient.from_creds(host="https://example.duplocloud.net", token="mytoken")
tenants = duplo.load("tenant")
t = tenants.find("mytenant")
print(t)
Project details
Release 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
Hashes for duplocloud_client-0.2.12-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ad5e7146ffbedbcf0bcb0396a200d1b097cc4d8ef3f82c671a1c5cfb14033f5a |
|
MD5 | 39a8fb0e7c057fea1286d82f20cd5ddf |
|
BLAKE2b-256 | 9e578cc140d1a1859aff12af5e6e13b084d4afa0f2557cb4f37d4bc52c614ad9 |