open-consul/website/pages/discovery/index.jsx

import CallToAction from '@hashicorp/react-call-to-action'
import CaseStudySlider from '@hashicorp/react-case-study-slider'
import CodeBlock from '@hashicorp/react-code-block'
import BeforeAfterDiagram from '../../components/before-after'

export default function ServiceDiscovery() {
  return (
    <>
      <div className="consul-connect">
        <CallToAction
          heading="Service discovery made easy"
          content="Service registry, integrated health checks, and DNS and HTTP interfaces enable any service to discover and be discovered by other services"
          brand="consul"
          links={[
            { text: 'Download', url: '/downloads' },
            {
              text: 'Explore Docs',
              url:
                'https://learn.hashicorp.com/consul/getting-started/services',
            },
          ]}
        />
        <section
          id="static-dynamic"
          className="g-section-block layout-vertical theme-white-background-black-text small-padding"
        >
          <div className="g-grid-container">
            <BeforeAfterDiagram
              beforeHeading="The Challenge"
              beforeSubTitle="Service load balancers aren't efficient in a dynamic world."
              beforeImage="/img/consul-connect/svgs/discovery-challenge.svg"
              beforeDescription="Load balancers are often used to front a service tier and provide a static IP. These load balancers add cost, increase latency, introduce single points of failure, and must be updated as services scale up/down."
              afterHeading="The Solution"
              afterSubTitle="Service discovery for dynamic infrastructure."
              afterImage="/img/consul-connect/svgs/discovery-solution.svg"
              afterDescription="Instead of load balancers, connectivity in dynamic infrastructure is best solved with service discovery. Service discovery uses a registry to keep a real-time list of services, their location, and their health. Services query the registry to discover the location of upstream services and then connect directly. This allows services to scale up/down and gracefully handle failure without a load balancer intermediary."
            />
          </div>
        </section>
        <section></section>

        <section class="g-section border-top large-padding">
          <div class="g-container">
            <div class="intro">
              <h2 class="g-type-display-2">Features</h2>
            </div>
            <div class="g-text-asset large">
              <div>
                <div>
                  <h3 class="g-type-display-3">Service Registry</h3>
                  <p class="g-type-body">
                    Consul provides a registry of all the running nodes and
                    services, along with their current health status. This
                    allows operators to understand the environment, and
                    applications and automation tools to interact with dynamic
                    infrastructure using an HTTP API.
                  </p>
                  <p>
                    <a
                      class="learn-more g-type-buttons-and-standalone-links"
                      href="https://learn.hashicorp.com/consul/getting-started/services"
                    >
                      Learn more
                      <svg
                        xmlns="http://www.w3.org/2000/svg"
                        width="6"
                        height="10"
                        viewBox="0 0 6 10"
                      >
                        <g
                          fill="none"
                          fillRule="evenodd"
                          transform="translate(-6 -3)"
                        >
                          <mask id="a" fill="#fff">
                            <path d="M7.138 3.529a.666.666 0 1 0-.942.942l3.528 3.53-3.529 3.528a.666.666 0 1 0 .943.943l4-4a.666.666 0 0 0 0-.943l-4-4z" />
                          </mask>
                          <g fill="#1563FF" mask="url(#a)">
                            <path d="M0 0h16v16H0z" />
                          </g>
                        </g>
                      </svg>
                    </a>
                  </p>
                </div>
              </div>
              <div>
                <picture>
                  <source
                    type="image/webp"
                    srcSet="
              /img/consul-connect/ui-health-checks/ui-health-checks_230.webp 230w,
              /img/consul-connect/ui-health-checks/ui-health-checks_690.webp 690w,
              /img/consul-connect/ui-health-checks/ui-health-checks_1290.webp 1290w"
                  />
                  <source
                    type="image/jpg"
                    srcSet="
              /img/consul-connect/ui-health-checks/ui-health-checks_230.jpg 230w,
              /img/consul-connect/ui-health-checks/ui-health-checks_690.jpg 690w,
              /img/consul-connect/ui-health-checks/ui-health-checks_1290.jpg 1290w"
                  />
                  <img
                    src="/img/consul-connect/ui-health-checks/ui-health-checks_1290.jpg"
                    alt="Service Registry"
                  />
                </picture>
              </div>
            </div>
          </div>
        </section>

        <section class="g-section border-top large-padding">
          <div class="g-container">
            <div class="g-text-asset reverse">
              <div>
                <div>
                  <h3 class="g-type-display-3">DNS Query Interface</h3>
                  <p class="g-type-body">
                    Consul enables service discovery using a built-in DNS
                    server. This allows existing applications to easily
                    integrate, as almost all applications support using DNS to
                    resolve IP addresses. Using DNS instead of a static IP
                    address allows services to scale up/down and route around
                    failures easily.
                  </p>
                  <p>
                    <a
                      class="learn-more g-type-buttons-and-standalone-links"
                      href="https://learn.hashicorp.com/consul/getting-started/services#querying-services"
                    >
                      Learn more
                      <svg
                        xmlns="http://www.w3.org/2000/svg"
                        width="6"
                        height="10"
                        viewBox="0 0 6 10"
                      >
                        <g
                          fill="none"
                          fillRule="evenodd"
                          transform="translate(-6 -3)"
                        >
                          <mask id="a" fill="#fff">
                            <path d="M7.138 3.529a.666.666 0 1 0-.942.942l3.528 3.53-3.529 3.528a.666.666 0 1 0 .943.943l4-4a.666.666 0 0 0 0-.943l-4-4z" />
                          </mask>
                          <g fill="#1563FF" mask="url(#a)">
                            <path d="M0 0h16v16H0z" />
                          </g>
                        </g>
                      </svg>
                    </a>
                  </p>
                </div>
              </div>
              <div class="code-sample">
                <div>
                  <span></span>
                  <CodeBlock
                    prefix="terminal"
                    code={`
$ dig web-frontend.service.consul. ANY
; <<>> DiG 9.8.3-P1 <<>> web-frontend.service.consul. ANY
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 29981
;; flags: qr aa rd ra; QUERY: 1, ANSWER: 2, AUTHORITY: 0, ADDITIONAL: 0

;; QUESTION SECTION:
;web-frontend.service.consul. IN ANY

;; ANSWER SECTION:
web-frontend.service.consul. 0 IN A 10.0.3.83
web-frontend.service.consul. 0 IN A 10.0.1.109
          `}
                  />
                </div>
              </div>
            </div>
          </div>
        </section>

        <section class="g-section border-top large-padding">
          <div class="g-container">
            <div class="g-text-asset">
              <div>
                <div>
                  <h3 class="g-type-display-3">HTTP API with Edge Triggers</h3>
                  <p class="g-type-body">
                    Consul provides an HTTP API to query the service registry
                    for nodes, services, and health check information. The API
                    also supports blocking queries, or long-polling for any
                    changes. This allows automation tools to react to services
                    being registered or health status changes to change
                    configurations or traffic routing in real time.
                  </p>
                  <p>
                    <a
                      class="learn-more g-type-buttons-and-standalone-links"
                      href="https://learn.hashicorp.com/consul/getting-started/services#http-api"
                    >
                      Learn more
                      <svg
                        xmlns="http://www.w3.org/2000/svg"
                        width="6"
                        height="10"
                        viewBox="0 0 6 10"
                      >
                        <g
                          fill="none"
                          fillRule="evenodd"
                          transform="translate(-6 -3)"
                        >
                          <mask id="a" fill="#fff">
                            <path d="M7.138 3.529a.666.666 0 1 0-.942.942l3.528 3.53-3.529 3.528a.666.666 0 1 0 .943.943l4-4a.666.666 0 0 0 0-.943l-4-4z" />
                          </mask>
                          <g fill="#1563FF" mask="url(#a)">
                            <path d="M0 0h16v16H0z" />
                          </g>
                        </g>
                      </svg>
                    </a>
                  </p>
                </div>
              </div>
              <div class="code-sample">
                <div>
                  <span></span>
                  <CodeBlock
                    prefix="terminal"
                    code={`
$ curl http://localhost:8500/v1/health/service/web?index=11&wait=30s
  {
    ...
    "Node": "10-0-1-109",
    "CheckID": "service:web",
    "Name": "Service 'web' check",
    "Status": <code class='keyword'>"critical"</code>,
    "ServiceID": "web",
    "ServiceName": "web",
    "CreateIndex": 10,
    "ModifyIndex": 20
    ...
  }
          `}
                  />
                </div>
              </div>
            </div>
          </div>
        </section>

        <section class="g-section border-top large-padding">
          <div class="g-container">
            <div class="g-text-asset reverse">
              <div>
                <div>
                  <h3 class="g-type-display-3">Multi Datacenter</h3>
                  <p class="g-type-body">
                    Consul supports multiple datacenters out of the box with no
                    complicated configuration. Look up services in other
                    datacenters or keep the request local. Advanced features
                    like Prepared Queries enable automatic failover to other
                    datacenters.
                  </p>
                  <p>
                    <a
                      class="learn-more g-type-buttons-and-standalone-links"
                      href="https://learn.hashicorp.com/consul/security-networking/datacenters"
                    >
                      Learn more
                      <svg
                        xmlns="http://www.w3.org/2000/svg"
                        width="6"
                        height="10"
                        viewBox="0 0 6 10"
                      >
                        <g
                          fill="none"
                          fillRule="evenodd"
                          transform="translate(-6 -3)"
                        >
                          <mask id="a" fill="#fff">
                            <path d="M7.138 3.529a.666.666 0 1 0-.942.942l3.528 3.53-3.529 3.528a.666.666 0 1 0 .943.943l4-4a.666.666 0 0 0 0-.943l-4-4z" />
                          </mask>
                          <g fill="#1563FF" mask="url(#a)">
                            <path d="M0 0h16v16H0z" />
                          </g>
                        </g>
                      </svg>
                    </a>
                  </p>
                </div>
              </div>
              <div class="code-sample">
                <div>
                  <span></span>
                  <div class="code">
                    <CodeBlock
                      prefix="terminal"
                      code={`
$ curl http://localhost:8500/v1/catalog/datacenters
  [
    "dc1",
    "dc2"
  ]
  $ curl http://localhost:8500/v1/catalog/nodes?dc=dc2
  [
    {
        "ID": "7081dcdf-fdc0-0432-f2e8-a357d36084e1",
        "Node": "10-0-1-109",
        "Address": "10.0.1.109",
        "Datacenter": "<code class='keyword'>dc2</code>",
        "TaggedAddresses": {
            "lan": "10.0.1.109",
            "wan": "10.0.1.109"
        },
        "CreateIndex": 112,
        "ModifyIndex": 125
    },
...
          `}
                    />
                  </div>
                </div>
              </div>
            </div>
          </div>
        </section>

        <section class="g-section border-top large-padding">
          <div class="g-container">
            <div class="g-text-asset large">
              <div>
                <div>
                  <h3 class="g-type-display-3">Health Checks</h3>
                  <p class="g-type-body">
                    Pairing service discovery with health checking prevents
                    routing requests to unhealthy hosts and enables services to
                    easily provide circuit breakers.
                  </p>
                  <p>
                    <a
                      class="learn-more g-type-buttons-and-standalone-links"
                      href="https://learn.hashicorp.com/consul/getting-started/services"
                    >
                      Learn more
                      <svg
                        xmlns="http://www.w3.org/2000/svg"
                        width="6"
                        height="10"
                        viewBox="0 0 6 10"
                      >
                        <g
                          fill="none"
                          fillRule="evenodd"
                          transform="translate(-6 -3)"
                        >
                          <mask id="a" fill="#fff">
                            <path d="M7.138 3.529a.666.666 0 1 0-.942.942l3.528 3.53-3.529 3.528a.666.666 0 1 0 .943.943l4-4a.666.666 0 0 0 0-.943l-4-4z" />
                          </mask>
                          <g fill="#1563FF" mask="url(#a)">
                            <path d="M0 0h16v16H0z" />
                          </g>
                        </g>
                      </svg>
                    </a>
                  </p>
                </div>
              </div>
              <div>
                <picture>
                  <source
                    type="image/webp"
                    srcSet="
              /img/consul-connect/ui-health-checks/ui-health-checks_230.webp 230w,
              /img/consul-connect/ui-health-checks/ui-health-checks_690.webp 690w,
              /img/consul-connect/ui-health-checks/ui-health-checks_1290.webp 1290w"
                  />
                  <source
                    type="image/jpg"
                    srcSet="
              /img/consul-connect/ui-health-checks/ui-health-checks_230.jpg 230w,
              /img/consul-connect/ui-health-checks/ui-health-checks_690.jpg 690w,
              /img/consul-connect/ui-health-checks/ui-health-checks_1290.jpg 1290w"
                  />
                  <img
                    src="/img/consul-connect/ui-health-checks/ui-health-checks_1290.jpg"
                    alt="Health Checks"
                  />
                </picture>
              </div>
            </div>
          </div>
        </section>
        <section className="large-padding bg-dark">
          <div className="g-grid-container">
            <div class="intro">
              <h2 class="g-type-display-2">Use Cases</h2>
            </div>
            <CaseStudySlider
              dark
              data={{
                brand: 'consul',
                caseStudies: [
                  {
                    company: {
                      monochromeLogo: {
                        url:
                          'https://www.datocms-assets.com/2885/1586530899-twitchextrudedwordmarkblackops.png',
                        alt: 'Logo dark',
                        format: 'png',
                      },
                      whiteLogo: {
                        url:
                          'https://www.datocms-assets.com/2885/1586530633-twitch-wordmark-white.svg',
                        alt: 'Logo white',
                        format: 'png',
                      },
                    },
                    headline:
                      'Twitch - Driving Towards a Modern Infrastructure',
                    description:
                      'In this talk from HashiConf 2015, Tarrant Rollins discusses how Twitch uses HashiCorp Consul to overcome legacy infrastructure and solve complex problems.',
                    caseStudyLink:
                      'https://www.hashicorp.com/resources/twitch-driving-towards-a-modern-infrastructure',
                    caseStudyResource: {
                      image: {
                        url:
                          '/img/consul-connect/case-studies/case-study_01.jpg',
                        alt: 'Twitch - Modern Infrastructure',
                        format: 'jpg',
                      },
                    },
                    buttonLabel: 'Watch Video',
                  },
                  {
                    company: {
                      monochromeLogo: {
                        url:
                          'https://www.datocms-assets.com/2885/1522341143-jet-black.svg',
                        alt: 'Logo dark',
                        format: 'svg',
                      },
                      whiteLogo: {
                        url:
                          'https://www.datocms-assets.com/2885/1522341147-jet-white.svg',
                        alt: 'Logo white',
                        format: 'svg',
                      },
                    },
                    headline:
                      'Jet.com - Nomad Auto-Proxy with Consul-Template and NGINX',
                    description:
                      'Justen Walker explains how Jet.com uses HashiCorp Consul and Nomad to allow hundreds of developers to have self-service access, despite relying on NGINX static configs—and with a remarkably small DevOps team.',
                    caseStudyLink:
                      'https://www.hashicorp.com/resources/jet-com-nomad-auto-proxy-consul-template-nginx',
                    caseStudyResource: {
                      image: {
                        url:
                          '/img/consul-connect/case-studies/case-study_02.jpg',
                        alt: 'Jet - Nomad Auto-Proxy',
                        format: 'jpg',
                      },
                    },
                    buttonLabel: 'Watch Video',
                  },
                ],
              }}
            />
          </div>
        </section>

        <section class="g-section g-cta-section large-padding">
          <div>
            <h2 class="g-type-display-2">Ready to get started?</h2>
            <a href="/downloads.html" class="button download white">
              <svg
                xmlns="http://www.w3.org/2000/svg"
                width="20"
                height="22"
                viewBox="0 0 20 22"
              >
                <path d="M9.292 15.706a1 1 0 0 0 1.416 0l3.999-3.999a1 1 0 1 0-1.414-1.414L11 12.586V1a1 1 0 1 0-2 0v11.586l-2.293-2.293a1 1 0 1 0-1.414 1.414l3.999 3.999zM20 16v3c0 1.654-1.346 3-3 3H3c-1.654 0-3-1.346-3-3v-3a1 1 0 1 1 2 0v3c0 .551.448 1 1 1h14c.552 0 1-.449 1-1v-3a1 1 0 1 1 2 0z" />
              </svg>
              Download
            </a>
            <a
              href="https://learn.hashicorp.com/consul/getting-started/services"
              class="button secondary white"
            >
              Explore docs
            </a>
          </div>
        </section>
      </div>
    </>
  )
}