https://github.com/loafoe/nomad-driver-ch
Experimental Nomad Container Host driver plugin
https://github.com/loafoe/nomad-driver-ch
container-host hashicorp-nomad hsdp nomad nomad-task-driver
Last synced: 5 months ago
JSON representation
Experimental Nomad Container Host driver plugin
- Host: GitHub
- URL: https://github.com/loafoe/nomad-driver-ch
- Owner: loafoe
- License: other
- Archived: true
- Created: 2021-11-06T16:21:44.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2023-09-02T10:46:42.000Z (almost 3 years ago)
- Last Synced: 2025-11-18T12:11:29.132Z (7 months ago)
- Topics: container-host, hashicorp-nomad, hsdp, nomad, nomad-task-driver
- Language: Go
- Homepage:
- Size: 633 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Nomad Container Host (ch) Driver Plugin
This is a [Nomad](https://www.nomadproject.io) Driver plugin that allows
[HSDP Container Host](https://registry.terraform.io/providers/philips-software/hsdp/latest/docs/guides/container_host) instances to function as Nomad client nodes.
The initial focus is on getting things working on a single client.
Once this is stable we will expand the scope of the project to cluster
setups and possibly enabling auto scaling features.
The primary goal of this project is to build knowledge of Nomad and its
internals and to validate Nomad as a possible alternative to Kubernetes
which is much more complex and heavy weight.
## Limitations and aspirations
The current Container Host architecture rules out any sort of multi-tenancy
capability of the Nomad cluster so any deployment using this driver
is effectively single tenant today. This is fine as there is very little overhead.
Customers can theoretically spin up dozens of clusters side by side.
Even though the driver is Container Host specific, any knowledge we gain should be
applicable to any future hardened environment. Potentially, it can also be
an interesting platform for on-premise or hybrid deployments.
# Requirements
- [Nomad](https://www.nomadproject.io/downloads.html) v1.1+
- [Go](https://golang.org/doc/install) v1.17 or later (to build the plugin)
# Building the Plugin
Clone the repository somewhere in your computer. This project uses
[Go modules](https://blog.golang.org/using-go-modules) so you will need to set
the environment variable `GO111MODULE=on` or work outside your `GOPATH` if it
is set to `auto` or not declared.
```sh
$ git clone https://github.com/loafoe/nomad-driver-ch
```
Enter the plugin directory.
Build the plugin.
```sh
$ go build .
```
## Deploying Driver Plugins in Nomad
```sh
$ nomad agent -dev -config=./example/agent.hcl -plugin-dir=$(pwd)
# in another shell
$ nomad run ./example/example.nomad
$ nomad logs
```
## License
Apache 2.0