2017-03-14 18:23:28 +01:00
|
|
|
Consul Testing Utilities
|
|
|
|
========================
|
|
|
|
|
|
|
|
This package provides some generic helpers to facilitate testing in Consul.
|
|
|
|
|
|
|
|
TestServer
|
|
|
|
==========
|
|
|
|
|
|
|
|
TestServer is a harness for managing Consul agents and initializing them with
|
|
|
|
test data. Using it, you can form test clusters, create services, add health
|
|
|
|
checks, manipulate the K/V store, etc. This test harness is completely decoupled
|
|
|
|
from Consul's core and API client, meaning it can be easily imported and used in
|
|
|
|
external unit tests for various applications. It works by invoking the Consul
|
|
|
|
CLI, which means it is a requirement to have Consul installed in the `$PATH`.
|
|
|
|
|
|
|
|
Following is an example usage:
|
|
|
|
|
|
|
|
```go
|
|
|
|
package my_program
|
|
|
|
|
|
|
|
import (
|
|
|
|
"testing"
|
|
|
|
|
|
|
|
"github.com/hashicorp/consul/consul/structs"
|
|
|
|
"github.com/hashicorp/consul/testutil"
|
|
|
|
)
|
|
|
|
|
2017-07-17 17:28:30 +02:00
|
|
|
func TestFoo_bar(t *testing.T) {
|
2017-03-14 18:23:28 +01:00
|
|
|
// Create a test Consul server
|
2017-07-17 17:28:30 +02:00
|
|
|
srv1, err := testutil.NewTestServer()
|
|
|
|
if err != nil {
|
|
|
|
t.Fatal(err)
|
|
|
|
}
|
2017-03-14 18:23:28 +01:00
|
|
|
defer srv1.Stop()
|
|
|
|
|
|
|
|
// Create a secondary server, passing in configuration
|
|
|
|
// to avoid bootstrapping as we are forming a cluster.
|
2017-07-17 17:28:30 +02:00
|
|
|
srv2, err := testutil.NewTestServerConfig(t, func(c *testutil.TestServerConfig) {
|
2017-03-14 18:23:28 +01:00
|
|
|
c.Bootstrap = false
|
|
|
|
})
|
2017-07-17 17:28:30 +02:00
|
|
|
if err != nil {
|
|
|
|
t.Fatal(err)
|
|
|
|
}
|
2017-03-14 18:23:28 +01:00
|
|
|
defer srv2.Stop()
|
|
|
|
|
|
|
|
// Join the servers together
|
2017-07-17 17:28:30 +02:00
|
|
|
srv1.JoinLAN(t, srv2.LANAddr)
|
2017-03-14 18:23:28 +01:00
|
|
|
|
|
|
|
// Create a test key/value pair
|
2017-07-17 17:28:30 +02:00
|
|
|
srv1.SetKV(t, "foo", []byte("bar"))
|
2017-03-14 18:23:28 +01:00
|
|
|
|
|
|
|
// Create lots of test key/value pairs
|
2017-07-17 17:28:30 +02:00
|
|
|
srv1.PopulateKV(t, map[string][]byte{
|
2017-03-14 18:23:28 +01:00
|
|
|
"bar": []byte("123"),
|
|
|
|
"baz": []byte("456"),
|
|
|
|
})
|
|
|
|
|
|
|
|
// Create a service
|
2017-07-17 17:28:30 +02:00
|
|
|
srv1.AddService(t, "redis", structs.HealthPassing, []string{"master"})
|
|
|
|
|
|
|
|
// Create a service that will be accessed in target source code
|
|
|
|
srv1.AddAccessibleService("redis", structs.HealthPassing, "127.0.0.1", 6379, []string{"master"})
|
2017-03-14 18:23:28 +01:00
|
|
|
|
|
|
|
// Create a service check
|
2017-07-17 17:28:30 +02:00
|
|
|
srv1.AddCheck(t, "service:redis", "redis", structs.HealthPassing)
|
2017-03-14 18:23:28 +01:00
|
|
|
|
|
|
|
// Create a node check
|
2017-07-17 17:28:30 +02:00
|
|
|
srv1.AddCheck(t, "mem", "", structs.HealthCritical)
|
2017-03-14 18:23:28 +01:00
|
|
|
|
|
|
|
// The HTTPAddr field contains the address of the Consul
|
|
|
|
// API on the new test server instance.
|
|
|
|
println(srv1.HTTPAddr)
|
2017-07-17 17:28:30 +02:00
|
|
|
|
|
|
|
// All functions also have a wrapper method to limit the passing of "t"
|
|
|
|
wrap := srv1.Wrap(t)
|
|
|
|
wrap.SetKV("foo", []byte("bar"))
|
2017-03-14 18:23:28 +01:00
|
|
|
}
|
|
|
|
```
|