Hyperf项目基于Docker Swarm的集群部署实战指南

Hyperf项目基于Docker Swarm的集群部署实战指南

hyperf 项目地址: https://gitcode.com/gh_mirrors/hyp/hyperf

前言

在现代应用开发中，容器化技术已成为不可或缺的一环。本文将详细介绍如何为Hyperf项目搭建Docker Swarm集群环境，涵盖从基础环境准备到完整集群部署的全流程。

基础环境准备

Docker安装与配置

首先在所有节点上安装Docker引擎：

curl -sSL https://get.docker.com/ | sh

修改Docker服务配置以启用TCP连接：

vim /lib/systemd/system/docker.service

在ExecStart配置项后追加：

-H tcp://0.0.0.0:2375

为普通用户添加Docker执行权限：

usermod -aG docker $USER

镜像加速配置

为提升镜像拉取速度，建议配置国内镜像源：

{
  "registry-mirrors": ["https://<your-mirror>.mirror.aliyuncs.com"]
}

GitLab环境搭建

SSH端口调整

为避免端口冲突，先修改SSH默认端口：

vim /etc/ssh/sshd_config
# 修改Port为2222
systemctl restart sshd.service

GitLab容器部署

使用Docker运行GitLab CE：

docker run -d --hostname gitlab.example.com \
--publish 443:443 --publish 80:80 --publish 22:22 \
--name gitlab --restart always \
--volume /srv/gitlab/config:/etc/gitlab \
--volume /srv/gitlab/logs:/var/log/gitlab \
--volume /srv/gitlab/data:/var/opt/gitlab \
gitlab/gitlab-ce:latest

初始密码可通过以下命令获取：

docker exec gitlab cat /etc/gitlab/initial_root_password

Docker Swarm集群搭建

集群初始化

在主节点执行：

docker swarm init

网络配置

创建自定义Overlay网络：

docker network create \
--driver overlay \
--subnet 10.0.0.0/8 \
--opt encrypted \
--attachable \
default-network

节点加入

在其他节点执行join命令加入集群：

docker swarm join --token <token> <manager-ip>:2377

Hyperf项目部署实践

项目配置

在GitLab中创建Hyperf项目，配置.gitlab-ci.yml：

variables:
  PROJECT_NAME: hyperf-demo
  REGISTRY_URL: registry.cn-shanghai.aliyuncs.com/your-namespace

部署文件示例

deploy.yml配置示例：

version: '3.7'
services:
  hyperf-app:
    image: ${REGISTRY_URL}/${PROJECT_NAME}:latest
    ports:
      - "9501:9501"
    deploy:
      replicas: 3
      restart_policy:
        condition: on-failure
    networks:
      - default-network

服务部署

docker stack deploy -c deploy.yml --with-registry-auth hyperf-demo

高级配置与优化

Kong API网关

推荐使用Kong作为API网关：

# 数据库
docker run -d --name kong-database \
  --network=default-network \
  -e "POSTGRES_USER=kong" \
  postgres:9.6

# Kong服务
docker run -d --name kong \
  --network=default-network \
  -e "KONG_DATABASE=postgres" \
  -p 8000:8000 \
  kong:latest

内核优化建议

对于高并发场景，建议优化内核参数：

sysctls:
  - net.ipv4.vs.conn_reuse_mode=0
  - net.ipv4.vs.expire_nodest_conn=1

常见问题排查

1. Git版本问题：

   • 症状：fatal: git fetch-pack: expected shallow list
   • 解决：升级Git版本

2. IP资源不足：

   • 症状：服务重启后容器间通信失败
   • 解决：扩展IP网段或重建网络

3. 仓库认证问题：

   • 症状：修改密码后服务更新失败
   • 解决：使用--with-registry-auth参数更新服务

结语

通过本文的指导，您应该已经掌握了Hyperf项目在Docker Swarm集群中的完整部署流程。从基础环境搭建到高级配置优化，这套方案能够满足从开发测试到生产环境的各类需求。实际部署时，请根据具体业务场景调整配置参数。

hyperf 项目地址: https://gitcode.com/gh_mirrors/hyp/hyperf