Skip to main content

A deployment framework built to manage the data center life cycle.

Project description

Directord

A deployment framework built to manage the data center life cycle.

Task driven deployment, simplified, directed by you.

Directord is an asynchronous deployment and operations platform with the aim to better enable simplicity, faster time to delivery, and consistency.

Design Principles

The Directord design principles can be found here.

Documentation

Additional documentation covering everything from application design, wire diagrams, installation, usage, and more can all be found here.

Welcome Contributors

  • Read documentation on how best to deploy and leverage directord.

  • When ready, if you'd like to contribute to Directord pull-requests are very welcomed. Directord is an open platform built for operators. If you see something broken, please feel free to raise a but and/or fix it.

  • Information on running tests can be found here.

Have Questions?

Join us on libera.chat at #directord. The community is just getting started: folks are here to help, answer questions, and support one another.

Quick Introduction

This quick cast shows how easy it is to install, bootstrap, and deploy a scale test environment.

asciicast

Hello World

Let's create a virtual env on your local machine to bootstrap the installation, once installed you can move to the server node and call all your tasks from there

python3 -m venv --system-site-packages ~/directord
~/directord/bin/pip install --upgrade pip setuptools wheel
~/directord/bin/pip install directord

We need to create a catalog for bootstrapping. Let's assume we are installing directord in two machines:

test1 192.168.1.100 : dicectord server, a client test2 192.168.1.101 : Only a client

for that we create a file

vi ~/directord-catalog.yaml

with the contents:

directord_server:
  targets:
  - host: 192.168.1.100
    port: 22
    username: fedora

directord_clients:
  args:
    port: 22
    username: fedora
  targets:
  - host: 192.168.1.100
  - host: 192.168.1.101

We can now call directord to bootstrap the installation. Bootstrapping uses ssh to connect to the machines but after that ssh is no longer used. and you only need the ssh keys to connect your local machine to the machines you are installing into the server and client do not need shared keys between themselves.

To kickstart the bootstrapping you call directord with the catalog file you created and a catalog with the jobs required to bootstrap them.

~/directord/bin/directord bootstrap \
--catalog ~/directord-catalog.yaml  \
--catalog ~/directord/share/directord/tools/directord-prod-bootstrap-catalog.yaml

Once that is ran you can now ssh to the server and issue all the commands from there

ssh fedora@192.168.1.100

First to make sure all the nodes are connected

sudo /opt/directord/bin/directord manage --list-nodes

Should show you:

ID           EXPIRY  VERSION    UPTIME
---------  --------  ---------  --------------
test1        170.43  0.6.0      1:37:35.330000
test2        127.36  0.6.0      1:35:25.830000

Then we create our first orchestration job lets add a file called

vi helloworld.yaml

with the contents:

- jobs:
  - RUN: echo hello world

Then we call the orchestration to use it

sudo /opt/directord/bin/directord orchestrate helloworld.yaml

Should return something like:

Job received. Task ID: 9bcf31cb-7faf-4367-bf37-57c11b3f81dc

We use that task ID to probe how the job went or we can list all the jobs with"

sudo /opt/directord/bin/directord manage --list-jobs

That returns something like:

ID                                    PARENT_JOB_ID                           EXECUTION_TIME    SUCCESS    FAILED
------------------------------------  ------------------------------------  ----------------  ---------  --------
9bcf31cb-7faf-4367-bf37-57c11b3f81dc  9bcf31cb-7faf-4367-bf37-57c11b3f81dc              0.02          2         0

with the task id we can see how the job went:

sudo /opt/directord/bin/directord manage --job-info 9bcf31cb-7faf-4367-bf37-57c11b3f81dc

And voila here is our first orchestrated hello world:

KEY                   VALUE
--------------------  -------------------------------------------------------
ID                    9bcf31cb-7faf-4367-bf37-57c11b3f81dc
ACCEPTED              True
INFO                  test1 = echo hello world
                      test2 = echo hello world
STDOUT                test1 = hello world
                      test2 = hello world
...

License

Apache License Version 2.0 COPY

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

directord-0.9.0a20210831200730.tar.gz (1.4 MB view details)

Uploaded Source

Built Distribution

directord-0.9.0a20210831200730-py3-none-any.whl (1.5 MB view details)

Uploaded Python 3

File details

Details for the file directord-0.9.0a20210831200730.tar.gz.

File metadata

  • Download URL: directord-0.9.0a20210831200730.tar.gz
  • Upload date:
  • Size: 1.4 MB
  • 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.9.6

File hashes

Hashes for directord-0.9.0a20210831200730.tar.gz
Algorithm Hash digest
SHA256 b67629b5da26ebaf8ac8cbcc4b7256d80aea9c05a217088914fa5044fbb886f3
MD5 c806c934bc3920a219494eb78d2bb550
BLAKE2b-256 ce9c5b15993b4d018e0c09903a92167317a04ea711febcf0a0eaaf48ead8de96

See more details on using hashes here.

File details

Details for the file directord-0.9.0a20210831200730-py3-none-any.whl.

File metadata

  • Download URL: directord-0.9.0a20210831200730-py3-none-any.whl
  • Upload date:
  • Size: 1.5 MB
  • 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.9.6

File hashes

Hashes for directord-0.9.0a20210831200730-py3-none-any.whl
Algorithm Hash digest
SHA256 5ad035ed0c52aed8fcb5ccd3b96293c101da261a77b4c9e52dd2fdb853f22874
MD5 be6c8e9e7779c12a863702156f59dd96
BLAKE2b-256 32103940447fa30b1d1f799d528038297d695a3e18d264a34502916c1792ba49

See more details on using hashes here.

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