From feb8e43e3c5849124cd8dcd87a4c44f2e5cb712e Mon Sep 17 00:00:00 2001 From: Judith Malnick Date: Thu, 2 May 2019 10:06:51 -0700 Subject: [PATCH] [docs] Guide migration - index, menu, redirects (#5761) * modify guide index to point to learn * adding to the redirects is a wip, updated the side navigation. * add tracks to list * Fixing redirects * Update website/source/docs/guides/index.html.md Co-Authored-By: judithpatudith * Update website/source/docs/guides/index.html.md Co-Authored-By: judithpatudith * Update website/source/docs/guides/index.html.md Co-Authored-By: judithpatudith * Update website/source/docs/guides/index.html.md Co-Authored-By: judithpatudith * finish out track listings * finishing redirects. * change advanced language to production, add relationship of guides and docs * Update website/source/redirects.txt Co-Authored-By: judithpatudith --- website/source/docs/guides/index.html.md | 75 +++++++--------------- website/source/layouts/docs.erb | 80 ------------------------ website/source/redirects.txt | 32 +++++++--- 3 files changed, 46 insertions(+), 141 deletions(-) diff --git a/website/source/docs/guides/index.html.md b/website/source/docs/guides/index.html.md index 66f4e5188e..1ed8db7eff 100644 --- a/website/source/docs/guides/index.html.md +++ b/website/source/docs/guides/index.html.md @@ -3,63 +3,34 @@ layout: "docs" page_title: "Guides" sidebar_current: "docs-guides" description: |- - This section provides various guides for common actions. Due to the nature of Consul, some of these procedures can be complex, so our goal is to provide guidance to do them safely. + This section provides various guides for common actions. Due to the nature of + Consul, some of these procedures can be complex, so our goal is to provide + guidance to do them safely. --- # Consul Guides -This section provides various guides for common actions. Due to the nature -of Consul, some of these procedures can be complex, so our goal is to provide -guidance to do them safely. +~> The Consul guides have moved to the [HashiCorp Learn platform](https://learn.hashicorp.com/). -The following guides are available: +Guides are step by step command-line walkthroughs that demonstrate how to +perform common operations using Consul, and complement the feature-focused +Consul documentation. Guide content begins with getting-started tracks to help +new users learn the basics of Consul, and continues through production-playbook +tracks that cover topics like Day 1 and Day 2 operations, production +considerations, and recommendations for securing your Consul cluster. -* [Adding/Removing Servers](https://learn.hashicorp.com/consul/day-2-operations/advanced-operations/servers) - This guide covers how to safely add and remove Consul servers from the cluster. This should be done carefully to avoid availability outages. +You can work through the guides sequentially using the tracks, or just refer to +the material that is most relevant to you. -* [Agent Communication Encryption](https://learn.hashicorp.com/consul/advanced/day-1-operations/agent-encryption) - This guide covers how to encrypt both gossip and RPC communication. - -* [Autopilot](https://learn.hashicorp.com/consul/day-2-operations/advanced-operations/autopilot) - This guide covers Autopilot, which provides automatic operator-friendly management of Consul servers. +Tracks include: -* [Connect in Production](/docs/guides/connect-production.html) - This guide describes critical aspects of operating Consul Connect in Production. - -* [Connect with Envoy](/docs/guides/connect-envoy.html) - This guide will describe how to setup a development-mode Consul server and two Envoy proxies on a single machine using Docker. - -* [Consul Cluster Monitoring & Metrics](https://learn.hashicorp.com/consul/advanced/day-1-operations/monitoring) - After setting up your first datacenter, it is an ideal time to make sure your cluster is healthy and establish a baseline. This guide will cover several types of metrics in two sections: Consul health and server health. - -* [Consul with Containers](/docs/guides/consul-containers.html) - This guide describes critical aspects of operating a Consul cluster that's run inside containers. - -* [Consul Template](/docs/guides/consul-template.html) - This guide covers the Consul template tool, which provides a programmatic method for populating values into the file system. - -* [Consul-AWS](/docs/guides/consul-aws.html) - This guide covers the Consul-AWS tool, which syncs Consul's and AWS Cloud Map's service catalog. - -* [Creating Certificates](https://learn.hashicorp.com/consul/advanced/day-1-operations/certificates) - This guide describes how to setup CA and certificates to secure a Consul cluster with TLS. - -* [Datacenter Backups](https://learn.hashicorp.com/consul/advanced/day-1-operations/backup) - Consul provide the snapshot tool for backing up and restoring data. In this guide you will learn how to use both. - -* [Deployment Guide](https://learn.hashicorp.com/consul/advanced/day-1-operations/deployment-guide) - This deployment guide covers the steps required to install and configure a single HashiCorp Consul cluster as defined in the Consul Reference Architecture. - -* [DNS Caching](https://learn.hashicorp.com/consul/day-2-operations/advanced-operations/dns-caching) - Enabling TTLs for DNS query caching - -* [DNS Forwarding](/docs/guides/forwarding.html) - Forward DNS queries from Bind to Consul - -* [External Services](/docs/guides/external.html) - This guide covers registering an external service. This allows using 3rd party services within the Consul framework. - -* Federation ([Basic](/docs/guides/datacenters.html) and [Advanced](/docs/guides/advanced-federation.html)) - Configuring Consul to support multiple datacenters. - -* [Geo Failover](/docs/guides/geo-failover.html) - This guide covers using [prepared queries](/api/query.html) to implement geo failover for services. - -* [Minikube with Consul](https://learn.hashicorp.com/consul/getting-started-k8s/minikube/) - In this guide, you'll start a local Kubernetes cluster with minikube, install Consul,and then deploy two custom services. - -* [Leader Election](/docs/guides/leader-election.html) - The goal of this guide is to cover how to build client-side leader election using Consul. - -* [Monitoring Consul with Telegraf](/docs/guides/monitoring-telegraf.html) - This guide demonstrates how to setup Consul for monitoring with Telegraf. - -* [Network Segments](/docs/guides/network-segments.html) - Configuring Consul to support partial LAN connectivity using Network Segments. - -* [Outage Recovery](https://learn.hashicorp.com/consul/day-2-operations/advanced-operations/outage) - This guide covers recovering a cluster that has become unavailable due to server failures. - -* [Consul Reference Architecture](https://learn.hashicorp.com/consul/advanced/day-1-operations/reference-architecture) - This document provides recommended practices and a reference architecture, including system requirements, datacenter design, networking, and performance optimizations for Consul production deployments. - -* [Semaphore](/docs/guides/semaphore.html) - This guide covers using the KV store to implement a semaphore. - -* [Windows Service](/docs/guides/windows-guide.html) - This guide covers how to run Consul as a service on Windows. +- [Getting Started](https://learn.hashicorp.com/consul/?track=getting-started#getting-started) +- [Getting Started with Kubernetes](https://learn.hashicorp.com/consul/?track=getting-started-k8s#getting-started-k8s) +- [Day 1: Deploying Your First Datacenter](https://learn.hashicorp.com/consul/?track=datacenter-deploy#datacenter-deploy) +- [Day 1: Security and Network Operations](https://learn.hashicorp.com/consul/?track=security-networking#security-networking) +- [Day 1: Kubernetes Operations](https://learn.hashicorp.com/consul/?track=kubernetes#kubernetes) +- [Day 2: Advanced Operations and Maintenance](https://learn.hashicorp.com/consul/?track=day-2-operations#day-2-operations) +- [Development: Service Discovery](https://learn.hashicorp.com/consul/?track=developer-discovery#developer-discovery) +- [Development: Service Segmentation](https://learn.hashicorp.com/consul/?track=developer-segmentation#developer-segmentation) +- [Development: Service Configuration](https://learn.hashicorp.com/consul/?track=developer-configuration#developer-configuration) +- [Integrations](https://learn.hashicorp.com/consul/?track=integrations#integrations) diff --git a/website/source/layouts/docs.erb b/website/source/layouts/docs.erb index 65918d7a62..079b122647 100644 --- a/website/source/layouts/docs.erb +++ b/website/source/layouts/docs.erb @@ -550,86 +550,6 @@ > Guides - > diff --git a/website/source/redirects.txt b/website/source/redirects.txt index 456df4afad..cb5615eac1 100644 --- a/website/source/redirects.txt +++ b/website/source/redirects.txt @@ -57,16 +57,30 @@ /docs/commands/acl/acl-translate-rules.html https://www.consul.io/docs/commands/acl/translate-rules.html # Consul Learn Redirects -/docs/guides/acl.html https://learn.hashicorp.com/consul/advanced/day-1-operations/acl-guide -/docs/guides/agent-encryption.html https://learn.hashicorp.com/consul/advanced/day-1-operations/agent-encryption -/docs/guides/autopilot.html https://learn.hashicorp.com/consul/day-2-operations/advanced-operations/autopilot -/docs/guides/backup.html https://learn.hashicorp.com/consul/advanced/day-1-operations/backup -/docs/guides/cluster-monitoring-metrics.html https://learn.hashicorp.com/consul/advanced/day-1-operations/monitoring -/docs/guides/creating-certificates.html https://learn.hashicorp.com/consul/advanced/day-1-operations/certificates -/docs/guides/deployment-guide.html https://learn.hashicorp.com/consul/advanced/day-1-operations/deployment-guide -/docs/guides/deployment.html https://learn.hashicorp.com/consul/advanced/day-1-operations/reference-architecture -/docs/guides/dns-cache.html https://learn.hashicorp.com/consul/day-2-operations/advanced-operations/dns-caching +/docs/guides/acl.html https://learn.hashicorp.com/consul/security-networking/production-acls +/docs/guides/agent-encryption.html https://learn.hashicorp.com/consul/security-networking/agent-encryption +/docs/guides/autopilot.html https://learn.hashicorp.com/consul/day-2-operations/autopilot +/docs/guides/backup.html https://learn.hashicorp.com/consul/datacenter-deploy/backup +/docs/guides/cluster-monitoring-metrics.html https://learn.hashicorp.com/consul/day-2-operations/monitoring +/docs/guides/creating-certificates.html https://learn.hashicorp.com/consul/security-networking/certificates +/docs/guides/deployment-guide.html https://learn.hashicorp.com/consul/datacenter-deploy/deployment-guide +/docs/guides/deployment.html https://learn.hashicorp.com/consul/datacenter-deploy/reference-architecture +/docs/guides/dns-cache.html https://learn.hashicorp.com/consul/security-networking/dns-caching /docs/guides/minikube.html https://learn.hashicorp.com/consul/getting-started-k8s/minikube +/docs/guides/connect-production.html https://learn.hashicorp.com/consul/developer-segmentation/connect-production +/docs/guides/connect-envoy.html https://learn.hashicorp.com/consul/developer-segmentation/connect-envoy +/docs/guides/consul-template.html https://learn.hashicorp.com/consul/developer-configuration/consul-template +/docs/guides/consul-aws.html https://learn.hashicorp.com/consul/integrations/consul-aws +/docs/guides/forwarding.html https://learn.hashicorp.com/consul/security-networking/forwarding +/docs/guides/external.html https://learn.hashicorp.com/consul/developer-discovery/external +/docs/guides/advanced-federation.html https://learn.hashicorp.com/consul/day-2-operations/advanced-federation +/docs/guides/datacenters.html https://learn.hashicorp.com/consul/security-networking/datacenters +/docs/guides/geo-failover.html https://learn.hashicorp.com/consul/developer-discovery/geo-failover +/docs/guides/leader-election.html https://learn.hashicorp.com/consul/developer-configuration/elections +/docs/guides/monitoring-telegraf.html https://learn.hashicorp.com/consul/integrations/telegraf +/docs/guides/network-segments.html https://learn.hashicorp.com/consul/day-2-operations/network-segments +/docs/guides/semaphore.html https://learn.hashicorp.com/consul/developer-configuration/semaphore +/docs/guides/windows-guide.html https://learn.hashicorp.com/consul/datacenter-deploy/windows # NOTE: Do not use this redirects file for intro doc links. # A custom VCL (Varnish) configuration in the Fastly web admin has been