Consul 入门教程

Consul 入门教程

1. 项目目录结构及介绍

learn-consul-get-started-vms/
├── assets/
│   └── templates/
├── docs/
│   └── SeparateScripts.md
├── self-managed/
│   └── infrastructure/
│       └── aws/
│           └── conf/
├── .gitignore
├── LICENSE
├── README.md

目录结构介绍

• assets/: 包含项目所需的模板文件。
  • templates/: 存放各种配置文件的模板。
• docs/: 包含项目的文档文件。
  • SeparateScripts.md: 介绍用于生成 Consul 配置的独立脚本。
• self-managed/: 包含自托管环境的相关配置。
  • infrastructure/aws/: 包含 AWS 云环境的配置文件。
    • conf/: 存放不同场景的 Terraform 配置文件。
• .gitignore: Git 忽略文件列表。
• LICENSE: 项目许可证文件。
• README.md: 项目的主 README 文件，包含项目的基本介绍和使用说明。

2. 项目的启动文件介绍

启动文件

• README.md: 项目的主 README 文件，包含项目的启动说明和基本使用指南。

启动步骤

1. 克隆项目:

   git clone https://github.com/hashicorp-education/learn-consul-get-started-vms.git
   

2. 进入项目目录:

   cd learn-consul-get-started-vms
   

3. 初始化 Terraform:

   cd /self-managed/infrastructure/aws
   terraform init
   

4. 启动环境:

   terraform apply --auto-approve -var-file=/conf/00_hashicups.tfvars
   

3. 项目的配置文件介绍

配置文件目录

• self-managed/infrastructure/aws/conf/: 包含不同场景的 Terraform 配置文件。

配置文件介绍

• 00_hashicups.tfvars: 用于部署 HashiCups 应用的配置文件。
• 01_consul.tfvars: 用于配置 Consul 服务器的配置文件。
• 02_service_discovery.tfvars: 用于配置服务发现的配置文件。
• 03_service_mesh.tfvars: 用于配置服务网格的配置文件。
• 04_service_mesh_access.tfvars: 用于配置服务网格访问的配置文件。
• 05_service_mesh_monitoring.tfvars: 用于配置服务网格监控的配置文件。

配置文件示例

# 00_hashicups.tfvars
hashicups_instance_count = 4
consul_server_instance_count = 1
bastion_host_instance_count = 1

独立脚本配置

• docs/SeparateScripts.md: 介绍用于生成 Consul 配置的独立脚本。
  • generate_consul_server_config.sh: 生成 Consul 服务器配置的脚本。
  • generate_consul_server_tokens.sh: 生成 Consul 服务器令牌的脚本。
  • generate_consul_client_config.sh: 生成 Consul 客户端配置的脚本。
  • generate_consul_service_config.sh: 生成 Consul 服务配置的脚本。

独立脚本使用示例

export OUTPUT_FOLDER="/path/to/output"
export CONSUL_RETRY_JOIN="provider=aws tag_key=ConsulJoinTag tag_value=auto-join-j26f"
./generate_consul_server_config.sh

通过以上步骤，您可以成功启动并配置 Consul 环境。