Skip to main content

client tool for a chacra service

Project description

chacractl

A client interface to interact with the chacra service (http://github.com/ceph/chacra).

configuration

The client writes a configuration file at $HOME/.chacractl with some needed information:

# This file was automatically generated by the chacractl CLI
# make sure to update it with the correct user and key to talk to the API

url = "http://example/"
user = "admin"
key = "secret"
ssl_verify = True

These values need to be modified so that the CLI can interact with the remote API.

binaries

The CLI allows for a few interactions with binaries, depending on the action needed the requirements may change. For example when trying to upload a binary, the tool can accept either stdin or an actual file input.

create

For POSTing a binary, if posting a single binary it is best to just pass the full path as the last argument to the binary subcommand:

chacractl binary create project/ref/distro/distro-version/arch /path/to/binary.rpm

But for convenience, if sending many files, it can also accept them from stdin, usually with the output of a find command that can be filtered with grep or similar.

Below is an example of such a command for a project like ceph-deploy:

find ~/repos | grep ceph-deploy | grep rpm | grep noarch | grep el6
| chacractl binary create ceph-deploy/master/centos/6/noarch

If a binary already exists and there is a need to re-upload it, the --force flag must be used. In that case the request will be a PUT and the resource will be overwritten in the API.

exists

Check whether a given url endpoint exists or not. This subcommand requires the full url part (as opposed to other subcommands that require the url starting from the project name):

chacractl exists repos/ceph-deploy/master/centos/7

If the endpoint is not found it will return a non-zero exit status

repos

Repositories can be updated or fully re-created. This is useful when the API changes and the repository creation wasn’t triggered.

recreate

A recreate call will fully remove a repository on disc and will instruct the API to queue a repo creation. These actions are not immediate: the removal of the repository will happen as soon as the request is processed and the repository creation will be done when the queue does the job (possibly after a configured timeout)

A simple call would look like:

chacractl repo recreate ceph/infernalis/debian/jessie

Note how the full path to the distribution version is needed.

update

Similar to recreate, but it will not remove the actual repository on disc before queuing the request. It is useful when a binary has been added and the client wants to ensure it is added to the repo:

chacractl repo update ceph/infernalis/debian/jessie

set-raw

Repos have a “type” inferred from the binaries they contain; if rpms are uploaded, the repo will be created as an rpm repo; if debs, a Debian repo will result. ‘Raw’ repos are simple containers for binaries that need no further processing into repositories, such as .zip files or other binary products that will be simply downloaded. For such repos, use set-raw to set the type of the repo so that no asynchronous repo construction is requested.

chacractl repo set-raw ceph/infernalis/windows/1809

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

chacractl-0.0.25.tar.gz (14.0 kB view details)

Uploaded Source

Built Distribution

chacractl-0.0.25-py3-none-any.whl (16.8 kB view details)

Uploaded Python 3

File details

Details for the file chacractl-0.0.25.tar.gz.

File metadata

  • Download URL: chacractl-0.0.25.tar.gz
  • Upload date:
  • Size: 14.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.3

File hashes

Hashes for chacractl-0.0.25.tar.gz
Algorithm Hash digest
SHA256 9791e94bd28ea6ba54dfaa067418ddbca57e7e33b4c497f48131f979441a1c2f
MD5 243afeec78b7fe908b8ea59fa43a5edd
BLAKE2b-256 bd0e7222169dd68a9dd9d2a30ade3eb632e17e5135712110d9d2d11d289b3a45

See more details on using hashes here.

File details

Details for the file chacractl-0.0.25-py3-none-any.whl.

File metadata

  • Download URL: chacractl-0.0.25-py3-none-any.whl
  • Upload date:
  • Size: 16.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.3

File hashes

Hashes for chacractl-0.0.25-py3-none-any.whl
Algorithm Hash digest
SHA256 d77dd6dbceaebbdaae5816dd298243e390d6c60a96e248189dc79601cd5fe7f8
MD5 e418be58d23a0b68ee0105f44e489cc6
BLAKE2b-256 0a46691961479cbaba298087584d6bb44ec2178534123371565bacf0fc4a944c

See more details on using hashes here.

Supported by

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