Nomad

A elixir client for HashiCorp Nomad’s API.

Building

To install the required dependencies and to build the elixir project, run:

mix local.hex --force
mix do deps.get, compile

Installation

The package can be installed by adding nomad_client to your list of dependencies in mix.exs:

def deps do
  [{:nomad_client, "~> 0.12.1"}]
end

The Documentation can be found at https://hexdocs.pm/nomad_client.

Usage

First, you have to initiate the Tesla.Env.Conn.

    # Use Application defaults
    conn = NomadClient.Connection.new()
    # Differente URL, no ACL token
    conn = NomadClient.Connection.new("http://172.17.0.1:4646")
    # Custom URL with ACL token
    conn = NomadClient.Connection.new("http://172.17.0.1:4646", "00000000-0000-0000-0000-000000000000")

After that, you can use your conn to make requests the api requests by using the API Modules.

For example:

  alias NomadClient.Connection
  alias NomadClient.Api.Jobs

  conn = Connection.new()
  {:ok, []} = Jobs.get_jobs(conn)

Configuration

You can chance the default http adapter or inject additional middleware into the client. Since the client does not provides his own application instruction, the configuration has to be made via the :tesla application

For example: (config.exs)

config :tesla, NomadClient.Connection,
  adapter: {Tesla.Adapter.Hackney, [recv_timeout: 150_000, connect_timeout: 150_000]},
  middleware: [Tesla.Middleware.Logger]

Development

Regenerationg the client

You can basicly regenerate this client without the custom modifications by running the following command:

docker run \
    --rm \
    --mount "type=bind,src=$(pwd),dst=/local" \
    --user "$UID:$GID" \
    openapitools/openapi-generator-cli:v5.2.1 \
      generate \
      --invoker-package NomadClient \
      --generator-name elixir \
      --skip-validate-spec \
      --input-spec /local/openapi.json \
      --output /local/

This will spin up a docker container on your system and gernerates the whole elixir client based on the openapi.json definition. Please note, the openapi.json file is also just e generated part of the https://github.com/mrmstn/Nomad.OAS Project. I’ve just added this file to this repo for simplicity and documentation.

Credits and Copyright

This client is based on a loooot of generated code which would not have been possible without the OAS definition of the nomad-api and the OAS client generator

The OAS defintion

• https://github.com/FuturistiCoder/Nomad.OAS
• https://github.com/rivet-gg/Nomad.OAS

The OAS Generator

If you like this client, take a look at the awesome openapi-generator: https://github.com/OpenAPITools/openapi-generator