mirror of https://github.com/hashicorp/consul
Merge pull request #2579 from hashicorp/sethvargo/kv_main
Update homepage to use KV CLI instead of curlpull/2580/head
Seth Vargo
8 years ago
committed by
GitHub
commit
406a868277
@ -1,207 +1,208 @@
|
||||
---
|
||||
description: Service discovery and configuration made easy. Distributed, highly available, and datacenter-aware.
|
||||
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.
|
||||
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 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>
|
||||
<!-- 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 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 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>: curl -X PUT -d 'bar' http://localhost:8500/v1/kv/foo</p>
|
||||
<p>true</p>
|
||||
<p class="command"><span class="txt-r">admin@hashicorp</span>: curl http://localhost:8500/v1/kv/foo</p>
|
||||
<p>[</p>
|
||||
<p> {</p>
|
||||
<p> "CreateIndex": 100,</p>
|
||||
<p> "ModifyIndex": 200,</p>
|
||||
<p> "Key": "foo",</p>
|
||||
<p> "Flags": 0,</p>
|
||||
<p> "Value": <span class="txt-p">"YmFy"</span></p>
|
||||
<p> }</p>
|
||||
<p>]</p>
|
||||
<p class="command"><span class="txt-r">admin@hashicorp</span>: echo "YmFy" | base64 --decode</p>
|
||||
<p>bar</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 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 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>
|
||||
|
||||
Loading…
Reference in new issue