Documentation
See here for User Documentation.
Contributing
See:
Installation
pip3 install -U hpecpIf 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
[default]
api_host = 127.0.0.1
api_port = 8080
use_ssl = True
verify_ssl = False
warn_ssl = False
username = admin
password = admin123
[tenant1]
tenant = /api/v1/tenant/15
admin = ad_admin1
password = pass123
EOFSetup bash autocomplete:
source <(hpecp autocomplete bash)Autocompletion:
hpecp TABAdd gateway:
hpecp lock create "Install Gateway"
hpecp gateway create-with-ssh-key --ip 10.1.0.5 --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-allAdd K8s worker host:
hpecp k8sworker create-with-ssh-key \
--ip 10.1.0.10 \
--ssh-key-file controller_private.key \
--persistent-disks /dev/nvme1n1 \
--ephemeral-disks /dev/nvme2n1 \
--wait-for-operation-secs 600K8s versions:
hpecp k8scluster k8s-supported-versions --major-filter 1 --minor-filter 17Create k8s cluster:
hpecp k8scluster create --name myclus1 --k8shosts-config /api/v2/worker/k8shost/1:master --k8s_version=1.17.0Get k8s available addons:
hpecp k8scluster get-available-addons --id $CLUSTER_IDAdd 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 textList --query examples:
hpecp tenant examplesTenant 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 600Add LDAP role to Tenant:
ADMIN_GROUP="CN=DemoTenantAdmins,CN=Users,DC=samdom,DC=example,DC=com"
ADMIN_ROLE=$(hpecp role list --query "[?label.name == 'Admin'][_links.self.href]" --output text)
hpecp tenant add-external-user-group --tenant-id $TENANT_ID --group $ADMIN_GROUP --role-id $ADMIN_ROLEAdd internal user to Tenant:
ADMIN_USER_ID=$(hpecp user list --query "[?label.name == 'admin'][_links.self.href]" --output text)
ADMIN_ROLE=$(hpecp role list --query "[?label.name == 'Admin'][_links.self.href]" --output text)
hpecp tenant assign-user-to-role --tenant-id $TENANT_ID --role-id $ADMIN_ROLE --user-id $ADMIN_USER_IDTenant 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 kubedirectorclustersHttp call:
hpecp httpclient get /some/uriUse a different config file:
HPECP_CONFIG_FILE=myclus.conf hpecp do-somethingLogging with HTTP tracing:
export LOG_LEVEL=DEBUG
hpecp do-somethingMore sophisticated CLI examples here
Python Library Examples
See docs: https://hpe-container-platform-community.github.io/hpecp-python-library/index.html
Example:
from hpecp import ContainerPlatformClient
client = ContainerPlatformClient(username='admin',
password='admin123',
api_host='127.0.0.1',
api_port=8080,
use_ssl=True,
verify_ssl='/certs/hpecp-ca-cert.pem')
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 |
+-------------+-----------------------+