aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAlex Auvolat <alex@adnab.me>2022-11-29 13:19:08 +0100
committerAlex Auvolat <alex@adnab.me>2022-11-29 13:19:08 +0100
commit0b203bf9f166436f7644cd3f9aa635011f5bdb97 (patch)
tree01ca1b6ce5e790b75b370578201260742175309e
parent2a8db433c2eb7fd96b27d6d3393b632dce9f44b0 (diff)
downloadnomad-driver-nix2-0b203bf9f166436f7644cd3f9aa635011f5bdb97.tar.gz
nomad-driver-nix2-0b203bf9f166436f7644cd3f9aa635011f5bdb97.zip
Write README
-rw-r--r--README.md74
1 files changed, 11 insertions, 63 deletions
diff --git a/README.md b/README.md
index 6fbdf8c..5e99834 100644
--- a/README.md
+++ b/README.md
@@ -1,14 +1,9 @@
-Nomad Skeleton Driver Plugin
+Nomad Nix Driver Plugin
==========
-Skeleton project for
-[Nomad task driver plugins](https://www.nomadproject.io/docs/drivers/index.html).
-
-This project is intended for bootstrapping development of a new task driver
-plugin.
-
-- Website: [https://www.nomadproject.io](https://www.nomadproject.io)
-- Mailing list: [Google Groups](http://groups.google.com/group/nomad-tool)
+A Nomad driver to run Nix jobs.
+Uses the same isolation mechanism as the `exec` driver.
+Partially based on [`nomad-driver-nix`](https://github.com/input-output-hk/nomad-driver-nix)
Requirements
-------------------
@@ -16,69 +11,22 @@ Requirements
- [Go](https://golang.org/doc/install) v1.18 or later (to compile the plugin)
- [Nomad](https://www.nomadproject.io/downloads.html) v0.9+ (to run the plugin)
-Building the Skeleton Plugin
+Building and using the Nix driver plugin
-------------------
-[Generate](https://github.com/hashicorp/nomad-skeleton-driver-plugin/generate)
-a new repository in your account from this template by clicking the `Use this
-template` button above.
-
-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 git@github.com:<ORG>/<REPO>git
-```
-
-Enter the plugin directory and update the paths in `go.mod` and `main.go` to
-match your repository path.
-
-```diff
-// go.mod
-
-- module github.com/hashicorp/nomad-skeleton-driver-plugin
-+ module github.com/<ORG>/<REPO>
-...
-```
-
-```diff
-// main.go
-
-package main
-
-import (
- log "github.com/hashicorp/go-hclog"
-- "github.com/hashicorp/nomad-skeleton-driver-plugin/hello"
-+. "github.com/<REPO>/<ORG>/hello"
-...
-
-```
-
-Build the skeleton plugin.
-
-```sh
-$ make build
-```
-
-## Deploying Driver Plugins in Nomad
-
-The initial version of the skeleton is a simple task that outputs a greeting.
-You can try it out by starting a Nomad agent and running the job provided in
-the `example` folder:
+To build the plugin and run a dev agent:
```sh
$ make build
$ nomad agent -dev -config=./example/agent.hcl -plugin-dir=$(pwd)
# in another shell
-$ nomad run ./example/example.nomad
+$ nomad run ./example/example-batch.hcl
+$ nomad run ./example/example-service.hcl
$ nomad logs <ALLOCATION ID>
```
-Code Organization
+Writing Nix job specifications
-------------------
-Follow the comments marked with a `TODO` tag to implement your driver's logic.
-For more information check the
-[Nomad documentation on plugins](https://www.nomadproject.io/docs/internals/plugins/index.html).
+
+See documentation comments in example HCL files.