» consul_service

A high-level resource for creating a Service in Consul in the Consul catalog. This is appropriate for registering external services and can be used to create services addressable by Consul that cannot be registered with a local agent.

If the Consul agent is running on the node where this service is registered, it is not recommended to use this resource.

» Example Usage

Creating a new node with the service:

resource "consul_service" "google" {
  name    = "google"
  node    = "${consul_node.compute.name}"
  port    = 80
  tags    = ["tag0"]
}

resource "consul_node" "compute" {
  name    = "compute-google"
  address = "www.google.com"
}

Utilizing an existing known node:

resource "consul_service" "google" {
  name    = "google"
  node    = "google"
  port    = 443
}

» Argument Reference

The following arguments are supported:

  • name - (Required, string) The name of the service.

  • node - (Required, string) The name of the node the to register the service on.

  • address - (Optional, string) The address of the service. Defaults to the address of the node.

  • service_id (Optional, string) - If the service ID is not provided, it will be defaulted to the value of the name attribute.

  • port - (Optional, int) The port of the service.

  • tags - (Optional, set of strings) A list of values that are opaque to Consul, but can be used to distinguish between services or nodes.

  • datacenter - (Optional) The datacenter to use. This overrides the datacenter in the provider setup and the agent's default datacenter.

» Attributes Reference

The following attributes are exported:

  • service_id - The ID of the service.
  • address - The address of the service.
  • node - The node the service is registered on.
  • name - The name of the service.
  • port - The port of the service.
  • tags - The tags of the service.