From d37c014796167067da596f1995f527fa360a38e6 Mon Sep 17 00:00:00 2001 From: Eddie Rowe <74205376+eddie-rowe@users.noreply.github.com> Date: Mon, 8 Aug 2022 17:09:47 -0500 Subject: [PATCH] add suggestions from code review --- .../docs/intro/usecases/what-is-a-service-mesh.mdx | 4 ++-- .../intro/usecases/what-is-service-discovery.mdx | 12 ++++++------ website/data/docs-nav-data.json | 2 +- 3 files changed, 9 insertions(+), 9 deletions(-) diff --git a/website/content/docs/intro/usecases/what-is-a-service-mesh.mdx b/website/content/docs/intro/usecases/what-is-a-service-mesh.mdx index ecae8a827..17fd93e26 100644 --- a/website/content/docs/intro/usecases/what-is-a-service-mesh.mdx +++ b/website/content/docs/intro/usecases/what-is-a-service-mesh.mdx @@ -1,12 +1,12 @@ --- layout: docs -page_title: What is a service mesh? +page_title: Service Mesh description: >- Learn what a service mesh is, its benefits, and how it works. A service mesh can solve many of the modern challenges that exist in multi-platform and multi-cloud application architectures, ranging from security to application resiliency. --- -# What is a Service Mesh? +# What is a service mesh? A _service mesh_ is a dedicated network layer that provides secure service-to-service communication within and across infrastructure, including on-premises and cloud environments. Service meshes are often used with a microservice architectural pattern, but can provide value in any scenario where complex networking is involved. diff --git a/website/content/docs/intro/usecases/what-is-service-discovery.mdx b/website/content/docs/intro/usecases/what-is-service-discovery.mdx index b894853b7..820e5b768 100644 --- a/website/content/docs/intro/usecases/what-is-service-discovery.mdx +++ b/website/content/docs/intro/usecases/what-is-service-discovery.mdx @@ -1,16 +1,16 @@ --- layout: docs -page_title: What is a service mesh? +page_title: Service Discovery description: >- Learn what service discovery is, its benefits, and how it works. Service mesh can solve many of the modern challenges that exist in multi-platform and multi-cloud application architectures, ranging from security to application resiliency. --- -# What is Service Discovery? +# What is service discovery? _Service discovery_ helps you discover, track, and monitor the health of services within a network. Service discovery registers and maintains a record of all your services in a _service catalog_. This service catalog acts as a single source of truth that allows your services to query and communicate with each other. -## Benefits of Service Discovery +## Benefits of service discovery Service discovery provides benefits for all organizations, ranging from simplified scalability to improved application resiliency. Some of the benefits of service discovery include: @@ -38,7 +38,7 @@ The service catalog is dynamically updated as new instances of the service are a ![Example diagram of how unhealthy services are removed from the service catalog](/img/what_is_service_discovery_3.png) -## What is Service Discovery in Microservices? +## What is service discovery in microservices? In a microservices application, the set of active service instances changes frequently across a large, dynamic environment. These service instances rely on a service catalog to retrieve the most up-to-date access information from the respective services. A reliable service catalog is especially important for service discovery in microservices to ensure healthy, scalable, and highly responsive application operation. @@ -63,7 +63,7 @@ In systems that use server‑side discovery, the service consumer uses an interm For modern applications, this discovery method is advantageous because developers can make their applications faster and more lightweight by decoupling and centralizing service discovery logic. -## Service Discovery vs Load Balancing +## Service discovery vs load balancing Service discovery and load balancing share a similarity in distributing requests to back end services, but differ in many important ways. @@ -71,7 +71,7 @@ Traditional load balancers are not designed for rapid registration and de-regist For modern, cloud-based applications, service discovery is the preferred method for directing traffic to the right service provider due to its ability to scale and remain resilient, independent of infrastructure. -## How do you implement Service Discovery? +## How do you implement service discovery? You can implement service discovery systems across any type of infrastructure, whether it is on-premise or in the cloud. Service discovery is a native feature of many container orchestrators such as Kubernetes or Nomad. There are also platform-agnostic service discovery methods available for non-container workloads such as VMs and serverless technologies. Implementing a resilient service discovery system involves creating a set of servers that maintain and facilitate service registry operations. You can achieve this by installing a service discovery system or using a managed service discovery service. diff --git a/website/data/docs-nav-data.json b/website/data/docs-nav-data.json index 126cf11b8..36c906113 100644 --- a/website/data/docs-nav-data.json +++ b/website/data/docs-nav-data.json @@ -19,7 +19,7 @@ "path": "intro/usecases/what-is-service-discovery" }, { - "title": "What is a Service Mesh?", + "title": "Service Mesh", "path": "intro/usecases/what-is-a-service-mesh" } ]