This is a work in progress. Consider everything liable to change at any time.
Spire is a single executable binary you can use to provision and configure remote Unix systems. It runs a Clojure domain specific language that is:
$ curl -O https://raw.githubusercontent.com/epiccastle/spire/master/scripts/install $ bash install $ spire -e '(ssh "localhost" (get-fact))'
For Linux and MacOS:
$ curl -O https://raw.githubusercontent.com/epiccastle/spire/master/scripts/install $ bash install
Run a spire script from a file:
$ spire FILE
Evaluate spire expression on the command line:
$ spire -e EXPRESSION
Start a spire nREPL:
$ spire --nrepl-server PORT
You can find the source code to Spire on github here.
Install graalvm-ce-java11-20.1.0-dev in your home directory. Add the native image bundle to it. Then:
$ make clean all
Or specify a path to the graal directory to build with a different graal:
$ make clean all GRAALVM=/path/to/my/graal
After a long wait it should write a binary executable
spire. Test it.
$ ./spire --help
$ mv spire ~/bin/ $ spire --help
Note: graalvm-ce-java8-20.1.0-dev should also work. Earlier versions of graalvm, up to and including 20.0.0 do not work.
$ make jar $ java -jar spire-0.1.0-standalone.jar FILE
Use trampoline to run with leiningen so libspire.so can read the correct terminal settings:
$ lein trampoline run -- --help
The test suite consists of some unit tests and some module tests that issue a full ssh connection to
localhost. These tests will test both the ssh functionality and module functionality just on the running OS. By running this test suite on different architectures, compatability of the modules can be ascertained. The lack of external connections in the test makes setting up test environments easier.
$ lein test
This is the binary spire program you run on your local machine.
This is the operating systems you will be provisioning, that the spire modules and operations will work against.
There will be many bugs at this early stage. Especially on different target machines. Please open tickets for any issues you find.
Copyright © 2019-2020 Crispin Wellington
This program and the accompanying materials are made available under the terms of the Eclipse Public License 2.0 which is available at http://www.eclipse.org/legal/epl-2.0.
This Source Code may also be made available under the following Secondary Licenses when the conditions for such availability set forth in the Eclipse Public License, v. 2.0 are satisfied: GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version, with the GNU Classpath Exception which is available at https://www.gnu.org/software/classpath/license.html.