mirror of https://github.com/hashicorp/consul
211 lines
7.8 KiB
Plaintext
211 lines
7.8 KiB
Plaintext
---
|
|
description: |-
|
|
Consul is a highly available and distributed service discovery and key-value
|
|
store designed with support for the modern data center to make distributed
|
|
systems and configuration easy.
|
|
---
|
|
|
|
<!-- Main jumbotron for a primary marketing message or call to action -->
|
|
<div id="jumbotron-mask">
|
|
<div id="jumbotron">
|
|
<div class="container">
|
|
<div class="col-lg-6 col-md-6">
|
|
<h2 class="rls-l">
|
|
Service discovery and configuration made easy.
|
|
</h2>
|
|
<p class="lead">
|
|
Distributed, highly available, and
|
|
datacenter-aware.
|
|
</p>
|
|
</div>
|
|
<div class="jumbo-logo-wrap col-lg-offset-1 col-lg-5 col-md-6 hidden-xs hidden-sm">
|
|
<div class="jumbo-logo"></div>
|
|
</div>
|
|
<!-- <p><a class="btn btn-primary btn-lg">Learn more »</a></p> -->
|
|
</div>
|
|
<div class="jumbotron-dots"></div>
|
|
</div>
|
|
</div>
|
|
<!-- Make sure that any changes made to jumbotron are reproduced here as this takes up the space in the layout -->
|
|
<div id="jumbotron-mask-dummy" aria-hidden="true">
|
|
<div id="jumbotron">
|
|
<div class="container">
|
|
<div class="col-lg-6 col-md-6">
|
|
<h2 class="rls-l">
|
|
Service discovery and configuration made easy.
|
|
Distributed, highly available, and
|
|
datacenter-aware.
|
|
</h2>
|
|
</div>
|
|
<div class="jumbo-logo-wrap col-lg-offset-1 col-lg-5 col-md-6 hidden-xs hidden-sm">
|
|
<div class="jumbo-logo"></div>
|
|
</div>
|
|
<!-- <p><a class="btn btn-primary btn-lg">Learn more »</a></p> -->
|
|
</div>
|
|
<div class="jumbotron-dots"></div>
|
|
</div>
|
|
</div>
|
|
<div id="features">
|
|
<div class="container">
|
|
<div class="row double-row">
|
|
<div class="col-lg-6 col-md-6">
|
|
<div class="row">
|
|
<div class="col-lg-5 col-md-5">
|
|
<span class="icn discovery"></span>
|
|
</div>
|
|
<div class="col-lg-7 col-md-7">
|
|
<h2>Service Discovery</h2>
|
|
<p>
|
|
Consul makes it simple for services to register themselves
|
|
and to discover other services via a DNS or HTTP interface.
|
|
Register external services such as SaaS providers as well.
|
|
</p>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="col-lg-6 col-md-6">
|
|
<div class="row">
|
|
<div class="col-lg-5 col-md-5">
|
|
<span class="icn health"></span>
|
|
</div>
|
|
<div class="col-lg-7 col-md-7">
|
|
<h2>Failure Detection</h2>
|
|
<p>Pairing service discovery with health checking prevents routing requests to unhealthy hosts and enables services to easily provide circuit breakers.</p>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="row double-row">
|
|
<div class="col-lg-6 col-md-6">
|
|
<div class="row">
|
|
<div class="col-lg-5 col-md-5">
|
|
<span class="icn multi"></span>
|
|
</div>
|
|
<div class="col-lg-7 col-md-7">
|
|
<h2>Multi Datacenter</h2>
|
|
<p>Consul scales to multiple datacenters out of the box with no complicated configuration. Look up services in other datacenters, or keep the request local.</p>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="col-lg-6 col-md-6">
|
|
<div class="row">
|
|
<div class="col-lg-5 col-md-5">
|
|
<span class="icn config"></span>
|
|
</div>
|
|
<div class="col-lg-7 col-md-7">
|
|
<h2>Key/Value Storage</h2>
|
|
<p>Flexible key/value store for dynamic configuration, feature flagging, coordination, leader election and more. Long poll for near-instant notification of configuration changes.</p>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<!-- /container -->
|
|
</div>
|
|
<!-- /features -->
|
|
<div id="demos">
|
|
<div class="container">
|
|
<div class="terminals row">
|
|
<div class="col-xs-12 col-lg-12 explantion">
|
|
<h2>DNS Query Interface</h2>
|
|
<p>
|
|
Look up services using Consul's built-in DNS server. Support
|
|
existing infrastructure without any code change.
|
|
</p>
|
|
</div>
|
|
<div class="terminal-item col-xs-12 col-lg-12">
|
|
<div class="terminal">
|
|
<header>
|
|
<h4>Terminal</h4>
|
|
<ul class='shell-dots'>
|
|
<li></li>
|
|
<li></li>
|
|
<li></li>
|
|
</ul>
|
|
</header>
|
|
<div class="terminal-window">
|
|
<div class="terminal">
|
|
<div class="display">
|
|
<p class="command"><span class="txt-r">admin@hashicorp</span>: dig web-frontend.service.consul. ANY</p>
|
|
<p>; <<>> DiG 9.8.3-P1 <<>> web-frontend.service.consul. ANY</p>
|
|
<p>;; global options: +cmd</p>
|
|
<p> </p>
|
|
<p>;; Got answer:</p>
|
|
<p>;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 29981</p>
|
|
<p>;; flags: qr aa rd ra; QUERY: 1, ANSWER: 2, AUTHORITY: 0, ADDITIONAL: 0</p>
|
|
<p> </p>
|
|
<p>;; QUESTION SECTION:</p>
|
|
<p>;web-frontend.service.consul. IN ANY</p>
|
|
<p> </p>
|
|
<p>;; ANSWER SECTION:</p>
|
|
<p>web-frontend.service.consul. 0 IN A <span class="txt-p">10.0.3.83</span></p>
|
|
<p>web-frontend.service.consul. 0 IN A <span class="txt-p">10.0.1.109</span></p>
|
|
<p class="command"><span class="txt-r">admin@hashicorp</span>: <span class="cursor"> </span></p>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<!-- /.terminal-item -->
|
|
<div class="col-xs-12 col-lg-12 explantion">
|
|
<h2>Key Value Storage</h2>
|
|
<p>
|
|
Consul provides a hierarchical key/value store with a simple HTTP API.
|
|
Managing configuration has never been simpler.
|
|
</p>
|
|
</div>
|
|
<div class="terminal-item col-xs-12 col-lg-12">
|
|
<div class="terminal">
|
|
<header>
|
|
<h4>Terminal</h4>
|
|
<ul class='shell-dots'>
|
|
<li></li>
|
|
<li></li>
|
|
<li></li>
|
|
</ul>
|
|
</header>
|
|
<div class="terminal-window">
|
|
<div class="terminal">
|
|
<div class="display">
|
|
<p class="command"><span class="txt-r">admin@hashicorp</span>: consul kv put foo bar</p>
|
|
<p>Success! Data written to: foo</p>
|
|
<p class="command"><span class="txt-r">admin@hashicorp</span>: consul kv get foo</p>
|
|
<p>bar</p>
|
|
<p class="command"><span class="txt-r">admin@hashicorp</span>: consul kv get -detailed foo</p>
|
|
<p>CreateIndex 5</p>
|
|
<p>Flags 0</p>
|
|
<p>Key foo</p>
|
|
<p>LockIndex 0</p>
|
|
<p>ModifyIndex 5</p>
|
|
<p>Session -</p>
|
|
<p>Value bar</p>
|
|
<p class="command"><span class="txt-r">admin@hashicorp</span>: consul kv delete foo</p>
|
|
<p>Success! Deleted key: foo</p>
|
|
<p class="command"><span class="txt-r">admin@hashicorp</span>: <span class="cursor"> </span></p>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<!-- /.terminal-item -->
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<!-- /#demos -->
|
|
<div id="cta">
|
|
<div class="container">
|
|
<div class="row">
|
|
<div class="intro">
|
|
<div class="left col-xs-12 col-sm-offset-2 col-sm-4">
|
|
<p>The intro and getting started guide contain
|
|
a simple and approachable walkthrough for running Consul locally.
|
|
</p>
|
|
</div>
|
|
<div class="col-xs-12 col-sm-6 col-sm-offset-0 right">
|
|
<a class="outline-btn purple" href="/intro/index.html">Read the intro »</a>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|