Octahe allows you to simplify operations, create concise applications, and focus on what you do best.
Octahe is a deployment tool which uses the Containerfile as DSL for deploying software via SSH, Local or Serial connections.
The Containerfile DSL is simple, only consisting of 16 different verbs. This means solutions run through Octahe are inherently easy to understand and test.
With Octahe, deployers and operators can test solutions in Containers and easily push to Baremetal, Virtual machines, or even containerized targets; all without having to change configurations formats.
Octahe has the ability to natively proxy through multiple targets using sockets. This capability allows deployers to flatten their approach to deployments, all without needing to compromise infrastructure or craft obscure deployment schemes.
Multi-key, multi-bastion, multi-user, multi-server, multi-target deployments all made simple.
Octahe uses simple multi-processing which leverages native swift queues of Operations. This built-in abstraction provides Octahe the ability to ensure consistent deployments across multiple hosts, using complex dependencies, all without troubling the user. From 1 machine to 1000, Octahe will get a solution deployed quickly and consistently, without compromise.
The ability to develop in containers, the power to push high performance solutions down to metal.
Whether you're deploying software to the cloud, building high-performance computing environments, or IOT applications, Octahe has it covered. The Zero footprint design employed by Octahe will get you up and running in as little as one step.
While containers are fantastic tools, they can be limiting, they can create application complexities, and they do create bottlenecks. Octahe aims to enable teams to deploy applications into stateful Targets, using the simplicity of Containerfile(s), without any of the machinery that comes alone with containers.
The Octahe follows the Dockerfile reference with one new verb, TO. This new verb can be expressed on the CLI or within a provided container file.
When deploying TO a target Octahe provides options by supporting
options that span SSH, localhost, and Serial.
Building Octahe is simple, however, if you already have swift-lang installed on your system, you can simply skip this part and download one of the prebuild binaries from the releases.
In order to build Octahe on macOS you will need OSX 10.15 or better. You will also need XCode installed and updated to the latest stable release.
Install EPEL.
dnf -y install epel-release openssl-develInstall swift-lang.
dnf -y install swift-langWith swift 5.2+ installed, simply clone this repository, change directory to the checkout, and run the following command.
swift build \
--configuration release \
--jobs 4 \
-Xswiftc \
-gOnce complete, the application will be built, and available in the release build location,
.build/release/octahe. To make Octahe available system wide, copy it into a ${PATH}
directory, useually something like /usr/local/bin.
Octahe can also be deployed using container native tooling, such as podman or docker.
podman build -t octahe.HEAD -f .buildcontainer/ContainerfileOnce the container image has been created, you can build applications around Octahe or run commands through the default container image runtime.
podman run -it localhost/octahe.HEAD octaheBecause Octahe can read Containerfiles and deploy applications to targets, Octahe can be used
to deploy itself using the provided in tree Containerfile. Assuming Octahe is installed on
the local machine the following command can be used to deploy the application to remote hosts.
octahe -k ~/.ssh/id_rsa -t ${USER}@${SERVER}:22 -k ~/.ssh/id_rsa ContainerfileA Containerfile has been provided which exercises functional tests for Octahe.
# Deploy
octahe -k ~/.ssh/id_rsa -t ${USER}@${SERVER}:22 .testcontainer/Targetfile.local
# Undeploy
octahe undeploy -k ~/.ssh/id_rsa -t ${USER}@${SERVER}:22 .testcontainer/Targetfile.localThe CLI interactions are familiar and simple.
octahe -k ~/.ssh/id_rsa ~/TargetfileThe console output is simple, and easy to follow.
Beginning deployment execution
✔ Step 0/3 : COPY index.html /opt/index.html
✔ Step 1/3 : EXPOSE 7000
✔ Step 2/3 : WORKDIR /opt
✔ Step 3/3 : ENTRYPOINT python3 -m http.server 7000Here's the application being deployed to 5 remote Targets in realtime.
Checkout the demo repo, highlighting how Octahe can be used in a more real world situation.
More documentation and examples can be found here.