stack-docker脚本全解析：setup.sh自动化部署背后的秘密

stack-docker脚本全解析：setup.sh自动化部署背后的秘密

【免费下载链接】stack-dockerProject no longer maintained.项目地址: https://gitcode.com/gh_mirrors/st/stack-docker

stack-docker是一个基于Docker Compose的开源项目，提供了Elastic Stack（Elasticsearch、Kibana、Logstash和Beats）的完整自动化部署解决方案。通过项目中的setup.sh脚本，用户可以轻松完成从环境配置到服务启动的全流程部署，无需手动进行复杂的配置工作。

一键部署的核心：setup.sh脚本解析

setup.sh是stack-docker项目的自动化部署核心，位于项目的scripts目录下。这个脚本通过简洁的命令序列，实现了从环境准备到服务配置的全自动化流程。

脚本执行流程概览

1. 配置文件权限设置：脚本首先设置config目录的权限，确保容器能够正常读取配置文件：

   confdir="${PWD}/config" chown 1000 -R "$confdir" find "$confdir" -type f -name "*.keystore" -exec chmod go-wrx {} \; find "$confdir" -type f -name "*.yml" -exec chmod go-wrx {} \;

2. 生成安全密码：自动生成随机的Elasticsearch管理员密码：

   PW=$(openssl rand -base64 16;) ELASTIC_PASSWORD="${ELASTIC_PASSWORD:-$PW}" export ELASTIC_PASSWORD

3. 分阶段部署服务：通过Docker Compose依次启动Elasticsearch、Kibana、Logstash和各类Beats组件的初始化容器：

   docker-compose -f docker-compose.yml -f docker-compose.setup.yml up setup_elasticsearch docker-compose -f docker-compose.yml -f docker-compose.setup.yml up setup_kibana setup_logstash docker-compose -f docker-compose.yml -f docker-compose.setup.yml up setup_auditbeat setup_filebeat setup_heartbeat setup_metricbeat setup_packetbeat setup_apm_server

Docker Compose配置文件解析

stack-docker项目使用两个主要的Docker Compose配置文件来实现服务部署：

docker-compose.yml：核心服务定义

该文件定义了Elastic Stack的所有核心服务，包括：

• Elasticsearch（端口9200）
• Kibana（端口5601）
• Logstash
• 各类Beats（Auditbeat、Filebeat、Heartbeat、Metricbeat、Packetbeat）
• APM Server（端口8200）

每个服务都配置了对应的容器名称、镜像版本、网络设置、数据卷挂载和健康检查机制。例如Elasticsearch服务的定义：

elasticsearch: image: docker.elastic.co/elasticsearch/elasticsearch:${TAG} container_name: elasticsearch ports: ['9200:9200'] networks: ['stack'] volumes: - 'es_data:/usr/share/elasticsearch/data' healthcheck: test: curl --cacert /usr/share/elasticsearch/config/certs/ca/ca.crt -s https://localhost:9200 >/dev/null; if [[ $$? == 52 ]]; then echo 0; else echo 1; fi interval: 30s timeout: 10s retries: 5

docker-compose.setup.yml：初始化服务配置

该文件定义了专门用于初始化和配置各个组件的临时容器，如setup_elasticsearch、setup_kibana等。这些容器负责执行一次性的配置任务，如设置密码、创建索引模板、配置安全策略等。

以Kibana初始化容器为例：

setup_kibana: image: docker.elastic.co/kibana/kibana:${TAG} container_name: setup_kibana command: ['/bin/bash', '-c', 'cat /usr/local/bin/setup-kibana.sh | tr -d "\r" | bash'] environment: ['ELASTIC_PASSWORD=${ELASTIC_PASSWORD}'] volumes: - './config:/config' - './scripts/setup-kibana.sh:/usr/local/bin/setup-kibana.sh:ro' depends_on: ['elasticsearch'] networks: ['stack']

部署前的准备工作

在运行setup.sh脚本之前，建议进行以下准备工作：

1. 克隆项目仓库

首先需要将项目代码克隆到本地：

git clone https://gitcode.com/gh_mirrors/st/stack-docker cd stack-docker

2. 配置Docker资源

Elastic Stack对系统资源有一定要求，建议为Docker分配足够的内存和CPU资源。下图展示了Docker虚拟机的内存设置示例：

3. 检查环境变量

项目使用.env文件来管理环境变量，主要包括：

• TAG：Elastic Stack组件的版本标签
• ELASTIC_VERSION：Elastic Stack的版本号

可以根据需要修改这些变量来指定不同的版本。

执行部署与验证

运行setup.sh脚本

在项目根目录下执行以下命令启动自动化部署：

chmod +x scripts/setup.sh ./scripts/setup.sh

脚本执行完成后，会显示类似以下的成功信息：

Setup completed successfully. To start the stack please run: docker-compose up -d If you wish to remove the setup containers please run: docker-compose -f docker-compose.yml -f docker-compose.setup.yml down --remove-orphans You will have to re-start the stack after removing setup containers. Your 'elastic' user password is: xxxxxxxx

启动服务栈

执行以下命令启动所有服务：

docker-compose up -d

验证服务状态

可以通过以下命令检查各服务的运行状态：

docker-compose ps

也可以直接访问Kibana界面（默认地址：http://localhost:5601），使用脚本输出的elastic用户密码登录验证部署是否成功。

项目目录结构解析

stack-docker项目的主要目录结构如下：

• config/：包含所有服务的配置文件，如elasticsearch.yml、kibana.yml等
• scripts/：包含自动化部署脚本，如setup.sh、setup-elasticsearch.sh等
• screenshots/：包含项目相关的截图资源
• docker-compose.yml：核心服务定义
• docker-compose.setup.yml：初始化服务配置

总结

stack-docker项目通过setup.sh脚本和Docker Compose配置文件，实现了Elastic Stack的自动化部署。这种方式极大简化了复杂系统的部署流程，使开发人员和系统管理员能够快速搭建完整的日志收集、分析和可视化平台。无论是用于开发测试还是生产环境，stack-docker都提供了一种简单、可靠的部署方案。

通过本文的解析，相信您已经对stack-docker的自动化部署流程有了深入了解。如果您想进一步定制部署，可以修改相应的配置文件或脚本，以满足特定的业务需求。

【免费下载链接】stack-dockerProject no longer maintained.项目地址: https://gitcode.com/gh_mirrors/st/stack-docker