48 lines
1.5 KiB
Markdown
48 lines
1.5 KiB
Markdown
|
---
|
||
|
|
layout: "consul"
|
||
|
|
page_title: "Consul: consul_service"
|
||
|
|
sidebar_current: "docs-consul-resource-service"
|
||
|
|
description: |-
|
||
|
|
A high-level resource for creating a Service in Consul. Since Consul requires clients to register services with either the catalog or an agent, `consul_service` may register with either the catalog or an agent, depending on the configuration of `consul_service`. For now, `consul_service` always registers services with the agent running at the address defined in the `consul` resource. Health checks are not currently supported.
|
||
|
|
---
|
||
|
|
|
||
|
|
# consul\_service
|
||
|
|
|
||
|
|
A high-level resource for creating a Service in Consul. Currently, defining health checks for a service is not supported.
|
||
|
|
|
||
|
|
## Example Usage
|
||
|
|
|
||
|
|
```
|
||
|
|
resource "consul_service" "google" {
|
||
|
|
address = "www.google.com"
|
||
|
|
name = "google"
|
||
|
|
port = 80
|
||
|
|
tags = ["tag0", "tag1"]
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
## Argument Reference
|
||
|
|
|
||
|
|
The following arguments are supported:
|
||
|
|
|
||
|
|
* `address` - (Optional) The address of the service. Defaults to the
|
||
|
|
address of the agent.
|
||
|
|
|
||
|
|
* `name` - (Required) The name of the service.
|
||
|
|
|
||
|
|
* `port` - (Optional) The port of the service.
|
||
|
|
|
||
|
|
* `tags` - (Optional) A list of values that are opaque to Consul,
|
||
|
|
but can be used to distinguish between services or nodes.
|
||
|
|
|
||
|
|
|
||
|
|
## Attributes Reference
|
||
|
|
|
||
|
|
The following attributes are exported:
|
||
|
|
|
||
|
|
* `address` - The address of the service.
|
||
|
|
* `id` - The id of the service, defaults to the value of `name`.
|
||
|
|
* `name` - The name of the service.
|
||
|
|
* `port` - The port of the service.
|
||
|
|
* `tags` - The tags of the service.
|