Client library for Hashicorp Nomad
Reason this release was yanked:
breaks python2.7
Project description
python-nomad
Branch | Status | Coverage |
---|---|---|
master |
Installation
pip install python-nomad
Documentation
https://python-nomad.readthedocs.io/en/latest/
Examples
import nomad
# For HTTP Nomad instances
n = nomad.Nomad(host="172.16.100.10", timeout=5)
# For HTTPS Nomad instances with non-self-signed SSL certificates
n = nomad.Nomad(host="172.16.100.10", secure=True, timeout=5, verify=True)
# For HTTPS Nomad instances with self-signed SSL certificates and no validate the cert
n = nomad.Nomad(host="172.16.100.10", secure=True, timeout=5, verify=False)
# For HTTPS Nomad instances with self-signed SSL certificates that must validate with cert
n = nomad.Nomad(host="172.16.100.10", secure=True, timeout=5, verify=True, cert="/path/to/certfile") # See http://docs.python-requests.org/en/master/user/advanced/#ssl-cert-verification
# For HTTPS Nomad instances with cert file and key
n = nomad.Nomad(host="https://172.16.100.10", secure=True, timeout=5, verify=True, cert=("/path/to/certfile", "/path/to/key")) # See http://docs.python-requests.org/en/master/user/advanced/#ssl-cert-verification
# For HTTPS Nomad instances with namespace and acl token
n = nomad.Nomad(host="172.16.100.10", secure=True, timeout=5, verify=False, namespace='Namespace-example',token='3f4a0fcd-7c42-773c-25db-2d31ba0c05fe')
"example" in n.jobs
j = n.jobs["example"]["ID"]
example_allocation = n.job.get_allocations(j)
n.job.deregister_job(j)
Environment Variables
This library also supports environment variables: NOMAD_ADDR
, NOMAD_NAMESPACE
, NOMAD_TOKEN
, NOMAD_REGION
, NOMAD_CLIENT_CERT
, and NOMAD_CLIENT_KEY
for ease of configuration and unifying with nomad cli tools and other libraries.
NOMAD_ADDR=http://127.0.0.1:4646
NOMAD_NAMESPACE=default
NOMAD_TOKEN=xxxx-xxxx-xxxx-xxxx
NOMAD_REGION=us-east-1a
NOMAD_CLIENT_CERT=/path/to/tls/client.crt
NOMAD_CLIENT_KEY=/path/to/tls/client.key
Class Dunders
Class | contains | len | getitem | iter |
---|---|---|---|---|
agent | N | N | N | N |
allocation | Y | N | Y | N |
allocations | N | Y | N | Y |
client | N | N | N | N |
evaluation | Y | N | Y | N |
evaluations | Y | Y | Y | Y |
event | N | N | N | N |
job | Y | N | Y | N |
jobs | Y | Y | Y | Y |
node | Y | N | Y | N |
nodes | Y | Y | Y | Y |
regions | Y | Y | Y | Y |
status.leader | Y | Y | N | N |
status.peers | Y | Y | Y | Y |
system | N | N | N | N |
validate | N | N | N | N |
deployments | Y | Y | Y | Y |
deployment | Y | N | Y | N |
namespace | Y | N | Y | N |
namespaces | Y | Y | Y | Y |
acl | Y | N | Y | N |
sentinel | Y | N | Y | N |
Development
- create virtualenv and activate
- install requirements-dev.txt
- can either use the Vagrantfile for local integration testing or create environment variables
NOMAD_IP
andNOMAD_PORT
that are assigned to a nomad binary that is running
virutalenv venv
source venv/bin/activate
pip install -r requirements-dev.txt
Testing with vagrant and virtualbox
vagrant up --provider virtualbox
py.test --cov=nomad --cov-report=term-missing --runxfail tests/
Testing with nomad binary
./nomad agent -dev -node pynomad1 --acl-enabled
NOMAD_IP=127.0.0.1 NOMAD_VERSION=<SEMNATIC_VERSION> py.test --cov=nomad --cov-report=term-missing --runxfail tests/
- Examples
- Acl :link:
- Agent :link:
- Allocation :link:
- Allocations :link:
- Deployment :link:
- Deployments :link:
- Client :link:
- Evaluation :link:
- Evaluations :link:
- Event :link:
- Job :link:
- Jobs :link:
- Namespace :link:
- Namespaces :link:
- Node :link:
- Nodes :link:
- Regions :link:
- Sentinel :link:
- Status :link:
- System :link:
- Validate :link:
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
python-nomad-1.4.0.tar.gz
(19.0 kB
view details)
Built Distribution
File details
Details for the file python-nomad-1.4.0.tar.gz
.
File metadata
- Download URL: python-nomad-1.4.0.tar.gz
- Upload date:
- Size: 19.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.2 CPython/3.8.1
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8e9061e7e031042f19efe79a7998d0877a061af6551b8196382219dbbe8d1526 |
|
MD5 | 9b4188280329ddaeb1e9e8f1e7e9ab0b |
|
BLAKE2b-256 | 94a676afbb3918b4a53ec754753ceb4a80164549c3d7f0c8130b3d36fd2f21e6 |
File details
Details for the file python_nomad-1.4.0-py3-none-any.whl
.
File metadata
- Download URL: python_nomad-1.4.0-py3-none-any.whl
- Upload date:
- Size: 30.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.2 CPython/3.8.1
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | afaafae0c888e6835d55a4d97563533b90a28783e2ed15d1938e111f5e6210b3 |
|
MD5 | 5de593a97731ce7409dca9e378110b9f |
|
BLAKE2b-256 | c2a51bed8ae66a936331ab0c27aa9a11f5815527f96b3b2970ea9dd91043191b |