Skip to main content

HPE Ezmeral Container Platform client

Project description

Build & Test Code Checks Issues Coverage Status Pyversions MIT license Code Style pypi

Gitpod Ready-to-Code Good first issues open semantic-release


See here for User Documentation.




pip3 install -U hpecp

If you encounter an issue installing on Centos 7.7 with Python 2.7 see here for a workaround

CLI examples

You need to create a config file with your endpoint details - note that you can have multiple profiles:

cat > ~/.hpecp.conf <<EOF
api_host =
api_port = 8080
use_ssl = True
verify_ssl = False
warn_ssl = False
username = admin
password = admin123

tenant = /api/v1/tenant/15
admin = ad_admin1
password = pass123

Setup bash autocomplete:

source <(hpecp autocomplete bash)


hpecp TAB

Add gateway:

hpecp lock create "Install Gateway"
hpecp gateway create-with-ssh-key --ip --proxy-node-hostname my.gateway.local --ssh-key-file controller_private.key
hpecp gateway wait-for-state ${GATEWAY_ID} --states [installed] --timeout-secs 1200
hpecp lock delete-all

Add K8s worker host:

hpecp k8sworker create-with-ssh-key \
    --ip \
    --ssh-key-file controller_private.key \
    --persistent-disks /dev/nvme1n1 \
    --ephemeral-disks /dev/nvme2n1 \
    --wait-for-operation-secs 600

K8s versions:

hpecp k8scluster k8s-supported-versions --major-filter 1 --minor-filter 17

Create k8s cluster:

hpecp k8scluster create --name myclus1 --k8shosts-config /api/v2/worker/k8shost/1:master --k8s_version=1.17.0

Get k8s available addons:

hpecp k8scluster get-available-addons --id $CLUSTER_ID

Add k8s cluster addons:

hpecp k8scluster add-addons --id $CLUSTER_ID --addons [istio,harbor]

List with columns parameter:

hpecp k8scluster list --columns [id,description,status]

List with (jmespath) query parameter:

hpecp catalog list --query "[?state!='installed' && state!='installing'] | [*].[_links.self.href] | []"  --output text

List --query examples:

hpecp tenant examples

Tenant create:

TENANT_ID=$(hpecp tenant create --name tenant1 --description "dev tenant" --k8s-cluster-id $CLUSTER_ID  --tenant-type k8s)
hpecp tenant wait-for-status --id $TENANT_ID --status [ready] --timeout-secs 600

Add LDAP role to Tenant:

ADMIN_ROLE=$(hpecp role list  --query "[? == 'Admin'][_links.self.href]" --output text)
hpecp tenant add-external-user-group --tenant-id $TENANT_ID --group $ADMIN_GROUP --role-id $ADMIN_ROLE

Add internal user to Tenant:

ADMIN_USER_ID=$(hpecp user list --query "[? == 'admin'][_links.self.href]" --output text)
ADMIN_ROLE=$(hpecp role list  --query "[? == 'Admin'][_links.self.href]" --output text)
hpecp tenant assign-user-to-role --tenant-id $TENANT_ID --role-id $ADMIN_ROLE --user-id $ADMIN_USER_ID

Tenant kube config:

PROFILE=tenant1 hpecp tenant k8skubeconfig > tenant1_kube.conf

# get available Kubedirector apps
kubectl --kubeconfig tenant1_kube.conf -n t1 get kubedirectorapps

# list running applications
kubectl --kubeconfig tenant1_kube.conf -n t1 describe kubedirectorclusters

Http call:

hpecp httpclient get /some/uri

Use a different config file:

HPECP_CONFIG_FILE=myclus.conf hpecp do-something

Logging with HTTP tracing:

hpecp do-something

More sophisticated CLI examples here

Python Library Examples

See docs:


from hpecp import ContainerPlatformClient

client = ContainerPlatformClient(username='admin',
client.create_session() # Login

# Alternatively:
# client = ContainerPlatformClient.create_from_config_file().create_session()

print(client.k8s_cluster.list(columns=['description', 'id']))

On my environment, this displays:

| description |          id           |
| my cluster  | /api/v2/k8scluster/20 |

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

hpecp-0.22.13.tar.gz (50.6 kB view hashes)

Uploaded source

Built Distribution

hpecp-0.22.13-py3-none-any.whl (87.6 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page